charleswiltgen/axiom-accessibility

Accessibility

You MUST use this skill for ANY accessibility work including VoiceOver, Dynamic Type, color contrast, WCAG compliance, and UX flow auditing.

Quick Reference

| Symptom / Task | Reference | |----------------|-----------| | VoiceOver labels, hints, navigation | See skills/accessibility-diag.md | | Dynamic Type scaling violations | See skills/accessibility-diag.md | | Color contrast (WCAG AA/AAA) | See skills/accessibility-diag.md | | Touch target sizes (< 44x44pt) | See skills/accessibility-diag.md | | Keyboard navigation (iPadOS/macOS) | See skills/accessibility-diag.md | | Reduce Motion support | See skills/accessibility-diag.md | | Assistive Access (cognitive, iOS 17+) | See skills/accessibility-diag.md | | Accessibility Inspector workflows | See skills/accessibility-diag.md | | App Store Review preparation | See skills/accessibility-diag.md | | UX dead ends, dismiss traps | See skills/ux-flow-audit.md | | Buried CTAs, missing empty states | See skills/ux-flow-audit.md | | Missing loading/error states | See skills/ux-flow-audit.md | | Deep link dead ends | See skills/ux-flow-audit.md | | Accessibility dead ends (gesture-only) | See skills/ux-flow-audit.md | | watchOS-specific (VoiceOver rotor on Digital Crown, AssistiveTouch, Double Tap) | See skills/watchos-a11y.md |

Cross-Suite Routes

• Full watchOS development context → See axiom-watchos

Decision Tree

digraph accessibility {
    start [label="Accessibility issue" shape=ellipse];
    what [label="What type?" shape=diamond];

    start -> what;
    what -> "skills/accessibility-diag.md" [label="VoiceOver/labels/hints"];
    what -> "skills/accessibility-diag.md" [label="Dynamic Type"];
    what -> "skills/accessibility-diag.md" [label="color contrast"];
    what -> "skills/accessibility-diag.md" [label="touch targets"];
    what -> "skills/accessibility-diag.md" [label="keyboard nav"];
    what -> "skills/accessibility-diag.md" [label="Reduce Motion"];
    what -> "skills/accessibility-diag.md" [label="Assistive Access"];
    what -> "skills/accessibility-diag.md" [label="App Store prep"];
    what -> "skills/ux-flow-audit.md" [label="UX dead end/dismiss trap"];
    what -> "skills/ux-flow-audit.md" [label="missing states"];
    what -> "skills/watchos-a11y.md" [label="watchOS VoiceOver / AssistiveTouch / Double Tap"];
    what -> "accessibility-auditor" [label="automated scan" shape=box];
}

1. ANY VoiceOver, Dynamic Type, contrast, touch target, or WCAG issue → skills/accessibility-diag.md
2. Assistive Access (cognitive disabilities, iOS 17+) → skills/accessibility-diag.md
3. App Store accessibility rejection → skills/accessibility-diag.md
4. UX dead ends, dismiss traps, buried CTAs, missing states → skills/ux-flow-audit.md
5. watchOS-specific accessibility (rotor on Digital Crown, AssistiveTouch, Double Tap) → skills/watchos-a11y.md
6. Want automated accessibility scan? → accessibility-auditor agent or /axiom:audit accessibility

Automated Scanning

Accessibility audit → Launch accessibility-auditor agent or /axiom:audit accessibility

• VoiceOver labels and hints
• Dynamic Type violations
• Color contrast failures
• WCAG compliance scanning

UX flow audit → Launch ux-flow-auditor agent

• Dead-end views, dismiss traps
• Buried CTAs, missing empty/loading/error states
• Deep link dead ends, accessibility dead ends

Critical Patterns

Image Accessibility

• Use Image(decorative: "photo") for purely decorative images — automatically hidden from VoiceOver (equivalent to accessibilityHidden(true) but semantically clearer)
• Use accessibilityInputLabels() for buttons with complex or changing labels — improves Voice Control accuracy by providing alternative labels
• Respect accessibilityDifferentiateWithoutColor environment value — when active, provide non-color cues (icons, patterns, labels) alongside color indicators

Anti-Rationalization

| Thought | Reality | |---------|---------| | "I'll add VoiceOver labels when I'm done building" | Accessibility is foundational, not polish. accessibility-diag prevents App Store rejection. | | "My app doesn't need accessibility" | All apps need accessibility. It's required by App Store guidelines and benefits all users. | | "Dynamic Type just needs .scaledFont" | Dynamic Type has 7 common violations. accessibility-diag catches them all. | | "Color contrast looks fine to me" | Visual assessment is unreliable. WCAG ratios require measurement. accessibility-diag validates. | | "UX issues are just polish" | UX dead ends cause 1-star reviews. They're defects, not enhancements. | | "The dismiss gesture handles it" | fullScreenCover has no dismiss gesture. That's the trap. |

Example Invocations

User: "My button isn't being read by VoiceOver" → See skills/accessibility-diag.md

User: "How do I support Dynamic Type?" → See skills/accessibility-diag.md

User: "Check my app for accessibility issues" → See skills/accessibility-diag.md

User: "Prepare for App Store accessibility review" → See skills/accessibility-diag.md

User: "Scan my app for accessibility issues automatically" → Launch accessibility-auditor agent

User: "How do I support Assistive Access?" → See skills/accessibility-diag.md

User: "Check for UX dead ends and dismiss traps" → See skills/ux-flow-audit.md

User: "My fullScreenCover has no way to dismiss" → See skills/ux-flow-audit.md

User: "Are there missing empty states in my app?" → See skills/ux-flow-audit.md