Skip to content
Back to search

ios-accessibility-agent-skill

Add expert iOS Accessibility Best Practices guidance to your AI coding tool (Agent Skills open format).

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dadederk--ios-accessibility-agent-skill/badge.svg)](/listings/dadederk--ios-accessibility-agent-skill)

HTML

<a href="/listings/dadederk--ios-accessibility-agent-skill"><img src="/api/listings/dadederk--ios-accessibility-agent-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 163 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # iOS Accessibility Agent Skill
  2. Expert guidance for any AI coding tool that supports the Agent Skills open format: accessible iOS development, VoiceOver, Dynamic Type, assistive technologies, and inclusive design practices.
  3. ## ⚠️ Important Disclaimers
  4. ### Work in Progress
  5. This skill is a work in progress and has not been exhaustively tested. It is provided as-is, and **it is the responsibility of the developer** to thoroughly test and validate any changes suggested through the use of this skill. Ensure that all accessibility implementations work as expected and intended for your users before shipping to production.
  6. ### Accessibility Is Not Deterministic
  7. Unlike many other iOS engineering tasks, accessibility is **not deterministic**. There is rarely a single "correct" fix for an accessibility problem. Multiple approaches can be valid, each with different trade-offs. Evaluate options in context and choose what works best for your users.
  8. **This skill is an aid, not a substitute for intentional and thoughtful design.** Use it as a tool to learn more about accessibility and guide implementation decisions, but do not treat it as a magic solution. Real accessibility requires continuous learning, testing with assistive technologies, and, whenever possible, feedback from users with disabilities.
  9. **Your feedback helps improve this skill.** If you run into issues, share your prompt and a sample of the output (whatever you are comfortable sharing) so we can refine these guidelines. Positive feedback is also useful to understand what is working well.
  10. ## Who This Is For
  11. - Developers building accessible iOS apps with UIKit or SwiftUI
  12. - Teams wanting to embed accessibility into their development workflow
  13. - Anyone building for, or debugging issues on, VoiceOver, Dynamic Type layouts, or any other assistive technologies, accessibility features, and inclusive design.
  14. ## How to Use This Skill
  15. ### Option A: Using skills.sh (recommended)
  16. Install this skill with a single command:
  17. ```bash
  18. npx skills add https://github.com/dadederk/iOS-Accessibility-Agent-Skill --skill ios-accessibility
  19. ```
  20. Then use the skill in your AI agent, for example:
  21. > Use the ios-accessibility skill and review the current view to analyze and find opportunities to improve its VoiceOver support.
  22. ### Option B: Manual Install
  23. 1. **Clone** this repository
  24. 2. **Install or symlink** the `ios-accessibility/` folder following your tool's skills installation docs
  25. 3. **Use your AI tool** and ask it to use the "ios-accessibility" skill for accessibility tasks
  26. #### Where to Save Skills
  27. - **Codex:** [Where to save skills](https://codex.openai.com/docs/skills)
  28. - **Claude Code:** [Using Skills](https://docs.anthropic.com/claude-code/skills)
  29. - **Cursor:** [Enabling Skills](https://docs.cursor.com/skills)
  30. ## What This Skill Offers
  31. ### Platform-Specific Guidance
  32. - **VoiceOver (UIKit)**: Labels, traits, grouping, custom actions, notifications
  33. - **VoiceOver (SwiftUI)**: Accessibility modifiers, element grouping, focus management
  34. - **Dynamic Type (UIKit)**: Text styles, `UIFontMetrics`, layout adaptation
  35. - **Dynamic Type (SwiftUI)**: Scaled metrics, adaptive layouts, environment values
  36. ### Other Assistive Technologies Support
  37. - **Voice Control**: Input labels, naming consistency, testing with "Show names"
  38. - **Switch Control**: Scanning, grouping, custom actions
  39. - **Full Keyboard Access**: Focus order, keyboard shortcuts
  40. ### Cross-Cutting Best Practices
  41. - Touch target sizes (44×44 points minimum)
  42. - Color contrast ratios and Increase Contrast
  43. - Reduce Motion, Reduce Transparency, Bold Text, etc. support
  44. - Multi-modal information (color, shape, iconography, text, sound, haptics...)
  45. ### Testing Guidance
  46. - Manual testing with assistive technologies
  47. - Automated testing with Accessibility Inspector and UI tests
  48. - Limitations of automation (manual testing is essential)
  49. ### Inclusive Design Mindset
  50. - Be thoughtful and context-aware: compare options and validate with real users whenever possible
  51. - Shift left: consider accessibility during design
  52. - Cross-assistive technology benefits: implement once, benefit broadly
  53. ## Scope and Non-Goals
  54. This skill is focused on iOS app accessibility guidance (UIKit and SwiftUI), including implementation and testing patterns for major Apple assistive technologies.
  55. This skill does not try to be:
  56. - A legal compliance service or certification process
  57. - A replacement for testing with real users and assistive technologies
  58. - A complete guide for non-iOS platforms (web, Android, desktop)
  59. ## Complementary Accessibility Skills
  60. This skill was developed in parallel with other accessibility agent skills in the community. It is fair to recognize their great work and point you to these complementary skills.
  61. Both of the following skills were released before this one.
  62. - [swift-accessibility-skill](https://github.com/PasqualeVittoriosi/swift-accessibility-skill) by Pasquale Vittoriosi.
  63. If you need stronger coverage for topics outside this skill's core iOS scope (for example: **macOS accessibility**, **Accessibility Nutrition Labels**, and **WCAG**), consider this one.
  64. - [apple-accessibility-skills](https://github.com/rgmez/apple-accessibility-skills) by Roberto Gómez
  65. ## Inspiration and Acknowledgements
  66. I first learned about Agent Skills from Antoine van der Lee's article:
  67. - [Agent Skills: Replacing AGENTS.md with reusable AI knowledge](https://www.avanderlee.com/ai-development/agent-skills-replacing-agents-md-with-reusable-ai-knowledge/)
  68. In his video, he mentions that someone with expertise in iOS accessibility should write an accessibility skill. That idea directly motivated this project.
  69. One of his skills is also a useful reference:
  70. - [SwiftUI-Agent-Skill](https://github.com/AvdLee/SwiftUI-Agent-Skill)
  71. ## Skill Structure
  72. The skill is organized as follows:
  73. ```text
  74. ios-accessibility/ # Main skill folder
  75. ├── SKILL.md # Entry point and behavior contract
  76. └── references/ # Detailed implementation guides
  77. ├── voiceover.md # Core VoiceOver concepts and testing
  78. ├── voiceover-uikit.md # UIKit VoiceOver implementation patterns
  79. ├── voiceover-swiftui.md # SwiftUI VoiceOver implementation patterns
  80. ├── dynamic-type.md # Core Dynamic Type concepts and scaling model
  81. ├── dynamic-type-uikit.md # UIKit Dynamic Type implementation patterns
  82. ├── dynamic-type-swiftui.md # SwiftUI Dynamic Type implementation patterns
  83. ├── voice-control.md # Voice Control patterns and pitfalls
  84. ├── switch-control.md # Switch Control scanning/grouping guidance
  85. ├── full-keyboard-access.md # Keyboard navigation and focus behavior
  86. ├── good-practices.md # Cross-cutting accessibility best practices
  87. ├── concepts-and-culture.md # Inclusive design mindset and team culture
  88. ├── testing-manual.md # Manual testing workflows by assistive tech
  89. ├── testing-automated.md # Automated testing and inspector guidance
  90. ├── playbook.md # Quick fixes, checklists, and common mistakes
  91. ├── glossary.md # Accessibility terminology reference
  92. └── resources.md # Sources and further reading
  93. ```
  94. ## Sources
  95. - **Main resource used to develop this Agent Skill:** [#365DaysIOSAccessibility](https://accessibilityupto11.com/365-days-ios-accessibility/) by Daniel Devesa Derksen-Staats
  96. - [From Zero to Accessible](https://github.com/dadederk/fromZeroToAccessible) workshop by Rob Whitaker and Daniel Devesa Derksen-Staats
  97. - [Fostering an Accessibility Culture](https://www.smashingmagazine.com/2025/04/fostering-accessibility-culture/) (Smashing Magazine)
  98. - [Developing Accessible iOS Apps — Sample Code](https://github.com/Apress/developing-accessible-iOS-apps)
  99. ## Contributing
  100. Contributions are welcome! This repository follows the [Agent Skills open format](https://agentskills.io).
  101. ## Validation
  102. To validate the skill against the Agent Skills reference format, use the `skills-ref` validator (for example, `npx skills-ref ios-accessibility/`).
  103. ## About the Author
  104. Created by Daniel Devesa Derksen-Staats, an iOS engineer specializing in accessibility. Author of [Developing Accessible iOS Apps](https://link.springer.com/book/10.1007/978-1-4842-5308-3) and creator of the [Accessibility Up To 11](https://accessibilityupto11.com) series.
  105. ## License
  106. This skill is open-source and available under the MIT License. See [LICENSE](LICENSE) for details.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.