visual-analysis-ocr — Claude Code subagent: OCR and setup
Reads text from PNG images, maps document structure, and turns the result into markdown. Useful for scans and visual documents.
npx claude-code-templates@latest --agent ocr-extraction-team/visual-analysis-ocrWhat visual-analysis-ocr does
This subagent reads PNG images and extracts their text in reading order. It can identify headings, lists, captions, footnotes, symbols, mathematical notation, columns, indentation, emphasis, quotes, code blocks, tables, and diagram labels.
The output uses markdown headings, list markers, emphasis, code formatting, and preserved paragraph breaks. Ambiguous passages, difficult layouts, and non-text elements are flagged or described. Its configured tools are Read and Write, so the workflow centers on reading the image and writing the analysis.
Install it in Claude Code with npx claude-code-templates@latest --agent ocr-extraction-team/visual-analysis-ocr, then use .claude/agents/visual-analysis-ocr.md.
What it helps with
- extract text from a PNG
- rebuild heading and list structure
- convert image content into markdown
- read text across multiple columns
- flag unclear passages and diagram elements
Example prompts for the agent
- Extract the text from this PNG and keep its reading order in markdown.
- Turn the headings, lists, and emphasis in this image into a markdown structure.
- Inspect the image, flag unclear sections, and describe its tables and diagram labels.
How to install visual-analysis-ocr
1claude-code-templates
npx claude-code-templates@latest --agent ocr-extraction-team/visual-analysis-ocr2Manually: put the files in place
.claude/agents/visual-analysis-ocr.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/visual-analysis-ocr.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/visual-analysis-ocr.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about visual-analysis-ocr
How do I install visual-analysis-ocr in Claude Code?
Run npx claude-code-templates@latest --agent ocr-extraction-team/visual-analysis-ocr, then use .claude/agents/visual-analysis-ocr.md.
What does visual-analysis-ocr do?
It extracts text from PNG images, interprets their visual hierarchy, and converts the result into structured markdown.
Which tools does visual-analysis-ocr use?
Its configuration lists Read and Write. The subagent reads the image and writes the analysis.