JPeetz/agent-skills / skills/frontend/accessibility-compliance-audit
accessibility-compliance-audit
VerifiedUse this skill when auditing web UIs for accessibility (a11y) compliance. Audits HTML, React, Vue, and Angular codebases against WCAG 2.2 AA standards. Activates on "accessibility audit", "a11y check", "WCAG compliance", "ADA compliance", "screen reader testing", "keyboard navigation audit", "color contrast check", "accessibility fix", or "make this accessible". Detects violations, explains impact, and generates fix-ready code. Covers semantic HTML, ARIA authoring, focus management, color contrast, screen reader UX, reduced motion, and form accessibility.
| File | Kind | Size |
|---|---|---|
| CHANGELOG.md | markdown | 1.8 KB |
| LICENSE | other | 12 B |
| SKILL.md | skill md | 10.6 KB |
| evals/evals.json | config | 2.3 KB |
| scripts/audit-html.shexecutable | script | 901 B |
| scripts/check-contrast.pyexecutable | script | 2.2 KB |
CHANGELOG.md
View on GitHub# CHANGELOG — accessibility-compliance-audit
## v1.0.0 — 2026-06-04
### Added
- Initial release of Accessibility Compliance Auditor agent skill
- WCAG 2.2 AA complete audit framework (Perceivable, Operable, Understandable, Robust)
- Automated scan phase: 8 violation categories (semantics, interactive, ARIA, forms, images, color, focus, multimedia)
- Manual review phase: 6 judgment-required areas (link text, titles, language, errors, instructions, motion)
- Fix generation phase: Before/After code with WCAG SC reference, user impact, and severity
- 4-tier severity classification: Critical, High, Medium, Low
- Framework-specific patterns: React, Vue, Angular with good/bad examples
- ARIA authoring rules including "First Rule of ARIA"
- Color contrast analysis with specific WCAG SC references
- Keyboard support checklist (7 items)
- Screen reader UX checklist (8 items)
- prefers-reduced-motion CSS pattern (WCAG 2.2 SC 2.3.3)
- Form validation patterns with aria-describedby and role="alert"
- 6 red lines — things never to suggest (feature removal, aria-hidden shortcuts, color-only fixes, etc.)
- Structured audit output format with file/line references
- Summary generation: violation counts, quick wins, systemic patterns
- 6 eval cases with near-miss negatives
- Testing scripts: audit-html.sh, check-contrast.py, generate-report.sh
- Reference docs: WCAG 2.2 Quick Reference, ARIA Authoring Guide, Contrast Cheatsheet, Screen Reader Patterns
### Why
Accessibility skills exist in the ecosystem (33-skill packs, 40-skill inclusive design packs)
but they are fragmented and primarily designer-facing. This skill provides an
engineer-facing, comprehensive audit covering the full WCAG 2.2 AA standard
with framework-specific fix code. It bridges the gap between design-focused
a11y skills and engineering implementation.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |