Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Use when writing the alt attribute for images in marketing pages, blog posts, emails, or social — hero shots, product photos, infographics, icons, decorative flourishes. Writes a short text alternative that names what the image shows or does under 125 characters, drops the "image of" / "photo of" lead-in, and uses an empty alt for purely decorative graphics instead of keyword-stuffing or leaving it blank. Do NOT use for on-page body copy, headlines, or figure captions the reader can see.
.claude/skills/marketing-alt-text/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-04 | ✗→✓ | ▲ Improved | 145% | 0% |
| case-08 | ✗→✓ | ▲ Improved | 142% | 0% |
| case-13 | ✗→✓ | ▲ Improved | 366% | 0% |
| case-01 | ✓→✓ | = Same ✓ | 145% | 0% |
| case-02 | ✓→✓ | = Same ✓ | 140% | 0% |
The text alternative on an image — the alt attribute a screen reader speaks and a search crawler reads when the picture can't load. In a marketing context two default pulls fight the reader. "SEO" framing pulls toward cramming keywords; the wish to be descriptive pulls toward narrating every graphic, including the ones that carry no meaning. Both hurt. Write for the person who can't see the image.
Give each image a text alternative that conveys what it shows or what it does, then apply four constraints.
this spot. A product photo on a pricing card conveys the product; a logo that links home conveys the destination ("Acme home"); a chart conveys its takeaway, not its colors. If the image is a link or button, the alternative names where it goes or what it does.
detail, put that in visible copy or a caption and keep the alternative short.
"Icon of". A screen reader already announces the element as an image; the prefix wastes the listener's time. Start with the subject.
texture, or icon that merely repeats adjacent visible text carries no information — give it alt="" (empty string) so assistive tech skips it. Never drop the attribute entirely, and never invent a description for it.
is spam, hurts the listener, and search engines discount it. Describe the one image.
it, the image is decorative in context — use alt="".
alt="IMG_4821.jpg" or alt="hero-final-v2" is worse than nothing.alternative.
Ask: if the image vanished, would the reader miss information the surrounding text doesn't already give? If yes, describe it (constraints 1–3). If no — it is mood, spacing, or a duplicate of visible text — use alt="".
When asked for the text alternative for one image, return the alt value itself (a phrase, or the literal empty string for decorative). When handling several images, return one line per image. Do not narrate the rules back; give the values.
Other measured skills in the registry, with their headline benchmark lift.