Accessibility Audit Skill: Catch A11y Misses Before They Ship
Surfaces missing alt text, aria-labels, label bindings, and heading order issues. Most a11y failures aren't exotic — they're the same handful of misses on every project.
Full Prompt
An installable accessibility-audit skill. Walks the changed UI for common a11y misses and outputs file:line findings with the minimal fix for each.
What It Does
- Icon-button labels — flags unnamed close/×/delete buttons
- Form label binding — checks htmlFor/id pairs
- Heading order — no skipped levels, one h1 per page
- Focus and Escape — modals trap focus and close on Escape
Install in 30 Seconds
Pick your tool above and download:
- Claude Code:
~/.claude/skills/accessibility-audit/SKILL.md - OpenAI Codex CLI: append to
AGENTS.md - Cursor: append to
.cursorrules
Same content, three install paths. Reload and ask for the audit on your next change.
Why This Skill Earns Its Keep
Most a11y failures aren't exotic — they're the same handful of misses on every project. This skill encodes the short list and runs it against the diff. It also refuses to manufacture findings, which is what makes the output trustworthy.
Install once, run before every push.