# 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.

- Skill: `brokenrobot-xyz/checking-alt-text` (Agent Skill)
- Install (CLI): `npx skillmds@latest add brokenrobot-xyz/checking-alt-text`
- Raw SKILL.md: https://api.skillmd.com/api/skills/brokenrobot-xyz/checking-alt-text/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: brokenrobot-xyz (https://skillmd.com/u/brokenrobot-xyz)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/brokenrobot-xyz/checking-alt-text

---


# 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.