accessibility-audit | uix

Stats

Actions

Tags

accessibility-audit | uix

accessibility-audit

Audit UIs against WCAG 2.2. Auto-activates on a11y queries or via /uix:accessibility-audit. Bash is permitted only for contrast-ratio computation — no network, no filesystem writes.

Triggers

"accessibility audit" · "WCAG check / audit / compliance" · "a11y review" · "is this accessible" · "check contrast" · "keyboard accessible" · "screen reader" · "target size" · "focus ring" · "ARIA" · "color contrast ratio" · "dragging alternative" · "accessible authentication".

Process

Ingest the target (file, URL, screenshot, or description). If only a description is given, ask for code or a rendered example — an a11y audit without concrete markup is guesswork.
Load WCAG criteria from ${CLAUDE_PLUGIN_ROOT}/references/UI_MASTER_GUIDE.md Part XII. Walk the four principles in order.
For each criterion evaluate: Pass / Fail / N/A / Needs manual check. Don't skip — explicit N/A is better than silent omission.

Output format:

## Accessibility Audit — <target>

### Summary
Conformance estimate: [A / AA / AA-with-gaps / fails-AA]
Critical blockers: N
Warnings: N

### Perceivable
- 1.1.1 Non-text Content (A) — [PASS/FAIL/NA] — evidence · fix
- 1.3.1 Info and Relationships (A) — ...
- 1.3.5 Identify Input Purpose (AA) — ...
- 1.4.3 Contrast (Minimum) (AA) — [ratios observed] ...
- 1.4.4 Resize Text (AA) — ...
- 1.4.10 Reflow (AA) — ...
- 1.4.11 Non-text Contrast (AA) — ...
- 1.4.12 Text Spacing (AA) — ...
- 1.4.13 Content on Hover or Focus (AA) — ...

### Operable
- 2.1.1 Keyboard (A) — ...
- 2.1.2 No Keyboard Trap (A) — ...
- 2.1.4 Character Key Shortcuts (A) — ...
- 2.4.1 Bypass Blocks (A) — ...
- 2.4.3 Focus Order (A) — ...
- 2.4.4 Link Purpose (A) — ...
- 2.4.6 Headings and Labels (AA) — ...
- 2.4.7 Focus Visible (AA) — ...
- 2.4.11 Focus Not Obscured (Min) (AA) 🆕 — ...
- 2.5.1 Pointer Gestures (A) — ...
- 2.5.2 Pointer Cancellation (A) — ...
- 2.5.3 Label in Name (A) — ...
- 2.5.7 Dragging Movements (AA) 🆕 — ...
- 2.5.8 Target Size (Min) (AA) 🆕 — ...

### Understandable
- 3.1.1 Language of Page (A) — ...
- 3.2.1 On Focus (A) — ...
- 3.2.2 On Input (A) — ...
- 3.2.3 Consistent Navigation (AA) — ...
- 3.2.4 Consistent Identification (AA) — ...
- 3.2.6 Consistent Help (A) 🆕 — ...
- 3.3.1 Error Identification (A) — ...
- 3.3.2 Labels or Instructions (A) — ...
- 3.3.3 Error Suggestion (AA) — ...
- 3.3.4 Error Prevention (AA) — ...
- 3.3.7 Redundant Entry (A) 🆕 — ...
- 3.3.8 Accessible Authentication (Min) (AA) 🆕 — ...

### Robust
- 4.1.2 Name, Role, Value (A) — ...
- 4.1.3 Status Messages (AA) — ...

### Critical fixes (ordered)
1. ...
2. ...

### Manual checks still needed
- Screen reader walkthrough (NVDA/VoiceOver)
- Keyboard-only navigation test
- Contrast measurement on dynamic states (hover/focus)
- Zoom to 400% reflow test

For contrast checks, if you have the actual color values, compute the WCAG ratio. Otherwise mark "Needs manual check" and list what to measure.
For keyboard/focus checks with code available, trace tab order in the markup. Flag any tabindex="-1" on interactive elements, missing focus styles (outline: none without replacement), and sticky headers that could obscure focus.
For the new 2.2 criteria, always evaluate explicitly even if unfamiliar — that's where most audits miss things.

Ground rules

AA is the baseline for production. AAA is a stretch goal — note but don't gate ship on AAA.
Don't mark something "Pass" without evidence in the target; say "Likely pass, needs manual confirmation" if evidence is partial.
Color-only indicators always fail WCAG 1.4.1 regardless of contrast.
outline: none without a replacement focus style always fails 2.4.7.
Missing <label> always fails 3.3.2 — aria-label on the input is acceptable only if the visible text matches.
Don't trust automated checkers alone — always list what still needs manual verification.

Reference

Full criterion list and the nine new 2.2 criteria table are in ${CLAUDE_PLUGIN_ROOT}/references/UI_MASTER_GUIDE.md Part XII.