software-accessibility
Installation
SKILL.md
Accessibility Engineering
Use this skill to implement accessibility in code: semantic HTML, ARIA only where necessary, keyboard support, focus management, screen-reader compatibility, and baseline automation in CI.
This skill owns engineering implementation. It does not own design-side WCAG interpretation or formal accessibility-test programs.
Quick Reference
| Need | Default | Notes |
|---|---|---|
| fix component semantics | semantic HTML first | add ARIA only when HTML is insufficient |
| keyboard support | tab order, visible focus, correct key handling | test manually every time |
| screen reader verification | Primary browser/reader pair for the affected users | add a second platform for shared primitives or cross-platform claims |
| automated coverage | axe-core plus Lighthouse or Pa11y | automation catches markup-level issues, not the full experience |
| modal or composite widget | APG-aligned pattern | do not invent custom keyboard behavior |
| compliance prep | Design/test to WCAG 2.2 AA, then map the applicable legal or procurement baseline | do not describe the design target as the binding version everywhere |
| WCAG 2.2 checklist, axe-core/Pa11y snippets, EU Accessibility Act | references/wcag-2-2-checklist.md | includes June 2025 EAA applicability decision |
| run axe-core in CI | scripts/run_axe.sh | exits non-zero on violations |