Back to Skills

ios-accessibility

Implements, reviews, or improves accessibility in iOS/macOS apps with SwiftUI, UIKit, and AppKit. Use when adding VoiceOver, Voice Control, Switch Control, or Full Keyboard Access support; when working with accessibility labels, hints, values, traits, accessibilityInputLabels, NSAccessibility, grouping, reading order, accessibility focus restoration with @AccessibilityFocusState, Dynamic Type, @ScaledMetric, custom rotors, accessibility actions, XCTest accessibility checks, App Store Accessibili

673stars37forksUpdated 6/2/2026

Security Assessment

Safe(100/100)
Security Score100/100

About ios-accessibility

The ios-accessibility skill provides guidance and best practices for implementing and enhancing accessibility in iOS, iPadOS, and macOS applications. It addresses common challenges developers face when ensuring that apps are usable by individuals relying on assistive technologies such as VoiceOver, Voice Control, Switch Control, and Full Keyboard Access. By following the patterns and principles in this skill, developers can make interactive elements fully navigable, understandable, and operable for all users, improving inclusivity and compliance with accessibility standards.

This skill covers core accessibility principles and practical implementation strategies across SwiftUI, UIKit, and AppKit. Key capabilities include adding and managing accessibility labels, hints, values, and traits; handling focus restoration; supporting Dynamic Type with scalable fonts; implementing custom rotors and adjustable controls; respecting system accessibility preferences; and integrating App Store Accessibility Nutrition Labels. It also includes guidance on hiding decorative content, designing tap targets of sufficient size, and performing automated accessibility tests using XCTest. The skill emphasizes proper focus management when sheets, dialogs, or popovers are dismissed, ensuring assistive technology users maintain context.

Target users for this skill are iOS and macOS developers, accessibility engineers, and QA testers focusing on app accessibility compliance. It is particularly useful for teams building applications intended for a wide range of users, including those with visual, motor, or cognitive impairments. Common use cases include adding accessibility support to existing apps, performing accessibility audits, preparing apps for App Store submission with complete accessibility information, and implementing inclusive design patterns in new applications to meet regulatory and best-practice standards.

FAQ

Which assistive technologies does this skill support?

It provides guidance for VoiceOver, Voice Control, Switch Control, Full Keyboard Access, and other system accessibility preferences.

Is this skill compatible with all Apple UI frameworks?

Yes, it covers SwiftUI, UIKit, and AppKit patterns for iOS, iPadOS, and macOS applications.

How does this skill handle custom controls?

Custom controls should expose the appropriate accessibility traits, use adjustable actions when needed, and provide clear labels and values without including control type in the label.

Does this skill include testing guidance?

Yes, it recommends using XCTest accessibility checks and following best practices for focus management, tap targets, and system preference compliance.

Are there limitations regarding visual-only cues?

Yes, information should not rely on color alone; text or icon alternatives must be provided to ensure accessibility.

All Files

5 files
evals/evals.json5.3 KB
View
references/nutrition-labels.md7.3 KB
View
references/a11y-patterns.md11.9 KB
View
SKILL.md23.3 KB
View
references/media-accessibility.md3.5 KB
View

Install ios-accessibility

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill