image-alt-text/SKILL.md
Facts to use
- Google uses alt text, together with page content and the file name, to understand an image.
- Good alt text describes the image in the context of the page. Avoid keyword stuffing.
- A decorative image (a divider, a background pattern) gets an empty attribute:
alt="". Do not leave the attribute out. - Use
<img>elements withsrcfor images you want indexed. Google does not index CSS background images.
Workflow
- List every
<img>with its page,src, current alt and nearby text. - Classify each image: content (shows information), functional (a link or button), or decorative.
- Write alt text:
- Content image: what it shows that matters on this page, in one short phrase. Example: "Pricing table with Free, Starter and Pro plans".
- Functional image: the action or target. Example: "Download the report".
- Logo: the company name.
- Decorative:
alt="".
- Do not start with "image of". Do not repeat the caption word for word.
- Rename files with unclear names (
IMG_0042.png) when the owner can change URLs safely.
Checks
- Every
<img>has an alt attribute. - No alt text is a list of keywords.
Output
A table: page, image src, type, old alt, new alt.
Sources
- Google: Google image SEO best practices. https://developers.google.com/search/docs/appearance/google-images
- W3C WAI: An alt decision tree. https://www.w3.org/WAI/tutorials/images/decision-tree/