Agent skill

Accessibility Auditor Skill: WCAG 2.1 AA Site Audits

The accessibility auditor skill gives an AI coding agent a five step routine to scan, keyboard test, screen reader check and fix a website toward WCAG 2.1 AA.

Install
claude skill install OneWave-AI/claude-skills/accessibility-auditor
View on GitHub

Stars, license and last push from GitHub. Install count as reported by the open skills directory.

What is the accessibility auditor skill?

The accessibility auditor skill is in the onewave-ai repository of agent skills. It gives an AI coding agent a five step workflow: run automated checks, test the keyboard, test with a screen reader, check each WCAG A and AA criterion, then apply fixes from reference patterns and re-run the scans until there are no violations.

It is the accessibility-auditor skill in the OneWave AI skills library. Its description says it audits websites for accessibility issues and WCAG compliance, and the body aims to bring a site to WCAG 2.1 AA.

SKILL.md is short. It defines a five step workflow and points to four reference files: automated testing, a WCAG checklist, common fixes, and ARIA patterns.

What changes in your agent's output

  • The agent starts with automated scans, then adds jest-axe or Playwright axe assertions for repeatable tests.
  • It then tabs through the page, checking order, activation, escape, visible focus and keyboard traps against a checklist.
  • A screen reader pass with NVDA or VoiceOver confirms names, roles and announced states.
  • Findings are fixed with prepared patterns, and the scans run again to confirm zero violations.

What the reference files cover

  • Automated testing lists Lighthouse, axe-core CLI and Pa11y commands, jest-axe with React Testing Library, and Playwright with AxeBuilder.
  • The WCAG checklist lists Level A and Level AA criteria, such as 1.4.3 contrast at 4.5 to 1 and 2.4.7 visible focus.
  • Common fixes cover seven frequent defects, including missing alt text, form labels, low contrast and missing focus styles, plus a sr-only class.
  • ARIA patterns give markup for tabs, accordion, menu, alert and progress components.

Who the accessibility auditor skill is for

Best for

Not for

  • Formal compliance certification. Automated checks and a checklist do not replace a specialist audit.
  • Teams that need WCAG 2.2 criteria, since the skill names 2.1 AA.

Use it with UiChemy

After building pages in WordPress with UiChemy, run the audit on the live site and fix labels, contrast and focus in the editor. Click Get Started on uichemy.com. For component level checks, see the accessibility per component skill.