Axiom Accessibility Skill: Audit iOS App Accessibility

What is the axiom-accessibility skill?

The axiom-accessibility skill is the accessibility entry point inside Axiom, a suite of skills for Apple platform development. Its SKILL.md opens by demanding use for any VoiceOver, Dynamic Type, color contrast or WCAG work.

Despite sitting in a web design category, it targets native apps on iOS, iPadOS, watchOS and tvOS. The file is a router: it sends each symptom to a deeper reference in its own skills folder instead of holding every rule inline.

What changes in your agent's output

• VoiceOver, Dynamic Type, contrast and touch target problems go to one diagnostic reference, so the agent follows a fixed checklist instead of guessing.
• Decorative images use Image(decorative:) so VoiceOver skips them, and buttons with changing labels get accessibilityInputLabels() to help Voice Control.
• Color is never the only signal. When accessibilityDifferentiateWithoutColor is active, the skill asks for icons, patterns or labels beside color.
• Navigation dead ends, such as a fullScreenCover with no way to dismiss it, are treated as defects and not as polish.

Topics the router covers

• VoiceOver labels, hints and navigation order, including order that breaks after a window resize.
• Dynamic Type scaling, plus Large Text on tvOS.
• Color contrast against WCAG AA and AAA, and touch targets smaller than 44 by 44 points.
• Keyboard navigation on iPadOS and macOS, Full Keyboard Access, Switch Control, Button Shapes and the Large Content Viewer.
• Reduce Motion, Assistive Access for cognitive accessibility, Accessibility Inspector workflows and App Store review preparation.

Who the axiom-accessibility skill is for

Best for

• Swift and SwiftUI developers shipping iOS or iPadOS apps who need accessibility fixes before App Store review.
• Teams that want a UX flow audit for dead ends, buried calls to action and missing empty, loading or error states.
• watchOS developers working on the VoiceOver rotor with the Digital Crown, AssistiveTouch or Double Tap.

Not for

• Websites and web apps. For HTML and ARIA work, see web-accessibility-skill.
• Choosing layouts or visual style. For iPad interface conventions, see platform-design-ipados, and for phone app design see design-mobile-apps.
• Installing a single skill alone. It ships inside the full Axiom suite, which the README sizes at 276 skills.

Use it with UiChemy

Axiom covers native Apple apps, and UiChemy builds WordPress sites, so they meet only at the edges. If your app needs a marketing or support site, design it in Figma and bring it over with Figma to WordPress, then Get Started.

How to install Axiom Accessibility Skill: Audit iOS App Accessibility

/plugin marketplace add CharlesWiltgen/Axiom

1. Add the marketplace

   In Claude Code, run /plugin marketplace add CharlesWiltgen/Axiom. This is the README's native plugin install.

2. Install Axiom

   Open the /plugin menu, search for axiom and install it. The skill comes with the whole suite, not on its own.

3. Other agents

   The README documents a native Cursor plugin, an MCP setup for VS Code, Cursor MCP-only and Gemini CLI, pi install git:github.com/CharlesWiltgen/Axiom for Pi, and an Xcode guide for Claude Agent and Codex.

4. Ask an accessibility question

   Try a phrase from the SKILL.md such as a button that VoiceOver does not read, or prepare for App Store accessibility review.

Check that it loaded

Ask the agent why VoiceOver skips a button. It should route to the accessibility-diag reference. You can also run /axiom:audit accessibility for the automated scan.

Read the official instructions on GitHub

Key features

• Accessibility routerSKILL.md maps each symptom to a reference file. VoiceOver, Dynamic Type, contrast, touch targets, keyboard navigation and App Store prep all go to accessibility-diag.
• VoiceOver and labelsCovers VoiceOver labels, hints and navigation, and the case where reading order breaks after a resize or column collapse, including table and grid semantics.
• Dynamic TypeScaling violations are checked through the diagnostic reference, with a separate entry for Large Text on tvOS.
• Contrast and touch targetsColor contrast is measured against WCAG AA and AAA, and touch targets under 44 by 44 points are flagged.
• Assistive input pathsIncludes Full Keyboard Access, Switch Control, Button Shapes, the Large Content Viewer and a choice between adjustable, passthrough and direct touch techniques for custom controls.
• Assistive Access and Reduce MotionAssistive Access for cognitive accessibility on iOS 17 and later, and Reduce Motion support, each have a routed reference.
• App Store preparationAccessibility Nutrition Labels and App Store accessibility review preparation are routed to the same diagnostic file.
• UX flow auditA second reference finds dead ends, dismiss traps, buried calls to action, missing empty, loading and error states, and gesture-only dead ends.
• watchOS accessibilityA watchOS reference covers the VoiceOver rotor on the Digital Crown, AssistiveTouch and Double Tap.
• Automated scanAn accessibility auditor scans for VoiceOver labels, Dynamic Type, contrast and WCAG issues. Where agents cannot be launched, the SKILL.md says to read the auditor file and follow it inline.

Frequently asked questions