AIpocalypse.Now
Today'sdoom4.0
Back to Skills Directory
Accessibility

WCAG Auditor

Audit web apps for WCAG 2.2 AA compliance via axe-core, map violations to success criteria, propose code fixes, and generate VPAT reports.

View sourceMore in Accessibility

What it does

WCAG Auditor automates accessibility compliance testing by running axe-core against your web application and mapping violations directly to WCAG 2.2 Level AA success criteria. Claude reads your source code to propose concrete code fixes as edit diffs.

How it works

The skill runs Playwright to audit any URL—public or authenticated—then clusters findings by WCAG criterion. Claude generates a deterministic markdown report and optionally fills in an ITI VPAT 2.5 INT template to produce a formal Accessibility Conformance Report.

Use cases

  • Pre-launch audits: catch accessibility regressions before users encounter them
  • Compliance reporting: generate VPAT documents for procurement and legal teams
  • Remediation workflows: get AI-assisted code fixes mapped to specific violations
  • Multi-page sites: audit via sitemap or explicit URL lists with authenticated session support

Who benefits

Design leads and product managers responsible for accessibility compliance; developers seeking automated violation-to-fix mapping; teams needing formal VPAT documentation for government or enterprise contracts.

Glossary

Key Terms

WCAG 2.2
Web Content Accessibility Guidelines version 2.2, published by the W3C. The international standard for digital accessibility covering perceivability, operability, understandability, and robustness.
axe-core
An open-source accessibility testing engine maintained by Deque Systems. Runs automated checks in headless browsers to find common accessibility violations quickly and accurately.
Success Criterion
A testable rule within WCAG that defines how to meet an accessibility principle. Each has a conformance level (A, AA, or AAA). Example: 'Images must have alt text' maps to criterion 1.1.1 Non-text Content.
VPAT
Voluntary Product Accessibility Template, published by ITI. A standardized form documenting how a product meets WCAG, Section 508, and EN 301 549 accessibility requirements. Required for many government contracts.
FAQ

Frequently Asked Questions

How do I audit a website I don't own?

WCAG Auditor is designed for auditing your own applications where Claude can access and propose fixes to source code. For third-party sites, you can run the audit but won't get remediation diffs. The skill maps violations to WCAG criteria in a findings report, which is still useful for documentation purposes.

Does WCAG Auditor test authenticated pages?

Yes. For protected routes, Claude guides you through a one-time headed login to generate an `auth.json` session-state file via Playwright. Once created, the skill reuses that file to audit behind login walls.

What's the difference between WCAG 2.2 AA and AAA?

Level AA is the legal minimum for most government and enterprise accessibility requirements. Level AAA sets a higher bar with stricter contrast, larger text, and more extensive keyboard navigation. WCAG Auditor defaults to AA but supports AAA via the `--level AAA` flag.

Can I audit multiple pages at once?

Yes. Provide a sitemap URL, an explicit list of URLs in a text file, or let the skill perform a bounded seeded crawl. All findings are aggregated into a single report grouped by WCAG criterion.

What is a VPAT and do I need one?

A VPAT (Voluntary Product Accessibility Template) is a formal document certifying your product's accessibility compliance. Required for government contracts and many enterprise sales. WCAG Auditor fills your own ITI VPAT 2.5 INT template (download from itic.org) with audit findings.

How do I install WCAG Auditor?

Install via Claude Code plugin marketplace: `/plugin marketplace add benry-products/wcag-auditor` then `/plugin install wcag-auditor@wcag-auditor-tools`. Requires Node.js 22+. Runtime dependencies (Playwright, axe-core) install automatically on first use.

What accessibility standards does it test?

Primary: WCAG 2.2 Levels AA and AAA. Findings are also mapped to Section 508 (US) and EN 301 549 (EU) via published crosswalks, so a single audit covers multiple compliance frameworks.

Can I run WCAG Auditor from the command line?

Yes. The skill includes CLI scripts: `npm run audit` for single URLs, `npm run audit:site` for multi-page scans, `npm run report` to generate markdown, and `npm run vpat:fill` to populate VPAT templates.

More in Accessibility

All →

A&T Claude Skills

Reusable Claude Code skills for accessibility audits, WCAG compliance checking, and web development workflows

automateandtweak

a11y-skills

Claude Skills for accessibility auditing, code review, and WCAG 2.2 compliance across web, mobile, and documents.

joedevon

Taiwan Accessibility Audit

Automated WCAG 2.2 AA + Taiwan standard accessibility audits with static analysis and browser-based verification

6825972

WCAG Accessibility Skill

Claude Code skill for WCAG 2.1/2.2 audits, WAI-ARIA patterns, screen reader testing, and accessible component builds.