iOS Accessibility for Claude Code, Cursor, Codex, and ChatGPT

Plugin for reviewing and improving accessibility in UIKit and SwiftUI interfaces with Claude Code, Cursor, Codex, or ChatGPT. The plugin is based on Mikhail Rubanov's book "About Accessibility on iOS".

Install

Claude Code

Add the marketplace and install the plugin:

claude plugin marketplace add AccessibilityTools/iOSAccessibilitySkill
claude plugin install ios-accessibility@accessibility-tools

Restart Claude Code or run /reload-plugins in an active session. The commands are namespaced under ios-accessibility, for example:

/ios-accessibility:accessibility review accessibility on ProfileScreen

Cursor

Add the repository as a marketplace:

cursor-agent plugin marketplace add https://github.com/AccessibilityTools/iOSAccessibilitySkill

Run cursor-agent, enter /plugin, open the Marketplace tab, and install ios-accessibility. Cursor discovers the skills automatically; ask the Agent to review a screen or invoke a skill such as /accessibility.

Codex

Add the marketplace and install the plugin:

codex plugin marketplace add AccessibilityTools/iOSAccessibilitySkill
codex plugin add ios-accessibility@accessibility-tools

Start a new task and ask Codex to review an iOS screen, or invoke $ios-accessibility:accessibility directly.

ChatGPT

Add the marketplace from a terminal:

codex plugin marketplace add AccessibilityTools/iOSAccessibilitySkill

Restart the ChatGPT desktop app, open the Plugins Directory, select Personal, and install ios-accessibility. ChatGPT and Codex use the same plugin package.

Update

Claude Code

Refresh the marketplace and update the plugin:

claude plugin marketplace update accessibility-tools
claude plugin update ios-accessibility@accessibility-tools

Restart Claude Code or run /reload-plugins to use the updated commands.

Cursor

Refresh the marketplace:

cursor-agent plugin marketplace update accessibility-tools

Then run /plugin and update or reinstall ios-accessibility from the Installed tab. Cursor does not currently provide a non-interactive plugin install command.

Codex and ChatGPT

Refresh the marketplace and reinstall the plugin:

codex plugin marketplace upgrade accessibility-tools
codex plugin add ios-accessibility@accessibility-tools

Start a new Codex task or restart the ChatGPT desktop app to load the updated skills.

Skills

/ios-accessibility:accessibility — Review a screen (main entrance)

The main entry point. Ask it to review accessibility on a screen — e.g. /ios-accessibility:accessibility review accessibility on ProfileScreen — and it audits the screen against the rules, applies fixes, and delegates cells/carousels/Dynamic Type to the focused skills below. Also covers VoiceOver, Voice Control, Switch Control, and overall accessibility for UIKit and SwiftUI:

• accessibilityLabel, accessibilityValue, accessibilityTraits, and accessibilityHint
• Element grouping, containers, and focus order control
• Adjustable elements and custom actions
• Speech customization (pronunciation, language, pitch)
• Navigation: notifications, modals, scrub gesture, magic tap, custom rotors
• Color contrast, Smart Invert, reduce motion
• Drag and drop accessibility
• System accessibility settings to respect
• Testing strategies (manual, automated, snapshot tests)

/ios-accessibility:accessibility-cell — Cell Accessibility

Focused skill for list / table / collection cells — turn a multi-view row into one well-structured element:

• One element per cell (.combine / .ignore / isAccessibilityElement)
• Label = main content, value = additional content
• Hard-to-read values (addresses, ids, timestamps) → accessibilityCustomContent (spoken on demand)
• All button actions → accessibility actions (primary activation + named custom actions)
• Input labels with alternatives and synonyms for Voice Control
• Hiding decorative avatars / icons / chevrons

/ios-accessibility:accessibility-carousel — Carousel Accessibility

Focused skill for horizontally paged banners, card decks, galleries, and onboarding pagers:

• Adjustable-control vs container-of-pages model
• Announcing position ("page X of N") and page changes
• Hiding off-screen pages, accessibilityScroll paging (UIKit)
• Pausing autoplay under VoiceOver / Switch Control / Reduce Motion

/ios-accessibility:accessibility-dynamic-type — Dynamic Type

Dedicated skill for text scaling and adaptive layout:

• System and custom font scaling (UIFontMetrics, @ScaledMetric)
• Adaptive layout (switching axis at accessibility sizes)
• Self-sizing cells and containers
• Large Content Viewer for fixed controls
• Bold text support
• Limiting Dynamic Type when needed
• Testing and verification

Usage

Open your iOS project and use a plugin command with any prompt. Cursor uses the skill name without a namespace. Codex uses the $ios-accessibility: namespace. ChatGPT discovers the matching skill from the request.

/ios-accessibility:accessibility review accessibility on ProfileScreen
/ios-accessibility:accessibility Review this file for accessibility issues
/ios-accessibility:accessibility-cell Make this recipient row read as one VoiceOver element
/ios-accessibility:accessibility-cell Move the hard-to-read values in this cell into custom content
/ios-accessibility:accessibility-dynamic-type Add Dynamic Type support to this view
/ios-accessibility:accessibility How should I make this custom slider accessible?
/ios-accessibility:accessibility Review the current screen and suggest grouping improvements

Example workflows

Review a specific file:

/ios-accessibility:accessibility Review Sources/Views/MenuCell.swift for accessibility

Make a screen accessible step by step:

/ios-accessibility:accessibility Walk me through making the checkout screen fully accessible

Adapt a cell:

/ios-accessibility:accessibility-cell Turn OrderCell into one element: label, value, custom content, actions

Fix a specific issue:

/ios-accessibility:accessibility The VoiceOver focus order is wrong on the product detail screen

Generate tests:

/ios-accessibility:accessibility Write accessibility snapshot tests for OrderCell

Auto-apply to every screen (CLAUDE.md rules)

To make Claude automatically check accessibility on every screen you work on, add a CLAUDE.md file to your iOS project root. CLAUDE.md contains instructions Claude Code reads on every conversation.

Basic rule

Create a CLAUDE.md in your project root with:

## Accessibility
When creating or modifying any UIView, UIViewController, or SwiftUI View:
- Run /ios-accessibility:accessibility to review the accessibility of the changed code
- Ensure every interactive element has accessibilityLabel and appropriate traits
- Ensure decorative images are hidden from VoiceOver
- Run /ios-accessibility:accessibility-dynamic-type to review Dynamic Type support
- Ensure Dynamic Type is supported (no fixed heights, use dynamic fonts)

Comprehensive rule

For stricter enforcement:

## Accessibility Requirements
Every UI change MUST pass these checks before being considered complete:
1.**Labels**: Every interactive element has `accessibilityLabel` and appropriate `accessibilityTraits`2.**Grouping**: Related elements are combined (`.accessibilityElement(children: .combine)` in SwiftUI, or `isAccessibilityElement = true` with combined label in UIKit)
3.**Decorative elements**: Hidden from VoiceOver (`isAccessibilityElement = false` / `.accessibilityHidden(true)`)
4.**Dynamic Type**: No fixed heights, use `UIFont.preferredFont(forTextStyle:)` or `.font(.body)`, support `.isAccessibilityCategory` layout changes
5.**Navigation**: Headers marked with `.header` trait, modals set `accessibilityViewIsModal = true`, custom views implement `accessibilityPerformEscape()`6.**State changes**: Dynamic content posts `UIAccessibility.post(notification:)` appropriately
7.**System settings**: Respect `isReduceMotionEnabled`, `shouldDifferentiateWithoutColor`, `isBoldTextEnabled`, and other accessibility preferences
When writing or reviewing UI code, use /ios-accessibility:accessibility and /ios-accessibility:accessibility-dynamic-type to verify compliance.

Per-screen rule (for new features)

You can also scope the rule to specific features:

## Current Sprint: Checkout Redesign
All views in `Sources/Checkout/` must be fully accessible.
Before marking any task as done, run `/ios-accessibility:accessibility Review {filename} for accessibility issues` on every changed view file.

How the skills work

Each skill is a Markdown file that Claude Code and Cursor load when you invoke it or ask for matching work. They contain structured knowledge about iOS accessibility APIs, patterns, and best practices that the agent uses to give accurate, specific advice.

The $ARGUMENTS placeholder at the end of each file is replaced with whatever you type after the command.

File	Command	Focus
plugins/ios-accessibility/skills/accessibility/SKILL.md	/ios-accessibility:accessibility	VoiceOver, Voice Control, Switch Control, general accessibility
plugins/ios-accessibility/skills/accessibility-cell/SKILL.md	/ios-accessibility:accessibility-cell	Cell accessibility: label/value/custom-content/actions/input-labels
plugins/ios-accessibility/skills/accessibility-carousel/SKILL.md	/ios-accessibility:accessibility-carousel	Carousel accessibility: paging model, position, autoplay
plugins/ios-accessibility/skills/accessibility-dynamic-type/SKILL.md	/ios-accessibility:accessibility-dynamic-type	Font scaling, adaptive layout, Large Content Viewer

License

The accessibility knowledge is based on the book "About Accessibility on iOS" by Mikhail Rubanov.