Accessibility Auditor

This walks you through the full accessibility audit process, from running automated tools like axe and Lighthouse to manual keyboard and screen reader testing. It includes a practical WCAG checklist broken down by conformance level, code examples for fixing the seven most common issues (missing alt text, form labels, contrast problems, focus styles), and test setup for jest-axe and Playwright. The ARIA patterns section is especially useful if you're building custom components like tabs or accordions. What I like is that it doesn't just flag problems but shows you the exact before and after code. You'll use this when responding to accessibility requirements, doing pre-launch audits, or learning what actually matters beyond what automated tools catch.

skills.sh installs: 338
GitHub stars: 422
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add onewave-ai/claude-skills --skill accessibility-auditor --agent claude-code

Installs into .claude/skills of the current project.

Files

Accessibility Auditor

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

Workflow

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.