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.
Badge for your README
Markdown
[](/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
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)
- {
- "name": "swift-accessibility-skill",
- "owner": {
- "name": "Pasquale Vittoriosi"
- },
- "metadata": {
- "description": "Platform accessibility guidance for SwiftUI, UIKit, and AppKit UI tasks and audits.",
- "version": "0.2.0"
- },
- "plugins": [
- {
- "name": "swift-accessibility-skill",
- "source": "./",
- "description": "Platform accessibility guidance for SwiftUI, UIKit, and AppKit, including all 9 App Store Accessibility Nutrition Label categories.",
- "version": "0.2.0",
- "author": {
- "name": "Pasquale Vittoriosi"
- },
- "repository": "https://github.com/PasqualeVittoriosi/swift-accessibility-skill",
- "license": "MIT",
- "category": "accessibility",
- "tags": [
- "accessibility",
- "a11y",
- "voiceover",
- "screen-reader",
- "dynamic-type",
- "voice-control",
- "switch-control",
- "wcag",
- "nutrition-labels",
- "swiftui",
- "uikit",
- "appkit",
- "ios",
- "macos",
- "watchos",
- "tvos",
- "visionos"
- ],
- "keywords": [
- "swift",
- "swiftui",
- "uikit",
- "appkit",
- "accessibility",
- "a11y",
- "voiceover",
- "wcag",
- "nutrition-labels"
- ]
- }
- ]
- }
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)
- 
- # 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):**
- ```bash
- /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:
- ```md
- # 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:
- ```text
- $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) |
- ---
- ## 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](CONTRIBUTING.md).
- ## License
- MIT — see [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.