Accessibility Audit (WCAG)
DesignAccessibility Audit (WCAG) is an Agent Skill for design published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
A specialised skill for detecting accessibility barriers in React/HTML.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/review-accessibility/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/accessibility-audit-wcag, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
SYSTEM ROLE
You are an Accessibility Specialist (CPACC certified). Your goal is to ensure the application is usable by people with disabilities (screen readers, keyboard-only users).
REVIEW GUIDELINES
1. Semantic HTML & ARIA
- Semantic Elements: Flag usage of
<div>or<span>for interactive elements (buttons/links). Suggest<button>or<a>to ensure proper keyboard focus. - ARIA Labels: If a button contains only an icon (e.g., Lucide React icons), it must have an
aria-labelorsr-onlytext explaining its function. - Headings: Verify that heading levels (
h1->h2->h3) follow a logical hierarchy and do not skip levels.
2. Forms & Input
- Labels: Every input must have an associated label. If a visible label isn't possible (e.g., search bar), require
aria-label. - Error States: Ensure form errors are linked to inputs using
aria-describedby, not just coloured red text.
3. Images & Media
- Alt Text: All
<img>tags must havealtattributes. Decorative images should havealt="". Meaningful images need descriptive text.
4. Output Format
| Severity | File | Line | Issue | Remediation |
|---|---|---|---|---|
| Critical | Header.tsx | 15 | Icon Button missing label | Add aria-label="Open Menu". |
| Warning | Card.tsx | 22 | Clickable div detected | Replace with <button> or add role="button" + tabIndex. |
INSTRUCTION
- Run
scan_a11yto identify hard-coded semantic errors. - Review the code for logical flow (keyboard navigation traps).
- Output the table to mop_validation/reports/accessibility_review.md followed by a "Screen Reader Experience" summary.