# web-accessibility-checker

A subagent that checks markup against WCAG, reviews HTML semantics and keyboard access, and returns a report listing violations.

- subagent · `type=agent` · Claude Code · 1438 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/web-tools/web-accessibility-checker.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/agents/web-accessibility-checker

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

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent web-tools/web-accessibility-checker
```

2. **Manually: put the files in place**
- File: `.claude/agents/web-accessibility-checker.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/web-accessibility-checker.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/web-accessibility-checker.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/web-tools/web-accessibility-checker.md

## When to use it
- 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
- audit `checkout.html` for WCAG 2.2 AA compliance
- find focus and keyboard navigation issues in the modal component
- produce a color contrast report for the stylesheets

## Similar
- [accessibility-tester](https://affpapa.org/en/nevibecode/agents/accessibility-tester.md) — subagent · 346 installs
- [accessibility](https://affpapa.org/en/nevibecode/skills/web-quality-skills-accessibility.md) — skill · 64100 installs
- [code-reviewer](https://affpapa.org/en/nevibecode/agents/anthropic-code-reviewer.md) — subagent · 31050 installs
- [code-reviewer](https://affpapa.org/en/nevibecode/agents/code-reviewer.md) — subagent · 31050 installs
- [test-engineer](https://affpapa.org/en/nevibecode/agents/test-engineer.md) — subagent · 9715 installs
- [code-reviewer](https://affpapa.org/en/nevibecode/agents/voltagent-community-code-reviewer.md) — subagent · 31050 installs
- [fullstack-developer](https://affpapa.org/en/nevibecode/agents/fullstack-developer.md) — subagent · 18117 installs
- [prompt-engineer](https://affpapa.org/en/nevibecode/agents/voltagent-community-prompt-engineer.md) — subagent · 16078 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 224 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md