What is the WCAG audit patterns skill?
WCAG audit patterns is a skill in wshobson/agents for auditing websites against WCAG 2.2. It explains conformance levels A, AA and AAA, the four POUR principles, common violations ranked as critical, serious or moderate, and do and do not advice, with detailed patterns in a reference file.
WCAG audit patterns is a skill in the accessibility-compliance plugin of wshobson/agents. Its description covers WCAG 2.2 audits with automated testing, manual verification and remediation guidance.
The SKILL.md is deliberately short. It gives a navigation tier with the core concepts, and points to a references file for detailed patterns and worked examples when the overview is not enough.
What changes in your agent's output
- Findings are framed by conformance level, with A as the legal baseline and AA as the standard for most regulations.
- Issues are grouped under the four POUR principles, from perceivable to assistive technology support.
- Violations are ranked as critical blockers, serious or moderate, so fixes follow impact.
- Reports state that automated tools catch only part of the problems, so manual checks are planned.
- Remediation prefers native HTML first and ARIA second.
Who it is for
Best for
- Teams preparing for ADA, Section 508 or VPAT conversations that need a structured audit approach.
- Developers fixing a list of WCAG violations who want impact-based ordering.
- Design system owners building accessible component patterns early.
Not for
- Legal advice. The skill mentions lawsuits and regulations as motivation, not as a compliance guarantee.
- Hands-on assistive technology testing, which a screen reader skill covers.
- A single-component code fix. It is an audit framework, not a snippet library.
Use it with UiChemy
Run an audit like this on the published page after UiChemy has generated it. UiChemy AI to WordPress imports an AI build as an editable page, and the accessibility findings then go back into that page. Click Get Started on uichemy.com.
How to install WCAG Audit Patterns Skill: WCAG 2.2 Audits for AI Agents
gh skill install wshobson/agents wcag-audit-patternsThe repository describes itself as one Markdown source adapted to each tool by generators, so folder paths differ per tool.Install only this skill
Run
gh skill install wshobson/agents wcag-audit-patternsand pick your coding tool when prompted. The README says it reads skills from GitHub without cloning and installs them without the plugin's agents, commands or hooks.Check the requirement
The README says gh skill requires GitHub CLI 2.90 or later. Update the CLI first if the command is not found.
Or install the plugin
In Claude Code, run
/plugin marketplace add wshobson/agentsand then install the plugin that holds this skill, accessibility-compliance, from the claude-code-workflows marketplace.Other tools
The README lists Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot and Pi, each with its own route. Use the table in the README for yours.
Use the skill
Ask your agent to audit a page against WCAG 2.2 using the WCAG audit patterns skill and to rank findings by impact.
Check that it loaded
Ask the agent to list its skills and look for wcag-audit-patterns, or request an audit and check that findings are grouped by impact tier.
Key features
- Conformance levelsA table explains level A as minimum and a legal baseline, AA as standard conformance for most regulations, and AAA as enhanced accessibility for specialized needs.
- POUR principlesThe four POUR principles are stated as questions: can users perceive, operate and understand the content, and does it work with assistive technology.
- Impact tiersCritical blockers include missing alt text on functional images, no keyboard access, missing form labels and auto-playing media without controls.
- Serious and moderate issuesSerious covers contrast, skip links, inaccessible custom widgets and page titles. Moderate covers language attribute, link text, landmarks and heading order.
- Reference fileDetailed patterns and worked examples live in references/details.md, which the agent reads when the navigation tier is not enough.
- Use-case triggersThe skill applies to audits, fixing violations, accessible components, ADA and Section 508 requirements, lawsuit preparation and VPAT work.
- Automation limitsIt says 30 to 50 percent of issues are detectable by tools, so automated testing alone is not treated as sufficient.
- Native HTML firstSemantic HTML reduces the need for ARIA, and ARIA is not the first solution. Focus outlines stay visible and zoom stays enabled.
- Real-user testingDisabled users are named as the best source of feedback, and color alone must never carry meaning.
Frequently asked questions
What is WCAG audit patterns?
It is a skill in the accessibility-compliance plugin of wshobson/agents. It guides WCAG 2.2 audits with conformance levels, the POUR principles, common violations ranked by impact and do and do not advice, with detailed patterns in a separate references file.
How do I install WCAG audit patterns?
Run gh skill install wshobson/agents wcag-audit-patterns and choose your coding tool. The README says gh skill needs GitHub CLI 2.90 or later and does not install the plugin's agents. Installing the accessibility-compliance plugin is the alternative route.
Does it cover WCAG 2.2 or 2.1?
Its description says WCAG 2.2 audits. The skill body explains levels A, AA and AAA and the POUR principles, which carry across versions, but check the references file before assuming it lists every 2.2 success criterion. Confirm specific criteria against the W3C text.
Can an automated audit replace manual testing?
No. The skill says only part of the issues are detectable by tools, quoting 30 to 50 percent, and advises not to rely only on automated testing. Manual keyboard checks and testing with disabled users are part of its recommended approach.
Does it work with Claude Code, Cursor and Codex?
The repository README says its collection works across Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot and Pi, adapted by generators. Each tool has its own install route, so follow the README for yours.
What are WCAG audit patterns alternatives?
WCAG Accessibility Audit and Accessibility Compliance Audit are similar audit routines from other authors. Accessibility Review focuses on WCAG 2.1 AA. They differ in structure and in how much detail sits inside SKILL.md.
Does it help with ADA or VPAT work?
It lists ADA, Section 508 and VPAT among its use cases, so it can structure the technical audit. It does not replace legal advice or a formal conformance report. Pair it with Accessibility Testing for a quick WCAG 2.2 reference during fixes.


