/axiom-accessibility

name: axiom-accessibility
description: Use when fixing or auditing ANY accessibility issue — VoiceOver, Dynamic Type, color contrast, touch targets, WCAG compliance, App Store accessibility review.
license: MIT

Accessibility

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

<!-- AXIOM_AUDITOR_INLINE_BEGIN — rewritten for Codex by scripts/build-codex.ts; do not hand-edit --> > **Auditors are skills here.** Where this router says "Launch `some-auditor` agent", invoke the > matching Codex skill instead — same procedure, no Claude Code agent required. > > Available: `axiom-audit-accessibility`, `axiom-audit-concurrency`, `axiom-audit-swiftdata`, `axiom-audit-swiftui-nav`, `axiom-audit-ux-flow`. > > The ones that shell out — builds, tests, simulators, crash symbolication — need shell access to run. <!-- AXIOM_AUDITOR_INLINE_END -->

Quick Reference

| Symptom / Task | Reference | |----------------|-----------| | VoiceOver labels, hints, navigation | See `skills/accessibility-diag.md` | | Dynamic Type scaling violations | See `skills/accessibility-diag.md` | | Dynamic Type on tvOS (Large Text, tvOS 27) | See `skills/accessibility-diag.md` | | Long-form reading apps (continuous reading, Speak Screen, text navigation) | See `skills/accessibility-diag.md` | | Captions & subtitle styling in video players (generated subtitles, style preview) | See `skills/accessibility-diag.md` | | Custom control technique choice (adjustable, passthrough, direct touch) | See `skills/accessibility-diag.md` | | Accessibility Nutrition Labels | 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` | | Button Shapes, Large Content Viewer, Full Keyboard Access, Switch Control | See `skills/accessibility-diag.md` | | VoiceOver order broken after resize / column collapse; table & grid semantics | 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` | | 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
• Live accessibility validation on the simulator (set toggles, assert announcements) → `simulator-tester` agent + `xcui` — see axiom-tools (skills/xcui-ref.md)
• Asserting VoiceOver speech in an XCUITest (`XCUIDevice.shared.voiceOverService`, `OS27`) → axiom-testing (skills/ui-testing.md Pattern 7)

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="resizable window / desktop-class"];
    what -> "skills/accessibility-diag.md" [label="Reduce Motion"];
    what -> "skills/accessibility-diag.md" [label="Assistive Access"];
    what -> "skills/accessibility-diag.md" [label="custom control techniques"];
    what -> "skills/accessibility-diag.md" [label="continuous reading / text navigation"];
    what -> "skills/accessibility-diag.md" [label="captions / subtitle styling"];
    what -> "skills/accessibility-diag.md" [label="App Store prep / Nutrition Labels"];
    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 (including tvOS Large Text), contrast, touch target, or WCAG issue → `skills/accessibility-diag.md` 2. Assistive Access (cognitive disabilities, iOS 17+) → `skills/accessibility-diag.md` 3. Accessibility Nutrition Labels, or an App Review note about accessibility → `skills/accessibility-diag.md` 4. Reading app: VoiceOver stops at paragraphs/pages, Speak Screen halts → `skills/accessibility-diag.md` 5. UX dead ends, dismiss traps, buried CTAs, missing states → `skills/ux-flow-audit.md` 6. watchOS-specific accessibility (rotor on Digital Crown, AssistiveTouch, Double Tap) → `skills/watchos-a11y.md` 7. Want automated accessibility scan? → `accessibility-auditor` agent or `axiom-audit-accessibility`

Automated Scanning

**Accessibility audit** → `axiom-audit-accessibility`

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

**UX flow audit** → `axiom-audit-ux-flow`

• 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 acc