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
- Developers who want an audit that ends in code fixes and automated tests, not only a report.
- Sites targeting WCAG 2.1 AA, the level the skill names.
- Pairing with the WCAG accessibility audit skill or the accessibility compliance audit skill for a second pass.
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.
How to install Accessibility Auditor Skill: WCAG 2.1 AA Site Audits
claude skill install OneWave-AI/claude-skills/accessibility-auditorThe README says the skills follow the Agent Skills open standard and list Claude Code, OpenAI Codex CLI, Gemini CLI and Cursor among compatible tools.Install the single skill
The README shows
claude skill install OneWave-AI/claude-skills/<skill-name>for Claude Code. Use accessibility-auditor as the name.Or clone the library
Run
git clone https://github.com/OneWave-AI/claude-skills.gitinto your skills folder. The README gives paths for Claude Code and Codex CLI.Keep the references folder
The four reference files live beside SKILL.md, so copy the whole skill folder if you copy by hand.
Ask for an audit
Name a page or site and ask for an accessibility audit. The skill triggers on accessibility, a11y and WCAG requests.
Check that it loaded
Ask for an audit of one page. The agent should run automated checks, work through the keyboard checklist, then propose fixes and rerun the scan to confirm.
Key features
- Five step workflowAutomated checks, keyboard test, screen reader test, WCAG criteria review and fixes, with a rerun to confirm.
- CLI scansReference commands for Lighthouse accessibility only runs, axe-core CLI and Pa11y.
- Test codejest-axe examples for React components and Playwright with AxeBuilder, asserting no violations.
- Level A and AA checklistPerceivable, operable, understandable and technical compatibility criteria, from alt text to name, role and value.
- Keyboard testing listChecks tab order, Enter and Space activation, arrow keys in menus, escape to close and no keyboard traps.
- Screen reader walkthroughUses NVDA or VoiceOver to confirm names, roles and announced state.
- Seven common fixesPatterns for frequent defects such as alt text, labels, contrast and focus, with good and bad code.
- Focus style ruleReplaces blanket outline removal with a visible focus-visible style.
- ARIA patternsMarkup for tabs, accordion, menu, alert and progress components.
- Zero violation targetThe loop ends when the automated checks rerun with no violations.
Frequently asked questions
What is the accessibility auditor skill?
It is a skill in the OneWave AI skills repository that has an AI coding agent audit a website for accessibility defects, work through WCAG 2.1 AA criteria, apply fixes from reference patterns and confirm zero violations with automated scans.
How do I install the accessibility auditor skill?
Use the README command for Claude Code, claude skill install with the OneWave-AI path and skill name, or clone the library into your agent's skills folder. Copy the whole folder so the reference files come along.
Which tools does it use for scanning?
The automated testing reference lists Lighthouse, the axe-core CLI and Pa11y for command line scans, plus jest-axe with React Testing Library and Playwright with AxeBuilder for tests that can run in your project.
Does it test with a real screen reader?
The workflow tells the agent to walk the page with NVDA or VoiceOver, but an agent cannot hear one. Plan on doing this step yourself or with an assistive tool the agent can operate, and share what you find.
Which WCAG version does it target?
WCAG 2.1 Level AA is named in the skill. The checklist file lists Level A and AA criteria, including 4.5 to 1 text contrast, 200 percent text resizing, reflow at 320px width and visible focus.
Can I use it with Cursor or Codex?
The README says the skills follow the Agent Skills open standard and work unchanged in Claude Code, OpenAI Codex CLI, Gemini CLI, Cursor and other tools, as long as you point the tool at the skills folder.
How is it different from other audit skills?
It is compact and fix oriented: a five step loop plus patterns and test code. The WCAG accessibility audit skill is another route, so compare their checklists before choosing one.
What license does it use?
GitHub shows the onewave-ai repository under the MIT license. Read the license file in the repository for the exact terms before you reuse or redistribute the skill, and keep its copyright notice with any copy you share with your team.


