agentleFS
carlosbuelvas1carlosbuelvas1/openclaw-skills/image-reading/SKILL.md

image-reading

Skill0 starsChanged 6 months agoMITView on GitHub

Use when the user wants to read a screenshot, image, chart, poster, receipt, form, slide, or UI capture and understand both the exact visible text and what it means. This skill combines visual inspection with OCR when available, separates verbatim text from inference, and reports uncertainty clearly.

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

20 rules. About 0 are common, 20 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈20

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use this skill when the job is to understand what an image says, not just to describe that an image exists.

    line 8
  2. Distinctive:

    Do two jobs, in this order:

    line 20
  3. Distinctive:

    Read what is visibly there.

    line 22
  4. Distinctive:

    Never blur the line between those two.

    line 25
  5. Distinctive:

    If the user provided a local image path, load it with the image-viewing tool first.

    line 31
  6. Distinctive:

    Use direct visual inspection to capture:

    line 33
  7. Distinctive:

    If an OCR tool is available and the image is text-heavy, run OCR after visual inspection.

    line 43
  8. Distinctive:

    Use OCR especially for:

    line 45
  9. Distinctive:

    Do not trust OCR blindly. Cross-check obvious mistakes against the image.

    line 53
  10. Distinctive:

    If the image is structured, preserve that structure instead of flattening everything into one paragraph.

    line 62
  11. Distinctive:

    Always keep these apart:

    line 66
  12. Distinctive:

    If a word, number, or label is not fully legible, say so.

    line 71
  13. Distinctive:

    If the user asks:

    line 75
  14. Distinctive:

    Use the lightest shape that fits the task.

    line 83
  15. Distinctive:

    Keep numbers exact when they are legible.

    line 107
  16. Distinctive:

    If you infer something from layout, branding, or context, label it as inference.

    line 108
  17. Distinctive:

    Do not invent hidden text.

    line 109
  18. Distinctive:

    Do not over-interpret charts without naming the visible evidence first.

    line 110
  19. Distinctive:

    If context is missing, say the trend is visible but the cause is not proven.

    line 140
  20. Distinctive:

    If the image is simple and the user asks a direct question, answer directly instead of forcing the full structure.

    line 144

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Image Reading

Use this skill when the job is to understand what an image says, not just to describe that an image exists.

Good fits:

  • screenshots
  • app or website UI captures
  • posters, ads, menus, flyers, slides
  • receipts, invoices, labels, forms
  • charts, dashboards, scorecards, tables
  • social posts or meme screenshots where both text and layout matter

Core Rule

Do two jobs, in this order:

  1. Read what is visibly there.
  2. Explain what it means.

Never blur the line between those two.

Workflow

1. Inspect the image directly

If the user provided a local image path, load it with the image-viewing tool first.

Use direct visual inspection to capture:

  • layout
  • sections
  • hierarchy
  • colors or emphasis that change meaning
  • icons, charts, buttons, UI states, or branding
  • anything OCR alone will miss

2. Use OCR when exact text matters

If an OCR tool is available and the image is text-heavy, run OCR after visual inspection.

Use OCR especially for:

  • dense screenshots
  • receipts or forms
  • small text
  • tables
  • long paragraphs
  • timestamps, numbers, totals, labels, or IDs

Do not trust OCR blindly. Cross-check obvious mistakes against the image.

3. Reconstruct the content cleanly

Extract the visible content in a human-useful order:

  • top to bottom
  • left to right
  • grouped by section if the image has clear panels or blocks

If the image is structured, preserve that structure instead of flattening everything into one paragraph.

4. Separate fact from inference

Always keep these apart:

  • what the image explicitly says
  • what you infer from the image
  • what is uncertain or unreadable

If a word, number, or label is not fully legible, say so.

5. Answer at the right level

If the user asks:

  • "what does this say?" -> extract the content first
  • "what does this mean?" -> explain the meaning after extraction
  • "summarize this" -> summarize the content while preserving important numbers or claims
  • "is there anything important here?" -> surface the high-signal points, warnings, deadlines, totals, or risks

Response Contract

Use the lightest shape that fits the task. When the image is important or dense, prefer:

  1. Visible text
  2. What it shows
  3. What it likely means
  4. Unclear or uncertain

For charts, dashboards, or tables, prefer:

  1. What is on the screen
  2. Key numbers or labels
  3. Trend or takeaway
  4. Unclear or missing context

For receipts, bills, and forms, prefer:

  1. Document type
  2. Important fields
  3. Totals / dates / names / IDs
  4. Anything unusual or unclear

Rules for Accuracy

  • Quote short exact text when useful, but do not pretend uncertain OCR is certain.
  • Keep numbers exact when they are legible.
  • If you infer something from layout, branding, or context, label it as inference.
  • Do not invent hidden text.
  • Do not over-interpret charts without naming the visible evidence first.

Special Cases

UI screenshots

Capture:

  • page or app state
  • active panels or tabs
  • errors, warnings, banners, toggles, or missing states
  • the main action the user can or cannot take

Social screenshots

Capture:

  • the post text
  • account or source if visible
  • engagement counts or timestamps if relevant
  • whether replies, images, or quoted content change the meaning

Charts and dashboards

Capture:

  • title
  • axes
  • labels
  • legends
  • headline values
  • obvious trends

If context is missing, say the trend is visible but the cause is not proven.

When To Be Brief

If the image is simple and the user asks a direct question, answer directly instead of forcing the full structure.

When To Slow Down

Slow down when the image contains:

  • money
  • deadlines
  • legal or medical wording
  • fine print
  • multiple panels
  • hard-to-read small text
  • data that could be misread

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.