Skip to content

PasqualeVittoriosi/swift-accessibility-skill

Repository files navigation

Swift Accessibility Skill Cover

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

Skill structure

swift-accessibility-skill/
├── SKILL.md                          # Main skill instructions
├── references/                       # API docs, code examples, common mistakes
│   ├── voiceover-swiftui.md
│   ├── voiceover-uikit.md
│   ├── voice-control.md
│   ├── dynamic-type.md
│   ├── display-settings.md
│   ├── semantic-structure.md
│   ├── media-accessibility.md
│   ├── motor-input.md
│   ├── nutrition-labels.md
│   ├── assistive-access.md
│   ├── platform-specifics.md
│   ├── testing-auditing.md
│   └── wcag-mapping.md
├── examples/                         # Before/after code
│   ├── before-after-swiftui.md
│   ├── before-after-uikit.md
│   └── before-after-appkit.md
└── resources/                       # Reusable templates & checklists
    ├── audit-template.swift
    └── qa-checklist.md

Contributing

See CONTRIBUTING.md.

License

MIT — see LICENSE.

About

Agent Skill for accessibility across SwiftUI, UIKit, and AppKit. Covers all 9 App Store Nutrition Labels + WCAG 2.2.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages