Accessibility Audit (a11y-audit)
Audits a UI against WCAG 2.2 AA/AAA and ARIA patterns, returning a findings table with criterion numbers, severity, and specific fixes.
Design & UIIntermediate★ 3,146⑂ 303AI score 8/10Last updated: Oct 27, 2026
What it does
- Audits UI/design against WCAG 2.2 AA/AAA plus the project's ARIA patterns.
- Enforces a mandatory P0 set per component: keyboard navigable, visible focus (≥3:1), screen-reader name/role/state, 4.5:1 text / 3:1 UI contrast, ≥24×24 targets, no color-only signaling.
- Verifies WCAG 2.2 additions: Focus Not Obscured (2.4.11), Target Size (2.5.8), Accessible Authentication (3.3.8).
- Measures contrast instead of eyeballing via
gate.mjs measure_render.mjs,verify_states.mjs, orcontrast.py, and forbids quoting unmeasured ratios. - Outputs a table: WCAG criterion · severity (P0/P1/P2) · what fails · specific fix.
Who it's for
- Front-end engineers, UI/UX designers, and QA doing accessibility reviews.
- Design-system teams needing evidence that components pass.
- Regulated projects that require criterion-referenced reports.
Examples
- "Audit this modal for POUR compliance" → flags keyboard traps, focus return, and missing labels as P0.
- "Verify dark-mode contrast for dashboard.html" → runs
measure_render.mjs <file> --darkand reports real ratios. - "Check button hover/focus states" →
verify_states.mjscatches hover-state contrast failures.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/plugin87/ux-ui-agent-skills/HEAD/.claude/skills/a11y-audit/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on AI Skill Mart. Copy the .claude/skills/a11y-audit folder from the GitHub repo plugin87/ux-ui-agent-skills into my ~/.claude/skills/plugin87-a11y-audit/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/plugin87/ux-ui-agent-skills.git && mkdir -p ~/.claude/skills && cp -r ux-ui-agent-skills/.claude/skills/* ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and go to your working directory.
- Clone the repo:
git clone https://github.com/plugin87/ux-ui-agent-skills.git - This skill reads "kit" folders (
tokens/,accessibility/,scripts/). A skills-folder-only install reports KIT_MISSING and stops. - Easiest path: run
npx ux-ui-agent-skills initfrom the repo, or install it as a plugin. - Manual install:
mkdir -p ~/.claude/skills && cp -r ux-ui-agent-skills/.claude/skills/* ~/.claude/skills/, keeping the kit folders at the same relative paths. - Confirm Node.js and Python 3 are available (
node -v,python3 -V). - Restart Claude Code and ask something like "run an accessibility audit on this page".
View source on GitHub ↗License: MIT