accessibility-auditor

name: accessibility-auditor description: Audit websites for accessibility issues and WCAG compliance. Use when checking accessibility, fixing a11y issues, or ensuring WCAG compliance.

Audit a website for accessibility defects and bring it to WCAG 2.1 AA compliance.

references/automated-testing.md - CLI commands, jest-axe, Playwright, and tooling
references/wcag-checklist.md - WCAG Level A/AA criteria and keyboard testing checklist
references/common-fixes.md - Fix patterns for the 7 most common defects plus the sr-only class
references/aria-patterns.md - ARIA markup for tabs, accordion, menu, alert, progress

Run automated checks. Execute the CLI scans and add jest-axe or Playwright assertions per references/automated-testing.md.
Test the keyboard. Tab through the page and verify order, activation, escape, focus visibility, and absence of traps using the checklist in references/wcag-checklist.md.
Test with a screen reader. Walk the page with NVDA or VoiceOver and confirm names, roles, and announced state.
Check WCAG criteria. Audit each Level A and AA criterion in references/wcag-checklist.md.
Apply fixes. Resolve each finding with the patterns in references/common-fixes.md and references/aria-patterns.md, then re-run step 1 to confirm zero violations.