Heading hierarchy (<h1> → <h2>, not skipping levels)
List semantics (<ul>, <ol>, <li>)
Form semantics (<label>, <fieldset>, <legend>)
Color contrast audit
AA standard: 4.5:1 for text, 3:1 for UI components
Tool: axe, WAVE, or computed contrast ratios
Suggest alternative colors if failing
Keyboard navigation test
Tab order is logical and visible
No keyboard traps (escape key works)
Focus visible on all interactive elements
Suggest CSS for :focus-visible if missing
ARIA review
ARIA labels for icon-only buttons
ARIA roles where semantics insufficient
ARIA live regions for dynamic updates
Avoid redundant ARIA on semantic elements
Motion and animation
Respect prefers-reduced-motion media query
Warn if animations cannot be disabled
Suggest CSS override for animations
Produce WCAG audit report
Failures (must fix to meet AA)
Warnings (should fix)
Passed checks
Code examples for each fix
Example
User: "Check this modal dialog for accessibility."
Response:
Failure: Heading hierarchy broken (h1 missing main page heading)
Failure: Focus trap on close button (no Tab escape)
Warning: Close button missing aria-label (X icon not labeled)
Warning: Modal not marked with role="dialog" and aria-labelledby
Pass: Color contrast meets 4.5:1
Fix: Add aria-label="Close" to button, add role="dialog", manage focus trap on open/close
1---2name: a11y-reviewer3description: A11Y Reviewer4metadata:5 source: https://skillmd.com/skills/uitbreidenos/a11y-reviewer6---7# A11Y Reviewer89## When to activate1011User runs `/review-a11y` or requests an accessibility audit of a component for WCAG 2.1 AA compliance.1213## When NOT to use1415- Broader component audits (use `/component-auditor` instead)16- Performance profiling (use `/profile-performance` instead)17- Semantic code structure issues outside accessibility scope1819## Instructions20211. **Semantic HTML check**22 - Correct tag usage (`<button>` not `<div onclick>`)23 - Heading hierarchy (`<h1>` → `<h2>`, not skipping levels)24 - List semantics (`<ul>`, `<ol>`, `<li>`)25 - Form semantics (`<label>`, `<fieldset>`, `<legend>`)26272. **Color contrast audit**28 - AA standard: 4.5:1 for text, 3:1 for UI components29 - Tool: axe, WAVE, or computed contrast ratios30 - Suggest alternative colors if failing31323. **Keyboard navigation test**33 - Tab order is logical and visible34 - No keyboard traps (escape key works)35 - Focus visible on all interactive elements36 - Suggest CSS for `:focus-visible` if missing37384. **ARIA review**39 - ARIA labels for icon-only buttons40 - ARIA roles where semantics insufficient41 - ARIA live regions for dynamic updates42 - Avoid redundant ARIA on semantic elements43445. **Motion and animation**45 - Respect `prefers-reduced-motion` media query46 - Warn if animations cannot be disabled47 - Suggest CSS override for animations48496. **Produce WCAG audit report**50 - Failures (must fix to meet AA)51 - Warnings (should fix)52 - Passed checks53 - Code examples for each fix5455## Example5657User: "Check this modal dialog for accessibility."5859Response:60- **Failure:** Heading hierarchy broken (h1 missing main page heading)61- **Failure:** Focus trap on close button (no Tab escape)62- **Warning:** Close button missing `aria-label` (X icon not labeled)63- **Warning:** Modal not marked with `role="dialog"` and `aria-labelledby`64- **Pass:** Color contrast meets 4.5:165- **Fix:** Add `aria-label="Close"` to button, add `role="dialog"`, manage focus trap on open/close
Run npx get-skill add uitbreidenos/a11y-reviewer in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
A11Y Reviewer It is listed under Web & Frontend on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
UitbreidenOS (@uitbreidenos) published this skill. Their other Agent Skills are listed on their SkillMD profile.