web-accessibility-checker — Claude Code subagent: WCAG audits
A subagent that checks markup against WCAG, reviews HTML semantics and keyboard access, and returns a report listing violations.
npx claude-code-templates@latest --agent web-tools/web-accessibility-checkerWhat web-accessibility-checker does
This subagent acts as an accessibility specialist. It assesses WCAG 2.1/2.2 conformance at levels A, AA and AAA, validates semantic HTML, tests keyboard navigation and focus management, measures color contrast, reviews alternative text for media, and checks form error handling.
The workflow it follows: automated scanning first, then manual testing with assistive technologies, semantic structure validation, a keyboard navigation pass, contrast ratio measurements, and screen reader checks. Output includes an audit report, a WCAG checklist with violation details, recommendations for semantic HTML and contrast fixes, a keyboard navigation guide, and testing results.
Its toolset is limited to Read, Write, Grep and Glob. No browser, no live DOM — everything is read from project files. So a real browser run stays on you; the subagent works with what is in the code.
What it helps with
- check a page against WCAG level AA
- find Tab order and focus problems
- measure text and background contrast
- build a project-wide accessibility violation checklist
- review alt text on images and media
Example prompts for the agent
- audit
checkout.htmlfor WCAG 2.2 AA compliance - find focus and keyboard navigation issues in the modal component
- produce a color contrast report for the stylesheets
How to install web-accessibility-checker
1claude-code-templates
npx claude-code-templates@latest --agent web-tools/web-accessibility-checker2Manually: put the files in place
.claude/agents/web-accessibility-checker.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/web-accessibility-checker.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/web-accessibility-checker.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about web-accessibility-checker
How do I install web-accessibility-checker in Claude?
Through the templates package: npx claude-code-templates@latest --agent web-tools/web-accessibility-checker. The subagent file then lands at .claude/agents/web-accessibility-checker.md.
What does web-accessibility-checker do?
It checks markup against WCAG 2.1/2.2, reviews semantic HTML, keyboard navigation, contrast and form accessibility. You get a report with violations and remediation steps.
Which tools can the subagent use?
Only Read, Write, Grep and Glob. It works from project files, without launching a browser or assistive technology.