swift-accessibility-agent

Category: Databases & Storage | Uploader: SerialForBreakfast | Downloads: 0 | Version: v1.0（Latest）

Use this skill when reviewing or updating SwiftUI, UIKit, tvOS, macOS, or visionOS UI for accessibility. It selects platform-specific guidance, preserves accessibility semantics, and outputs citations plus verification steps.

Changelog: Source: GitHub https://github.com/SerialForBreakfast/SwiftAccessibilityAgent

Directory Structure

Current level: Root

📁 agents/
- 📄 openai.yaml 295 B
📁 docs/
- 📁 core/
  - 📁 architecture/
    
    📄 architecture-principles.md 3.1 KB
  - 📁 cookbook/
    
    📄 semantics-cookbook.md 1.3 KB
  - 📁 sources/
    
    📄 registry.md 16.9 KB
  - 📁 taxonomy/
    
    📄 semantics-checklist.md 3.3 KB
  - 📁 templates/
    
    📄 component-contract-template.md 835 B
    
    📄 guideline-template.md 1.4 KB
    
    📄 interop-boundary-contract-template.md 726 B
  - 📄 decision-matrix.md 4.0 KB
  - 📄 external-landscape.md 3.9 KB
  - 📄 known-os-issues-index.json 3.9 KB
  - 📄 known-os-issues-workflow.md 1.6 KB
  - 📄 known-os-issues.md 9.6 KB
  - 📄 pattern-review-rubric.md 3.2 KB
  - 📄 technology-map.md 5.8 KB
  - 📄 version-matrix.md 1.7 KB
- 📁 macos/
  - 📁 guidelines/
    
    📄 m-001-nsaccessibility-roles-labels-values-actions.md 2.6 KB
    
    📄 m-002-keyboard-focus-order.md 2.7 KB
    
    📄 m-003-grouping-hierarchy-desktop-layouts.md 2.2 KB
    
    📄 m-004-announcements-state-change-notifications.md 2.4 KB
    
    📄 m-005-swiftui-appkit-interop-forwarding.md 2.4 KB
    
    📄 m-006-table-outline-list-semantics.md 2.6 KB
    
    📄 m-007-modal-window-focus-containment.md 2.9 KB
    
    📄 m-008-voice-control-naming-disambiguation.md 2.4 KB
    
    📄 m-009-contrast-reduced-transparency.md 2.6 KB
    
    📄 m-010-testing-workflow.md 2.8 KB
    
    📄 topic-backlog.md 2.7 KB
  - 📄 README.md 705 B
- 📁 swiftui/
  - 📁 guidelines/
    
    📄 g-001-labels-meaningful-names.md 2.5 KB
    
    📄 g-002-hints-when-to-use.md 2.2 KB
    
    📄 g-003-values-stateful-controls.md 2.4 KB
    
    📄 g-004-traits-roles.md 2.5 KB
    
    📄 g-005-grouping-containment.md 2.6 KB
    
    📄 g-006-focus-reading-order.md 2.5 KB
    
    📄 g-007-accessibility-actions.md 2.2 KB
    
    📄 g-008-custom-controls-representation.md 2.4 KB
    
    📄 g-009-rotors-when-and-why.md 3.4 KB
    
    📄 g-010-dynamic-type-layout-resilience.md 2.4 KB
    
    📄 g-011-color-contrast-non-color-cues.md 2.3 KB
    
    📄 g-012-reduced-motion.md 2.2 KB
    
    📄 g-013-modal-sheet-focus-containment.md 2.5 KB
    
    📄 g-014-lists-forms-complex-rows.md 2.4 KB
    
    📄 g-015-media-captions-audio-descriptions.md 3.0 KB
    
    📄 topic-backlog.md 3.9 KB
  - 📄 README.md 568 B
- 📁 testing/
  - 📄 inspector-audit-checklist.md 4.3 KB
  - 📄 macos-manual-test-scripts.md 2.3 KB
  - 📄 manual-test-scripts.md 3.4 KB
  - 📄 platform-coverage-matrix.md 1.3 KB
  - 📄 regression-triage-playbook.md 1.7 KB
  - 📄 tvos-manual-test-scripts.md 2.4 KB
  - 📄 xcuitest-hooks.md 2.5 KB
- 📁 tvos/
  - 📁 guidelines/
    
    📄 t-001-focus-order-directional-navigation.md 2.7 KB
    
    📄 t-002-initial-focus-modal-restoration.md 2.8 KB
    
    📄 t-003-labels-values-traits-focused-controls.md 2.5 KB
    
    📄 t-004-grouping-containment-shelves-grids.md 2.3 KB
    
    📄 t-005-custom-actions-remote-first.md 2.2 KB
    
    📄 t-006-search-filter-collection-semantics.md 2.3 KB
    
    📄 t-007-media-playback-controls.md 3.3 KB
    
    📄 t-008-reduce-motion-focus-animations.md 2.5 KB
    
    📄 t-009-contrast-non-color-cues.md 2.4 KB
    
    📄 t-010-xcuitest-focus-regression-hooks.md 2.2 KB
    
    📄 topic-backlog.md 2.6 KB
  - 📄 README.md 654 B
- 📁 uikit/
  - 📁 guidelines/
    
    📄 topic-backlog.md 3.3 KB
    
    📄 u-001-labels-meaningful-names.md 2.3 KB
    
    📄 u-002-hints-when-to-use.md 2.0 KB
    
    📄 u-003-values-stateful-controls.md 2.2 KB
    
    📄 u-004-traits-roles.md 2.1 KB
    
    📄 u-005-grouping-containment.md 2.2 KB
    
    📄 u-006-focus-reading-order.md 2.2 KB
    
    📄 u-007-accessibility-custom-actions.md 2.0 KB
    
    📄 u-008-custom-controls-semantic-equivalence.md 2.0 KB
    
    📄 u-009-rotor-friendly-structure.md 3.1 KB
    
    📄 u-010-dynamic-type-layout-resilience.md 2.3 KB
    
    📄 u-011-color-contrast-non-color-cues.md 2.1 KB
    
    📄 u-012-reduced-motion.md 2.0 KB
    
    📄 u-013-modal-focus-containment.md 2.2 KB
    
    📄 u-014-table-collection-form-semantics.md 2.2 KB
    
    📄 u-015-media-captions-descriptions-controls.md 2.9 KB
  - 📄 README.md 576 B
- 📁 visionos/
  - 📁 guidelines/
    
    📄 topic-backlog.md 2.3 KB
  - 📄 README.md 602 B
- 📄 changelog.md 11.5 KB
📁 references/
- 📁 core/
  - 📁 architecture/
    
    📄 architecture-principles.md 3.1 KB
  - 📁 cookbook/
    
    📄 semantics-cookbook.md 1.3 KB
  - 📁 sources/
    
    📄 registry.md 16.9 KB
  - 📁 taxonomy/
    
    📄 semantics-checklist.md 3.3 KB
  - 📁 templates/
    
    📄 component-contract-template.md 835 B
    
    📄 guideline-template.md 1.4 KB
    
    📄 interop-boundary-contract-template.md 726 B
  - 📄 decision-matrix.md 4.0 KB
  - 📄 external-landscape.md 3.9 KB
  - 📄 known-os-issues-index.json 3.9 KB
  - 📄 known-os-issues-workflow.md 1.6 KB
  - 📄 known-os-issues.md 9.6 KB
  - 📄 pattern-review-rubric.md 3.2 KB
  - 📄 technology-map.md 5.8 KB
  - 📄 version-matrix.md 1.7 KB
- 📁 macos/
  - 📁 guidelines/
    
    📄 m-001-nsaccessibility-roles-labels-values-actions.md 2.6 KB
    
    📄 m-002-keyboard-focus-order.md 2.7 KB
    
    📄 m-003-grouping-hierarchy-desktop-layouts.md 2.2 KB
    
    📄 m-004-announcements-state-change-notifications.md 2.4 KB
    
    📄 m-005-swiftui-appkit-interop-forwarding.md 2.4 KB
    
    📄 m-006-table-outline-list-semantics.md 2.6 KB
    
    📄 m-007-modal-window-focus-containment.md 2.9 KB
    
    📄 m-008-voice-control-naming-disambiguation.md 2.4 KB
    
    📄 m-009-contrast-reduced-transparency.md 2.6 KB
    
    📄 m-010-testing-workflow.md 2.8 KB
    
    📄 topic-backlog.md 2.7 KB
  - 📄 README.md 705 B
- 📁 manifests/
  - 📄 axes.json 554 B
  - 📄 core.json 640 B
  - 📄 decision-rules.json 1.6 KB
  - 📄 pattern-signals.json 1.0 KB
  - 📄 platform-presets.json 758 B
  - 📄 README.md 1.0 KB
  - 📄 routes.json 2.1 KB
  - 📄 security-policy.json 690 B
  - 📄 select-example.json 1.9 KB
  - 📄 task-presets.json 2.6 KB
- 📁 swiftui/
  - 📁 guidelines/
    
    📄 g-001-labels-meaningful-names.md 2.5 KB
    
    📄 g-002-hints-when-to-use.md 2.2 KB
    
    📄 g-003-values-stateful-controls.md 2.4 KB
    
    📄 g-004-traits-roles.md 2.5 KB
    
    📄 g-005-grouping-containment.md 2.6 KB
    
    📄 g-006-focus-reading-order.md 2.5 KB
    
    📄 g-007-accessibility-actions.md 2.2 KB
    
    📄 g-008-custom-controls-representation.md 2.4 KB
    
    📄 g-009-rotors-when-and-why.md 3.4 KB
    
    📄 g-010-dynamic-type-layout-resilience.md 2.4 KB
    
    📄 g-011-color-contrast-non-color-cues.md 2.3 KB
    
    📄 g-012-reduced-motion.md 2.2 KB
    
    📄 g-013-modal-sheet-focus-containment.md 2.5 KB
    
    📄 g-014-lists-forms-complex-rows.md 2.4 KB
    
    📄 g-015-media-captions-audio-descriptions.md 3.0 KB
    
    📄 topic-backlog.md 3.9 KB
  - 📄 README.md 568 B
- 📁 testing/
  - 📄 inspector-audit-checklist.md 4.3 KB
  - 📄 macos-manual-test-scripts.md 2.3 KB
  - 📄 manual-test-scripts.md 3.4 KB
  - 📄 platform-coverage-matrix.md 1.3 KB
  - 📄 regression-triage-playbook.md 1.7 KB
  - 📄 tvos-manual-test-scripts.md 2.4 KB
  - 📄 xcuitest-hooks.md 2.5 KB
- 📁 tvos/
  - 📁 guidelines/
    
    📄 t-001-focus-order-directional-navigation.md 2.7 KB
    
    📄 t-002-initial-focus-modal-restoration.md 2.8 KB
    
    📄 t-003-labels-values-traits-focused-controls.md 2.5 KB
    
    📄 t-004-grouping-containment-shelves-grids.md 2.3 KB
    
    📄 t-005-custom-actions-remote-first.md 2.2 KB
    
    📄 t-006-search-filter-collection-semantics.md 2.3 KB
    
    📄 t-007-media-playback-controls.md 3.3 KB
    
    📄 t-008-reduce-motion-focus-animations.md 2.5 KB
    
    📄 t-009-contrast-non-color-cues.md 2.4 KB
    
    📄 t-010-xcuitest-focus-regression-hooks.md 2.2 KB
    
    📄 topic-backlog.md 2.6 KB
  - 📄 README.md 654 B
- 📁 uikit/
  - 📁 guidelines/
    
    📄 topic-backlog.md 3.3 KB
    
    📄 u-001-labels-meaningful-names.md 2.3 KB
    
    📄 u-002-hints-when-to-use.md 2.0 KB
    
    📄 u-003-values-stateful-controls.md 2.2 KB
    
    📄 u-004-traits-roles.md 2.1 KB
    
    📄 u-005-grouping-containment.md 2.2 KB
    
    📄 u-006-focus-reading-order.md 2.2 KB
    
    📄 u-007-accessibility-custom-actions.md 2.0 KB
    
    📄 u-008-custom-controls-semantic-equivalence.md 2.0 KB
    
    📄 u-009-rotor-friendly-structure.md 3.1 KB
    
    📄 u-010-dynamic-type-layout-resilience.md 2.3 KB
    
    📄 u-011-color-contrast-non-color-cues.md 2.1 KB
    
    📄 u-012-reduced-motion.md 2.0 KB
    
    📄 u-013-modal-focus-containment.md 2.2 KB
    
    📄 u-014-table-collection-form-semantics.md 2.2 KB
    
    📄 u-015-media-captions-descriptions-controls.md 2.9 KB
  - 📄 README.md 576 B
- 📁 visionos/
  - 📁 guidelines/
    
    📄 topic-backlog.md 2.3 KB
  - 📄 README.md 602 B
- 📄 README.md 581 B
📁 skill/
- 📁 manifests/
  - 📄 axes.json 554 B
  - 📄 core.json 640 B
  - 📄 decision-rules.json 1.6 KB
  - 📄 pattern-signals.json 1.0 KB
  - 📄 platform-presets.json 758 B
  - 📄 README.md 1.0 KB
  - 📄 routes.json 2.1 KB
  - 📄 security-policy.json 690 B
  - 📄 select-example.json 1.9 KB
  - 📄 task-presets.json 2.6 KB
📄 .gitattributes 66 B
📄 .gitignore 19 B
📄 AGENT.md 2.5 KB
📄 CHANGELOG.md 10.7 KB
📄 README.md 5.7 KB
📄 SKILL.md 3.2 KB
📄 Tasks.txt 15.7 KB

SKILL.md

---
name: swift-accessibility-agent
description: Use this skill when reviewing or updating SwiftUI, UIKit, tvOS, macOS, or visionOS UI for accessibility. It selects platform-specific guidance, preserves accessibility semantics, and outputs citations plus verification steps.
---

# Swift Accessibility Agent

## Use This Skill For

- Accessibility review of Apple-platform UI.
- Accessibility-aware implementation updates.
- Platform/framework-specific guidance selection.

## Task Workflows

### Review Existing Accessibility Implementation

1. Identify the changed UI surface and platform/framework.
2. Load one backlog file for that surface.
3. Load one or two matching guideline files.
4. Output findings with guideline IDs, citation IDs, and verification steps.

### Improve Existing UI Accessibility

1. Load the matching backlog and current guideline file(s).
2. Propose concrete semantic fixes (label/value/hint/role/actions).
3. Include rationale tied to Tier-1 citations.
4. Provide verification plan (Inspector + manual flow; optional XCUITest hook).

### Implement New Accessible UI

1. Select guideline topics before implementation.
2. Prefer native controls and explicit semantics.
3. Include interop ownership notes for mixed stacks.
4. Return implementation plus verification expectations.

## Internal Routing (As Needed)

Load these only when task scope is ambiguous or multi-platform:

1. `references/manifests/security-policy.json`
2. `references/manifests/axes.json`
3. `references/manifests/core.json`
4. `references/manifests/routes.json`

## Then Select

- Platform: `ios`, `tvos`, `macos`, `visionos`
- Framework: `swiftui`, `uikit`, `appkit`, or mixed interop
- Task type: implement, review, triage, or guideline authoring

## Load Only What Is Needed

After route selection, load only:

1. One platform backlog:
   - `references/swiftui/guidelines/topic-backlog.md`
   - `references/uikit/guidelines/topic-backlog.md`
   - `references/tvos/guidelines/topic-backlog.md`
   - `references/macos/guidelines/topic-backlog.md`
   - `references/visionos/guidelines/topic-backlog.md`
2. One or two topic guideline files tied to the task.
3. Required testing docs:
   - `references/testing/inspector-audit-checklist.md`
   - `references/testing/manual-test-scripts.md` (or platform equivalent)
   - `references/testing/xcuitest-hooks.md` when automation is relevant
4. Core references only when needed:
   - `references/core/sources/registry.md`
   - `references/core/taxonomy/semantics-checklist.md`
   - `references/core/templates/guideline-template.md`

## Operating Rules

1. Treat Tier-1 Apple sources as platform truth.
2. Keep semantics explicit for interactive UI:
   - label
   - value
   - hint
   - role/traits
   - actions
3. Prefer native controls and document interop ownership when mixed frameworks are used.
4. Keep guidance testable with concrete verification steps.

## Output Requirements

For review tasks:

- Findings or confirmations tied to guideline IDs.
- Rationale with citation IDs.
- Verification steps (Inspector + manual flow; optional XCUITest hook).

For implementation tasks:

- Concrete code or content changes.
- Why the change aligns with selected guideline(s).
- Verification plan with expected outcomes.

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

swift-accessibility-agent

Directory Structure

SKILL.md

Report

Notice