Stats
Actions
Tags
Help us improve
Share bugs, ideas, or general feedback.
Writes alt text for editorial images following WCAG accessibility guidelines, with a focus on screen reader users and editorial context.
npx claudepluginhub ur-grue/autopunk-media-skills --plugin autopunk-media-skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/autopunk-media-skills:alt-text-writerThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Writes descriptive alt text for editorial images following WCAG accessibility guidelines — concise enough for screen readers, specific enough to convey the image's editorial purpose.
Guides writing meaningful alt text for images, charts, diagrams, and visual content. Helps decide decorative/functional/informative/complex image types and craft context-appropriate descriptions.
Writes effective alt text for images and provides text alternatives for non-text content, including SVGs and complex images like charts.
Guides adding text alternatives for images, icons, SVGs, and canvas elements to meet WCAG 1.1.1. Classifies images as informative, decorative, or functional.
Share bugs, ideas, or general feedback.
Writes descriptive alt text for editorial images following WCAG accessibility guidelines — concise enough for screen readers, specific enough to convey the image's editorial purpose.
Required:
Optional:
Determines the image's editorial function. The same photograph requires different alt text depending on its role. A portrait of an interview subject needs identification and context. A lead image for a feature needs to convey the scene's mood and content. A chart needs its data summarized. The assistant reads the editorial context first, then writes alt text that serves the image's purpose in the article.
Writes for screen reader users, not search engines. Alt text is read aloud by assistive technology. The assistant writes in natural, spoken-language phrasing — not keyword-stuffed SEO text. The description is specific enough that a person who cannot see the image understands what it shows and why it matters to the article.
Keeps it concise but complete. WCAG guidelines recommend alt text between 10 and 125 characters for most images. The assistant aims for one to two sentences that cover the essential visual information without overloading. If the image is complex (infographic, data visualization, detailed scene), the assistant writes a short alt attribute and recommends a longer description in the article body or a longdesc element.
Follows accessibility conventions. Does not begin with "Image of" or "Photo of" — screen readers already announce the element as an image. Does not duplicate the caption. Does include text visible in the image if that text is editorially significant. Marks purely decorative images with empty alt attributes.
For each image: one alt text entry of 10–125 characters (one to two sentences). If the image is complex and requires a longer description, the alt text is followed by a bracketed note: "[Recommend long description in article body]." Format:
**Alt text:** [Concise description serving the image's editorial purpose.]
For decorative images:
**Alt text:** "" (decorative — no alt text needed)
Image 1: A wide shot of a flooded residential street. Water reaches halfway up the front doors of single-story houses. A person in waders carries a cardboard box through knee-deep water toward a pickup truck. The sky is overcast. This is the lead image for an article about the economic impact of repeated flooding on uninsured homeowners.
Image 2: A bar chart showing insurance claim denial rates by income bracket. The x-axis shows five income brackets from "Under $30K" to "Over $150K." The y-axis shows denial rates from 0% to 50%. The lowest income bracket has a denial rate of 42%; the highest has 8%. This is a supporting data visualization in the same article.
Image 3: The publication's decorative header graphic — an abstract wave pattern in blue tones used as a section divider.
Image 1: Alt text: A resident carries belongings through knee-deep floodwater on a residential street, with water reaching the front doors of single-story homes under an overcast sky.
Image 2: Alt text: Bar chart showing flood insurance claim denial rates by income: 42% for households earning under $30,000, declining to 8% for those earning over $150,000. [Recommend long description in article body with full data for all five income brackets.]
Image 3: Alt text: "" (decorative — no alt text needed)