diff --git a/skills/a11y-audit/SKILL.md b/skills/a11y-audit/SKILL.md new file mode 100644 index 0000000..27331f5 --- /dev/null +++ b/skills/a11y-audit/SKILL.md @@ -0,0 +1,102 @@ +--- +name: a11y-audit +description: Use when auditing accessibility — WCAG 2.2 AA compliance, contrast checks, keyboard navigation, screen reader support, prefers-reduced-motion. Triggers on "accessibility", "a11y", "wcag", "screen reader", "contrast check". +arguments: + - name: command + description: "Command: scan, fix, contrast, checklist, report" + required: false + - name: target + description: URL or file path to audit + required: false +--- + +# Accessibility Audit — WCAG 2.2 AA + +## Legal Context + +- **EAA (EU):** In force since June 2025. Penalties: up to 100K EUR / 4% revenue +- **ADA (US):** References WCAG 2.2 AA +- **Standard:** WCAG 2.2 AA is minimum for any commercial site targeting US/EU + +## Top 10 Violations + +1. Missing alt text on images +2. Low contrast text (4.5:1 normal, 3:1 large text) +3. Keyboard traps in menus +4. Missing form labels +5. Skipped heading levels +6. No skip links +7. Non-semantic HTML (`
` instead of `