Checking Alt Text

Checks every image in Markdown and HTML files for alt text — flags missing, empty, and filename-echo alt attributes with file and line. Use before publishing content or during an accessibility pass.

brokenrobot-xyz b9caaca 792 B Updated

File contents

Check alt text

Find images whose alt text is missing, empty, or a bare echo of the filename.

Steps

  1. Collect the image references from the named files with Grep — Markdown image syntax and HTML img tags.
  2. Flag a missing alt, an empty alt, and an alt that repeats the filename, each with file and line, because each of the three reads as silence to a screen reader.
  3. Report one table. An image the file marks as decorative passes with an empty alt; list those separately for the author to confirm the marking.

brokenrobot-xyz/agent-skills/tree/main/plugins/agent-authoring-toolkit/skills/reviewing-claude-skills/evals/files/eval-brief-before-interview/checking-alt-text commit b9caaca5ab

Frequently asked questions

npx skillmds@latest add brokenrobot-xyz/checking-alt-text