wcag-audit-patterns Skill for Claude Code: Run WCAG 2.2 Accessibility Audits

Skill that gives your assistant a WCAG 2.2 audit checklist, test methods and fix patterns for accessibility problems on websites.

Installs: 12.8K; on skills.sh
Stars: 42.1K; on GitHub
Files: 1; besides SKILL.md
Updated: Oct 2026; last repo commit

Use it when you audit a site for accessibility, fix WCAG violations or build accessible components. SKILL.md explains conformance levels A, AA and AAA, the four POUR principles and which violations matter most. A reference file holds the full checklist, HTML and CSS fixes and automated test examples.

SKILL.md says automated tools find only 30 to 50 percent of issues, so manual checks are still required.

Good for

Front-end developers fixing accessibility violations
QA and accessibility auditors preparing a WCAG report
Teams working toward ADA, Section 508 or VPAT requirements

Install wcag-audit-patterns

Claude Code

Copy this prompt.

Install the wcag-audit-patterns skill in Claude Code. Run this command:

/plugin marketplace add wshobson/agents
/plugin install accessibility-compliance@claude-code-workflows

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route. The plugin routes install the whole accessibility-compliance plugin: 1 agent, 1 command and 2 skills (counted from the plugin folder in the repo tree, which has no hooks or MCP config files). The skills-only routes install just this skill, with no agents or commands. The reference file shows npx commands that download accessibility scanners, so the assistant needs permission to run commands.

From the project README. Source.

What's in the skill

When it loads

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

Sections in SKILL.md

When to Use This Skill
Core Concepts
1. WCAG Conformance Levels
2. POUR Principles
3. Common Violations by Impact
Detailed patterns and worked examples
Best Practices
Do's
Don'ts

Key facts

Author: Seth Hobson, author of the accessibility-compliance plugin that holds this skill (plugin.json)
License: MIT (plugin.json)
Installs on skills.sh: 12,752 as of 2026-11-02
GitHub stars: 42,081 for the whole wshobson/agents repo, 2026-11-02
Last repo commit: 2026-10-30
Files: 2 files including SKILL.md (references/details.md); no scripts

What it includes

Explains levels A, AA and AAA and what each is required for.
Read · Conformance levels
Perceivable, Operable, Understandable, Robust, as a lens for the audit.
Read · POUR principles
Groups common problems as critical, serious or moderate.
Read · Violations by impact
Walks WCAG success criteria with HTML, CSS and JavaScript fixes.
Lives in references/details.md, which SKILL.md tells the agent to read when needed.
Read · Audit checklist
Shows an axe-core and Playwright test plus CLI scanners.
The CLI examples are npx @axe-core/cli, npx pa11y and lighthouse.
Runs code · Automated testing
Gives fix patterns for common violations.
Read · Remediation patterns
Do and do-not lists, such as native HTML before ARIA.
Read · Best practices

From the official docs

Permissions

Low risk

The skill is guidance text, but its reference file shows commands that download npm packages and scan a URL. Approve each command before it runs.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can run accessibility tools against a URL
The reference file lists npx @axe-core/cli, npx pa11y and lighthouse, which download and run npm packages and open the page you name. Approve each command and point it at your own site. github.com
The plugin route adds an agent and a command
The accessibility-compliance plugin adds the ui-visual-validator agent, whose description says to use it proactively after UI changes, and the accessibility-audit command. The repo tree shows no hooks or MCP config files for it. The skills-only install adds neither. github.com
It bundles no scripts
The skill folder has 2 files including SKILL.md. Both are guidance text with code samples. github.com

Technical details

Scopes	The reference file lists commands that fetch and run npm packages against a URL (npx @axe-core/cli, npx pa11y, lighthouse) It also shows a Playwright test that loads axe-core

Questions

What does the wcag-audit-patterns skill do?

It gives your assistant a WCAG 2.2 audit guide. It covers conformance levels, the POUR principles, a checklist with fixes and automated test examples.

How do I install it?

Use the install box at the top of this page. The repo README says the skills installer adds a single skill without the plugin's agents, commands or hooks.

Does it work in the Claude app or claude.ai?

The skill folder is Markdown with no scripts, and the install box lists the ways to add it. To run the scanners it mentions, the assistant needs permission to run commands.

Is it safe?

The skill is guidance text and bundles no scripts. Its reference file shows commands that download npm packages and scan a URL, so approve each one and scan only your own site.

Can it replace a manual accessibility audit?

No. SKILL.md says automated testing finds 30 to 50 percent of issues and lists manual testing and real users as requirements.

What else comes with the plugin version?

The repo README also offers a plugin route. The accessibility-compliance plugin holds this skill, a screen-reader-testing skill, one agent (ui-visual-validator) and one command (accessibility-audit).

Information

updated Nov 2, 2026

Repository: wshobson/agents
Folder: plugins/accessibility-compliance/skills/wcag-audit-patterns

wshobson/agents skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

SKILL.md · github.com
README.md · github.com
python-development plugin.json · github.com
details.md · github.com
ui-visual-validator agent · github.com
accessibility-audit command · github.com