A11y Audit
WCAG 2.2 AA/AAA audit with measured contrast ratios and criterion-referenced fixes
Test report
- Verdict
- Tested · Works
- Score
- Tested
- Jul 21, 2026
- Environment
- Claude Code 2.x (agent harness)
- Upstream re-checked
- Aug 10, 2026 · 90ded62
Fetched SKILL.md and spot-checked 6 referenced paths via raw fetch — all HTTP 200; wcag-checklist.md and aria-patterns.md are substantial real references (POUR-organized criteria table, ARIA APG keyboard maps). Ran scripts/contrast.py (pure python3, no deps): #767676/#fff = 4.54:1 PASS, #999/#fff = 2.85:1 FAIL, exit codes correct. For the output test I wrote a 6-element card.html and audited it two ways: a baseline eyeball audit vs the skill body, which mandates running contrast.py per pair. Measured ratios flipped two eyeball judgments — the blue link #5b8def looks fine but measures 3.23:1 (FAIL 1.4.3) and the red badge #d32f2f looks weak but measures 4.98:1 (PASS); #8a8a8a heading = 3.45:1 and #a0a0a0 text = 2.61:1 both FAIL. No security smells (no curl|sh, base64, eval). Friction: skill dir bundles only SKILL.md and depends on repo-root sibling files/scripts, so a standalone skill-dir copy breaks its steps — full package install needed.
Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works
- Installs cleanly 5/5
- Triggers reliably 5/5
- Output vs. baseline 7/10
- Docs & honesty 4/5
What A11y Audit does
Audits a UI or component against WCAG 2.2 AA/AAA and WAI-ARIA patterns, returning a findings table keyed to specific success criteria with P0/P1/P2 severity and concrete fixes. Triggers when the user asks for an accessibility check, contrast verification, or keyboard/screen-reader review. It reads a POUR-organized checklist and ARIA reference and measures color contrast with a bundled script rather than eyeballing ratios.
How to install A11y Audit
git clone --depth 1 https://github.com/plugin87/ux-ui-agent-skills.git /tmp/a11y-audit-src
mkdir -p ~/.claude/skills
cp -R /tmp/a11y-audit-src/.claude/skills/a11y-audit ~/.claude/skills/a11y-audit
# IMPORTANT: the skill dir holds only SKILL.md. Its steps read repo-root sibling files
# accessibility/wcag-checklist.md, accessibility/aria-patterns.md, taste/motion-choreography.md
# and run scripts/contrast.py, scripts/measure_render.mjs, scripts/verify_states.mjs
# — all relative to the repo root, NOT bundled with the skill. For full function, install the
# whole package into your project: npx ux-ui-agent-skills (installs accessibility/ + scripts/ too).
# scripts/contrast.py = pure python3, no deps. measure_render.mjs/verify_states.mjs need:
# npm i -D playwright (without it they SKIP with exit 0, they do not error).
Skills live in ~/.claude/skills/ (global) or .claude/skills/
(per-project). Restart Claude Code after installing.
Commands — how to trigger A11y Audit
-
/a11y-auditWCAG 2.2 AA/AAA audit with measured contrast ratios and criterion-referenced fixes
It also activates on plain-language prompts like these:
-
Audit this page for WCAG 2.2 AA compliance -
Check the contrast ratios on this design -
Review this component for screen-reader support
Frequently asked questions
- Is the A11y Audit skill free?
- Yes. The skill itself is free from plugin87/ux-ui-agent-skills. SkillProof publishes the install command and an independent test verdict at no cost.
- Does A11y Audit work with Claude Code?
- We tested it with Claude Code 2.x (agent harness) on Jul 21, 2026. Verdict: Tested · Works. Fetched SKILL.md and spot-checked 6 referenced paths via raw fetch — all HTTP 200; wcag-checklist.md and aria-patterns.md are substantial real references (POUR-organized criteria table, ARIA APG keyboard maps). Ran scripts/contrast.py (pure python3, no deps): #767676/#fff = 4.54:1 PASS, #999/#fff = 2.85:1 FAIL, exit codes correct. For the output test I wrote a 6-element card.html and audited it two ways: a baseline eyeball audit vs the skill body, which mandates running contrast.py per pair. Measured ratios flipped two eyeball judgments — the blue link #5b8def looks fine but measures 3.23:1 (FAIL 1.4.3) and the red badge #d32f2f looks weak but measures 4.98:1 (PASS); #8a8a8a heading = 3.45:1 and #a0a0a0 text = 2.61:1 both FAIL. No security smells (no curl|sh, base64, eval). Friction: skill dir bundles only SKILL.md and depends on repo-root sibling files/scripts, so a standalone skill-dir copy breaks its steps — full package install needed.
- What is the A11y Audit SkillProof Score?
- 8.4/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 7/10, docs & honesty 4/5.
- How do I install A11y Audit?
- Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
- Can I use A11y Audit with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
- The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.