Agents / Skills

Alt Text Writer

Skill

Writes alternative text that does the image's actual job: conveys what the image means in its context, marks the decorative as decorative, and handles the hard cases — charts, screenshots, diagrams — properly.

Best for

  • Content teams publishing images daily without an alt-text habit
  • Fixing a site where every alt is empty, 'image', or the filename
  • Charts and screenshots whose alt text currently says 'chart'

What you give it

  • The images with their surrounding context (the page or purpose they serve)

What you get back

  • Alt text per image, fitted to its role in that context — not a generic description
  • Decorative images identified and marked empty on purpose
  • Long-description treatment for the complex cases: charts summarised by their point, not their pixels

How it works

  1. Reads the image in its context first: the same photo needs different alt in a product page versus a news story.
  2. Writes to the image's function: information, action target, emotion, or decoration — each gets different treatment.
  3. Summarises data images by their message (what the chart proves), pointing to data tables for the detail.
  4. Flags content that must not live only in an image — alt text cannot carry a whole org chart.

Example

You: Write alt text for the 30 images in our quarterly report page.

Result: 22 informative images with context-fitted alt ('Revenue grew 23% to 4.1M, driven by the March launch' for the chart — the point, not 'bar chart with blue bars'), 6 marked decorative with empty alt on purpose, 2 screenshots given step-relevant descriptions naming the clicked control — and one flag: the org-chart image carries information existing nowhere in text, needs a text alternative on the page.

Limits — please read

  • Context it cannot see (why you chose this image) improves alt it writes — give the purpose when it asks.
  • Brand-voice alt (clever captions) trades clarity; it will keep function first and voice second.
  • Automated image recognition is not used as truth; descriptions come from looking and context.