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.
| Tool | Project path | Global path | Official docs |
|---|---|---|---|
| Antigravity | .agent/skills/ | ~/.gemini/antigravity/skills/ | Antigravity Skills |
| Gemini CLI | .gemini/skills/ | ~/.gemini/skills/ | Gemini CLI Skills |
| GitHub Copilot | .github/skills/ | ~/.copilot/skills/ | Copilot Skills |
| OpenCode | .opencode/skills/ | ~/.config/opencode/skills/ | OpenCode Skills |
| Windsurf | .windsurf/skills/ | ~/.codeium/windsurf/skills/ | Windsurf Skills |
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