Claude Code a11y-audit for keyboard and semantic checks

Inspect focus, semantics, names, contrast, and motion preferences, then report observable accessibility issues.

Install in Claude Code

Give Claude Code the relevant HTML, CSS, and local page. Verify focus and accessible names in a browser and with assistive technology.

Review `.claude/skills/a11y-audit/SKILL.md` and its requirements at the pinned GitHub commit.
Create `.claude/skills/a11y-audit/` in your project and save the reviewed file as `.claude/skills/a11y-audit/SKILL.md`.
Start Claude Code from that project's root, then select `/a11y-audit` in the slash menu.

Example task

On audit-31, an unnamed icon button opens document filters. Tab can reach it, but CSS hides its focus indicator.

What to check

Report {accessibleName: 'missing', focusVisible: false}. Recommend keeping visible keyboard focus and giving the button a readable “Filter documents” name.

Original SKILL.md on GitHub · Updated 2026-11-14

Frequently asked question

Can a screenshot verify the full keyboard experience?

A screenshot provides visual evidence. Also navigate using the keyboard and inspect the accessible name with assistive technology or the browser accessibility tree.