Skip to content
Back to search

swift-accessibility-skill

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

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/pasqualevittoriosi--swift-accessibility-skill/badge.svg)](/listings/pasqualevittoriosi--swift-accessibility-skill)

HTML

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

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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](https://antigravity.google/docs/skills) | | Gemini CLI | `.gemini/skills/` | `~/.gemini/skills/` | [Gemini CLI Skills](https://geminicli.com/docs/cli/skills/) | | GitHub Copilot | `.github/skills/` | `~/.copilot/skills/` | [Copilot Skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) | | OpenCode | `.opencode/skills/` | `~/.config/opencode/skills/` | [OpenCode Skills](https://opencode.ai/docs/skills) | | Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` | [Windsurf Skills](https://docs.windsurf.com/windsurf/cascade/skills) |

---

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.

.claude-plugin/marketplace.json · Manifest · 54 lines

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

  1. {
  2. "name": "swift-accessibility-skill",
  3. "owner": {
  4. "name": "Pasquale Vittoriosi"
  5. },
  6. "metadata": {
  7. "description": "Platform accessibility guidance for SwiftUI, UIKit, and AppKit UI tasks and audits.",
  8. "version": "0.2.0"
  9. },
  10. "plugins": [
  11. {
  12. "name": "swift-accessibility-skill",
  13. "source": "./",
  14. "description": "Platform accessibility guidance for SwiftUI, UIKit, and AppKit, including all 9 App Store Accessibility Nutrition Label categories.",
  15. "version": "0.2.0",
  16. "author": {
  17. "name": "Pasquale Vittoriosi"
  18. },
  19. "repository": "https://github.com/PasqualeVittoriosi/swift-accessibility-skill",
  20. "license": "MIT",
  21. "category": "accessibility",
  22. "tags": [
  23. "accessibility",
  24. "a11y",
  25. "voiceover",
  26. "screen-reader",
  27. "dynamic-type",
  28. "voice-control",
  29. "switch-control",
  30. "wcag",
  31. "nutrition-labels",
  32. "swiftui",
  33. "uikit",
  34. "appkit",
  35. "ios",
  36. "macos",
  37. "watchos",
  38. "tvos",
  39. "visionos"
  40. ],
  41. "keywords": [
  42. "swift",
  43. "swiftui",
  44. "uikit",
  45. "appkit",
  46. "accessibility",
  47. "a11y",
  48. "voiceover",
  49. "wcag",
  50. "nutrition-labels"
  51. ]
  52. }
  53. ]
  54. }
README.md · README · 157 lines

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

  1. ![Swift Accessibility Skill Cover](assets/cover.svg)
  2. # Swift Accessibility Skill
  3. An Agent Skill that makes accessibility a first-class part of **SwiftUI**, **UIKit**, and **AppKit** development.
  4. Covers all **9 App Store Accessibility Nutrition Labels** across iOS, macOS, watchOS, tvOS, and visionOS.
  5. Works with Claude, Codex, Cursor, and any tool that supports the Agent Skills standard.
  6. ---
  7. ## What it does
  8. | Mode | Behavior |
  9. |---|---|
  10. | **Writing code** | Applies accessibility silently as you build. Inferred labels marked `[VERIFY]`. Compact summary after each generation. |
  11. | **Auditing code** | Structured report: severity levels, device testing checklist, Nutrition Label readiness. |
  12. | **Nutrition Labels** | Prepares App Store Accessibility Nutrition Label recommendations with pass/fail criteria for all 9 labels, support reasons, and blocked-label reasons. |
  13. ---
  14. ## Installation
  15. ### Claude Code
  16. **Install with `marketplace` (recommended):**
  17. ```bash
  18. /plugin marketplace add PasqualeVittoriosi/swift-accessibility-skill
  19. /plugin install swift-accessibility-skill@swift-accessibility-skill
  20. ```
  21. **Manual install:**
  22. - User-wide: copy the `swift-accessibility-skill/` folder into `~/.claude/skills/`
  23. - Project-local: copy the `swift-accessibility-skill/` folder into `.claude/skills/`
  24. Add a memory reference in:
  25. - Project: `./CLAUDE.md`
  26. - User-wide: `~/.claude/CLAUDE.md`
  27. by adding:
  28. ```md
  29. # Accessibility
  30. - Use `swift-accessibility-skill@swift-accessibility-skill` for SwiftUI/UIKit/AppKit accessibility implementation and audits.
  31. ```
  32. ### Codex
  33. **Install with `skill-installer` (recommended):**
  34. In Codex, ask it to run:
  35. ```text
  36. $skill-installer install https://github.com/PasqualeVittoriosi/swift-accessibility-skill with --path . --name swift-accessibility-skill
  37. ```
  38. Restart Codex to pick up the new skill.
  39. **Manual install:**
  40. - User-wide: copy the `swift-accessibility-skill/` folder into `~/.codex/skills/`
  41. - Project-level: copy the `swift-accessibility-skill/` folder into `.codex/skills/`
  42. ### Cursor
  43. **Manual install:**
  44. - User-wide: copy the `swift-accessibility-skill/` folder into `~/.cursor/skills/`
  45. - Project-local: copy the `swift-accessibility-skill/` folder into `.cursor/skills/`
  46. ### Install locations for other tools
  47. 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.
  48. | Tool | Project path | Global path | Official docs |
  49. |---|---|---|---|
  50. | Antigravity | `.agent/skills/` | `~/.gemini/antigravity/skills/` | [Antigravity Skills](https://antigravity.google/docs/skills) |
  51. | Gemini CLI | `.gemini/skills/` | `~/.gemini/skills/` | [Gemini CLI Skills](https://geminicli.com/docs/cli/skills/) |
  52. | GitHub Copilot | `.github/skills/` | `~/.copilot/skills/` | [Copilot Skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) |
  53. | OpenCode | `.opencode/skills/` | `~/.config/opencode/skills/` | [OpenCode Skills](https://opencode.ai/docs/skills) |
  54. | Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` | [Windsurf Skills](https://docs.windsurf.com/windsurf/cascade/skills) |
  55. ---
  56. ## Usage
  57. The skill **auto-activates** on any SwiftUI, UIKit, or AppKit code. No slash command needed.
  58. 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`
  59. **Explicit:** `/swift-accessibility-skill`
  60. **Audit:** _"Audit this view for accessibility"_ · _"How accessible is this code?"_ · _"Review the accessibility of MyAmazingView"_
  61. ---
  62. ## Coverage
  63. ### App Store Nutrition Labels
  64. | Label | Reference |
  65. |---|---|
  66. | VoiceOver | `voiceover-swiftui.md` · `voiceover-uikit.md` |
  67. | Voice Control | `voice-control.md` |
  68. | Larger Text | `dynamic-type.md` |
  69. | Dark Interface | `display-settings.md` |
  70. | Differentiate Without Color | `display-settings.md` |
  71. | Sufficient Contrast | `display-settings.md` |
  72. | Reduced Motion | `display-settings.md` |
  73. | Captions | `media-accessibility.md` |
  74. | Audio Descriptions | `media-accessibility.md` |
  75. ### Also covers
  76. Switch Control · Full Keyboard Access · AssistiveTouch · Semantic structure · Focus management · Custom rotors · Assistive Access (iOS 17+) · macOS NSAccessibility · watchOS · tvOS Focus Engine · visionOS
  77. ### Skill structure
  78. ```
  79. swift-accessibility-skill/
  80. ├── SKILL.md # Main skill instructions
  81. ├── references/ # API docs, code examples, common mistakes
  82. │ ├── voiceover-swiftui.md
  83. │ ├── voiceover-uikit.md
  84. │ ├── voice-control.md
  85. │ ├── dynamic-type.md
  86. │ ├── display-settings.md
  87. │ ├── semantic-structure.md
  88. │ ├── media-accessibility.md
  89. │ ├── motor-input.md
  90. │ ├── nutrition-labels.md
  91. │ ├── assistive-access.md
  92. │ ├── platform-specifics.md
  93. │ ├── testing-auditing.md
  94. │ └── wcag-mapping.md
  95. ├── examples/ # Before/after code
  96. │ ├── before-after-swiftui.md
  97. │ ├── before-after-uikit.md
  98. │ └── before-after-appkit.md
  99. └── resources/ # Reusable templates & checklists
  100. ├── audit-template.swift
  101. └── qa-checklist.md
  102. ```
  103. ---
  104. ## Contributing
  105. See [CONTRIBUTING.md](CONTRIBUTING.md).
  106. ## License
  107. MIT — see [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

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