a11y-audit
Audit a UI or design against WCAG 2.2 AA/AAA and ARIA patterns, returning criterion-referenced findings with severity and specific fixes. Use when the user wants an accessibility check, contrast verification, keyboard/screen-reader review, or wants to confirm a component meets POUR.
How do I install this agent skill?
npx skills add https://github.com/plugin87/ux-ui-agent-skills --skill a11y-auditIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is designed to perform accessibility audits using specialized scripts for contrast and layout measurement. It uses standard command-line tools to process local files and returns structured findings. No security issues were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Skill: Accessibility Audit
Evaluate against WCAG 2.2 and the project's ARIA patterns.
Steps
- Read
accessibility/wcag-checklist.md(POUR-organized, P0/P1/P2) andaccessibility/aria-patterns.md. - Check the mandatory P0 set per component: keyboard navigable, focus visible (≥3:1), screen-reader name/role/state, contrast (4.5:1 text / 3:1 UI), target size ≥24×24, no color-only signaling.
- Verify WCAG 2.2 additions: Focus Not Obscured (2.4.11), Target Size (2.5.8), Accessible Authentication (3.3.8).
- Contrast — measure, don't eyeball. For rendered HTML, RUN the real-render gates and report their actual output (CLAUDE.md → Verification Protocol):
node scripts/measure_render.mjs <file> [--dark](every text element) ANDnode scripts/verify_states.mjs <file> [--dark](every interactive element in default/hover/focus — catches hover-state failures). For loose color pairs,python3 scripts/contrast.py "<fg>" "<bg>". Never state a ratio you did not measure. - Check reduced-motion handling (
taste/motion-choreography.md).
Output
A findings table: WCAG criterion (e.g. 1.4.3) · severity (P0/P1/P2) · what fails · specific fix. Confirm passes explicitly. Accessibility may never be traded for aesthetics.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/plugin87/ux-ui-agent-skills/a11y-audit">View a11y-audit on skillZs</a>