ios-accessibility

Audit UIKit or SwiftUI elements and propose iOS accessibility fixes.

Updated May 6, 2026
One-click install
npx skills add https://github.com/Roy-wonji/claude-config --skill ios-accessibility-roy-wonji
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-accessibility
Source: https://github.com/Roy-wonji/claude-config/tree/main/skills/ios-accessibility
Command: npx skills add https://github.com/Roy-wonji/claude-config --skill ios-accessibility-roy-wonji

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you fix iOS accessibility gaps—so users with disabilities can navigate, understand, and complete tasks reliably using VoiceOver, Dynamic Type, and other assistive technologies.

Core Features & Use Cases

  • UIKit + SwiftUI accessibility guidance: labels, traits, values, grouping, and focus/announcement behavior tailored to the framework you’re using.
  • Inclusive design decision-making: proposes multiple options with pros/cons and UX trade-offs, then guides you to test manually (and where possible, automatically).
  • Accessibility workflow for real development: includes project capability intake (framework, deployment target, design system, localization) plus a quick decision tree for common problems (VoiceOver, Dynamic Type, Switch Control, keyboard access, contrast, motion, etc.).

Use case: Your iOS screen has icon-only buttons and VoiceOver reads “button,” and the layout breaks at Large Accessibility Sizes—this Skill helps you correct labeling, grouping, and layout adaptation, while also providing testing steps you can run before shipping.

Quick Start

Use ios-accessibility to audit the provided iOS UI code for accessibility issues (VoiceOver labels/traits, Dynamic Type scalability, and other assistive technologies) and return concrete fixes with testing steps.

Frequently Asked Questions about ios-accessibility

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

FAQPage Schema
How do I fix VoiceOver reading "button" for icon-only controls in SwiftUI?

To fix VoiceOver reading generic labels for icon-only controls in SwiftUI, you need to set explicit accessibility labels using the accessibilityLabel modifier so the screen reader announces the button's actual function.

How do I prevent layout breaks when users enable Dynamic Type at large accessibility sizes?

Prevent layout breaks at large accessibility sizes by auditing your UIKit or SwiftUI UI elements for adaptive behavior and applying proposed fixes for grouping and scalable layout constraints.

What is the best way to audit an iOS app for Switch Control and Voice Control compatibility?

The best way to audit for Switch Control and Voice Control compatibility is to evaluate your UI elements against inclusive design criteria, proposing fixes for traits, grouping, and touch target sizes.

Does this accessibility guidance work with both UIKit and SwiftUI frameworks?

Yes, this guidance works with both UIKit and SwiftUI, providing tailored fixes for labels, traits, values, grouping, and focus behavior specific to the framework you are using.

How do I test iOS accessibility fixes for reduce motion and contrast requirements?

Test iOS accessibility fixes for reduce motion and contrast by following actionable manual and automated testing instructions provided for each proposed UI adjustment before shipping.