Swift Accessibility Skill
An Agent Skill that makes accessibility a first-class part of SwiftUI, UIKit, and AppKit development.
Covers all 9 App Store Accessibility Nutrition Labels across iOS, macOS, watchOS, tvOS, and visionOS.
Works with Claude, Codex, Cursor, and any tool that supports the Agent Skills standard.
What it does
| Mode | Behavior |
|---|
| Writing code | Applies accessibility silently as you build. Inferred labels marked [VERIFY]. Compact summary after each generation. |
| Auditing code | Structured report: severity levels, device testing checklist, Nutrition Label readiness. |
| Nutrition Labels | Prepares App Store Accessibility Nutrition Label recommendations with pass/fail criteria for all 9 labels, support reasons, and blocked-label reasons. |
Installation
Claude Code
Install with marketplace (recommended):
/plugin marketplace add PasqualeVittoriosi/swift-accessibility-skill
/plugin install swift-accessibility-skill@swift-accessibility-skill
Manual install:
- User-wide: copy the
swift-accessibility-skill/ folder into ~/.claude/skills/
- Project-local: copy the
swift-accessibility-skill/ folder into .claude/skills/
Add a memory reference in:
- Project:
./CLAUDE.md
- User-wide:
~/.claude/CLAUDE.md
by adding:
# Accessibility
- Use `swift-accessibility-skill@swift-accessibility-skill` for SwiftUI/UIKit/AppKit accessibility implementation and audits.
Codex
Install with skill-installer (recommended):
In Codex, ask it to run:
$skill-installer install https://github.com/PasqualeVittoriosi/swift-accessibility-skill with --path . --name swift-accessibility-skill
Restart Codex to pick up the new skill.
Manual install:
- User-wide: copy the
swift-accessibility-skill/ folder into ~/.codex/skills/
- Project-level: copy the
swift-accessibility-skill/ folder into .codex/skills/
Cursor
Manual install:
- User-wide: copy the
swift-accessibility-skill/ folder into ~/.cursor/skills/
- Project-local: copy the
swift-accessibility-skill/ folder into .cursor/skills/
Install locations for other tools
These are the current docs-backed install locations I could verify. In each case, place the swift-accessibility-skill/ folder inside that tool's skills directory.
Usage
The skill auto-activates on any SwiftUI, UIKit, or AppKit code. No slash command needed.
Also triggers on: VoiceOver · Voice Control · Dynamic Type · Reduce Motion · screen reader · a11y · WCAG · accessibility audit · Nutrition Label · accessibilityLabel · UIAccessibility · NSAccessibility · assistive technologies · Switch Control
Explicit: /swift-accessibility-skill
Audit: "Audit this view for accessibility" · "How accessible is this code?" · "Review the accessibility of MyAmazingView"
Coverage
App Store Nutrition Labels
| Label | Reference |
|---|
| VoiceOver | voiceover-swiftui.md · voiceover-uikit.md |
| Voice Control | voice-control.md |
| Larger Text | dynamic-type.md |
| Dark Interface | display-settings.md |
| Differentiate Without Color | display-settings.md |
| Sufficient Contrast | display-settings.md |
| Reduced Motion | display-settings.md |
| Captions | media-accessibility.md |
| Audio Descriptions | media-accessibility.md |
Also covers
Switch Control · Full Keyboard Access · AssistiveTouch · Semantic structure · Focus management · Custom rotors · Assistive Access (iOS 17+) · macOS NSAccessibility · watchOS · tvOS Focus Engine · visionOS
Skill structure