ios-accessibility-audit

Audit iOS and macOS app interfaces and source code for accessibility issues.

4|1|Updated Apr 2, 2026
One-click install
npx skills add https://github.com/AutisticAF/claude-code-apple-dev-plugin --skill ios-accessibility-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-accessibility-audit
Source: https://github.com/AutisticAF/claude-code-apple-dev-plugin/tree/main/skills/ios-accessibility-audit
Command: npx skills add https://github.com/AutisticAF/claude-code-apple-dev-plugin --skill ios-accessibility-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers and accessibility reviewers systematically discover, prioritize, and remediate accessibility issues in iOS and macOS applications so interfaces are usable with VoiceOver, Dynamic Type, Switch Control, Full Keyboard Access, and meet common WCAG AA criteria.

Core Features & Use Cases

  • Guided Audit Process: Step-by-step categories (VoiceOver, Dynamic Type, Color & Contrast, Motion, Switch Control & Keyboard, Semantic Structure, Images, Custom Controls) to structure reviews.
  • Code Discovery Patterns: Search patterns and heuristics to locate common problems such as missing accessibilityLabel, hardcoded font sizes, and hardcoded Color values.
  • Practical Fixes & Patterns: Concrete SwiftUI/UIKit recommendations (traits, accessibilityRepresentation, scaled metrics, ignore-invert flags, adjustable actions) and testing approaches.
  • Testing & Automation: Instructions for using Xcode Accessibility Inspector, VoiceOver manual protocol, and Xcode UI tests to perform automated accessibility audits.
  • Use Case: Use this skill when preparing an app for a11y review, fixing multiple WCAG issues before submission, or validating large UI refactors for VoiceOver compatibility.

Quick Start

Run ios-accessibility-audit on my project to generate a prioritized accessibility audit covering VoiceOver, Dynamic Type, color contrast, and keyboard/ switch control issues.

Frequently Asked Questions about ios-accessibility-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my iOS app for VoiceOver and Dynamic Type accessibility issues?

To audit iOS accessibility, examine VoiceOver reading order, accessibility labels, hints, and traits, then verify Dynamic Type scaling. This process identifies missing attributes and hardcoded fonts, providing actionable SwiftUI/UIKit remediation steps and test suggestions.

What is the best way to check color contrast against WCAG AA in a SwiftUI app?

Checking color contrast against WCAG AA involves locating hardcoded color values in your source code and evaluating them. The audit provides specific SwiftUI/UIKit remediation patterns to fix contrast issues and ensure interface components meet accessibility standards.

Can I use this to find missing accessibility labels and traits in UIKit?

Yes, you can find missing accessibility labels and traits in UIKit by applying targeted code discovery patterns. These heuristics locate missing or incorrect accessibility attributes and generate concrete, framework-compatible fixes to improve custom control semantics.

How do I test Switch Control and Full Keyboard Access in macOS apps?

Testing Switch Control and Full Keyboard Access requires evaluating input methods and semantic structure. The audit identifies grouping and reading-order defects, offering actionable remediation steps and instructions for using Xcode Accessibility Inspector and UI tests.

Does this accessibility audit work with both iOS and macOS source code?

Yes, this accessibility audit works with both iOS and macOS applications. It systematically reviews interfaces and source code for screen readers, dynamic type, contrast, motion, and input methods, yielding prioritized SwiftUI and UIKit remediation steps.

Why does VoiceOver read my custom iOS controls in the wrong order?

VoiceOver reads custom controls incorrectly when there are grouping and reading-order defects or missing semantic traits. The audit identifies these structural issues and provides actionable remediation steps using accessibilityRepresentation and adjustable actions.