WCAG Conformance Audit

You perform WCAG 2.2 AA conformance audits. Report Pass/Fail/NT/NA per success criterion with evidence.

When to Use This Skill

Perspective	reviewing-a11y	auditing-wcag
Goal	Find issues and propose fixes	Systematic conformance verification
Output	Severity-based issues list	Pass/Fail/NT/NA per success criterion
Scope	Practical issues focus	Full WCAG 2.2 A/AA coverage

Routing Rules

auditing-wcag: Requests for "audit", "compliance", "conformance", or formal reporting.
reviewing-a11y: Requests for "review", "find issues", "improvements", or dev feedback.
If unclear, ask which goal they want: compliance report or issue review.

Workflow (6 Steps)

1. Input Acceptance

Accept a URL or local file path.
For multiple pages, confirm the list and entry points.
For local files, use Read to capture contents (runtime behavior cannot be executed).

2. Scope Contract

Confirm and get agreement on:

Target level (A/AA, default WCAG 2.2 AA)
Page scope (all pages / representative pages / provided URLs)
Limitations (AT checks out of scope, dynamic behavior depends on Playwright)
Output format (Pass/Fail/NT/NA per success criterion)

3. Automated Checks

Use Playwright to navigate and capture the accessibility tree.
Apply references/automated-checks.md.
If Playwright is unavailable, use WebFetch for HTML-only checks and limit findings accordingly.
Use references/coverage-matrix.md to ensure A/AA coverage.

4. Interactive Checks

Validate keyboard access and focus behavior with Playwright.
Follow references/interactive-checks.md.
If execution is blocked, mark affected criteria as NT.

5. Manual Check Items

Present items from references/manual-checks.md and references/content-checks.md.
If evidence is not available, keep them as NT and list them explicitly.
Incorporate any evidence the user provides.

6. Report Generation

Follow references/output-format.md.
Assign a status to every A/AA success criterion (Pass/Fail/NT/NA).
Summarize scope, limitations, tools, and unresolved items.

Automation Scope and Limits

Playwright only provides computed accessibility tree signals (role/name/state).
Automated test results alone do not guarantee audit outcomes.
Screen reader verification and AT×browser compatibility testing are out of scope.
Do not guess; use NT when evidence is missing.

Reference Guides

references/automated-checks.md
references/interactive-checks.md
references/manual-checks.md
references/content-checks.md
references/output-format.md
references/coverage-matrix.md

Automated Test Scripts

The references/scripts/ directory contains Playwright-based test scripts for detailed automated checks. These scripts generate JSON results and annotated screenshots.

Script	Criterion	Description
`axe-audit.ts`	Multiple	axe-core comprehensive check
`reflow-check.ts`	1.4.10	Horizontal scroll at 320px
`text-spacing-check.ts`	1.4.12	Text spacing override clipping
`zoom-200-check.ts`	1.4.4	200% zoom content loss
`orientation-check.ts`	1.3.4	Orientation lock detection
`autocomplete-audit.ts`	1.3.5	Missing/invalid autocomplete
`time-limit-detector.ts`	2.2.1	Timer/meta refresh detection
`auto-play-detection.ts`	1.4.2, 2.2.2	Auto-play content detection
`focus-indicator-check.ts`	2.4.7	Focus indicator visibility
`target-size-check.ts`	2.5.5, 2.5.8	Target size measurement

Usage:

cd references/scripts
npm install
TEST_PAGE="https://example.com" npx playwright test <script-name>.ts

See references/scripts/README.md for detailed documentation.

auditing-wcag