Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Przegląd i audyt

ios-accessibility

/ios-accessibility

Sprawdza i poprawia dostępność aplikacji iOS: VoiceOver, Dynamic Type, etykiety, Switch Control, Voice Control i testy automatyczne.

Licencja
MIT
Ostatnia zmiana repozytorium
28.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
20
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
10
Przestarzałość

Brak sygnałów. Repozytorium zmienione 28.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Sprawdza i poprawia dostępność aplikacji iOS: VoiceOver, Dynamic Type, etykiety, Switch Control, Voice Control i testy automatyczne.

Oryginalny opis (EN)

Use when developers mention - (1) iOS accessibility, VoiceOver, Dynamic Type, or assistive technologies, (2) accessibility labels, traits, hints, or values, (3) automated accessibility testing, auditing, or manual testing, (4) Switch Control, Voice Control, or Full Keyboard Access, (5) inclusive…

Jak działa

  1. Overview
  2. The Approach
  3. Agent Behavior Contract
  4. Project Settings Intake (Evaluate Before Advising)
  5. Quick Decision Tree
  6. Quick Playbook (Start Here)
  7. Example Prompts and Expected Shape
  8. Edge Cases and Gotchas
Sekcje z nagłówków SKILL.md, w oryginale · 135 linii, 1 098 słów
Podgląd SKILL.md
---
name: ios-accessibility
description: Use when developers mention - (1) iOS accessibility, VoiceOver, Dynamic Type, or assistive technologies, (2) accessibility labels, traits, hints, or values, (3) automated accessibility testing, auditing, or manual testing, (4) Switch Control, Voice Control, or Full Keyboard Access, (5) inclusive…
---

# iOS Accessibility

## Overview

This skill provides expert guidance on iOS accessibility, covering VoiceOver, Dynamic Type, assistive technologies, inclusive design practices, and both UIKit and SwiftUI implementations. Use this skill to help developers build apps that work for everyone.

## The Approach

- **Shift-left** — Accessibility is part of the process. It needs to be considered even in prototypes or MVPs.
- **User-centric** — Accessibility is about people. Checklists help, but the goal is not checklist compliance. The goal is to offer a great experience for users with disabilities.
- **Progress over perfection** — Anytime is a good time to start. Focus on iterative and incremental improvements as you go. It goes a long way.
- **Test as you go** — Manual testing is part of development.

## Agent Behavior Contract

1. **Accessibility is non-deterministic.** Propose potential solutions in order of confidence and present with clear pros, cons, and trade-offs.
2. Before proposing fixes, identify the platform (UIKit vs SwiftUI) and the assistive technology, accessibility feature, or design consideration in context.
3. Do not recommend accessibility fixes without considering the user experience impact.
4. Prefer manual testing guidance alongside code changes, together with any automated or semi-automated solutions.
5. Cross-reference multiple assistive technologies when relevant (VoiceOver, Voice Control, Switch Control, Full Keyboard Access).

### Anti-Patterns to Avoid

- **Do not add trait names to labels** — Say "Close", not "Close button" (VoiceOver adds "button" automatically, when using the button trait)
- **Do not use `.accessibilityHidden(true)` on interactive elements** — Users won't be able to access them
- **Do not use fixed font sizes** — Always use text styles for Dynamic Type support
- **Do not use hardcoded colors for text** — Use semantic colors (`.label`, `.secondaryLabel`) for contrast and Dark Mode
- **Do not group UIKit elements without a clear combined label** — If `isAccessibilityElement = true`, set `accessibilityLabel` (and value/traits as needed).
- **Do not group SwiftUI elements without a clear combined label** — If `.accessibilityElement(children: .ignore)` is used, provide label/value/traits manually.
- **Do not add hints unless needed** — It should be clear what a component expresses, and does, by its label/value/traits. Only configure for adding extra clarity or context.
- **Do not rely on `onTapGesture` alone** — Prefer semantic controls like `Button`. If gesture handling is unavoidable, add button traits and clear labels.
- **Do not scale chrome controls with Dynamic Type** — For navigation bars, toolbars, and tab bars, prefer Large Content Viewer (iOS 13+) using [`.accessibilityShowsLargeContentViewer`](https://developer.apple.com/documentation/swiftui/view/accessibilityshowslargecontentviewer(content:)) / [`UILargeContentViewerItem`](https://developer.apple.com/documentation/uikit/uilargecontentvieweritem).

### General Guidance

**Prefer native components:** Whenever possible, use Apple's native components and customize them to your needs instead of building custom components from scratch.

**Design system first:** Whenever the project uses a design system of its own (colors, text styles, component catalog), propose changes in the design system itself so the improvement snowballs everywhere in the app using an improved component.

**Platform parity:** The same accessibility principles apply to both UIKit and SwiftUI, but APIs and implementation details differ.

## Project Settings Intake (Evaluate Before Advising)

Before providing accessibility guidance, determine:

### Project Capabilities
- **Is the project using SwiftUI, UIKit, or a mix of both?**
- **iOS deployment target** — Some APIs require specific versions:
  - iOS 13+: [Large Content Viewer (`UILargeContentViewerInteraction`)](https://developer.apple.com/documentation/uikit/uilargecontentviewerinteraction), [SF Symbols](https://developer.apple.com/sf-symbols/)
  - iOS 14+: [Switch Control action images (`UIAccessibilityCustomAction.init(name:image:actionHandler:)`)](https://developer.apple.com/documentation/uikit/uiaccessibilitycustomaction/init(name:image:actionhandler:))
  - iOS 15+: [`AccessibilityFocusState`](https://developer.apple.com/documentation/swiftui/accessibilityfocusstate), [`.accessibilityRotor`](https://developer.apple.com/documentation/swiftui/view/accessibilityrotor(_:entries:entryid:entrylabel:))
  - iOS 16+: [`.accessibilityRepresentation`](https://developer.apple.com/documentation/swiftui/view/accessibilityrepresentation(representation:)), [`.accessibilityActions { }` syntax](https://developer.apple.com/documentation/swiftui/view/accessibilityactions(content:))
  - iOS 17+: [`.sensoryFeedback`](https://developer.apple.com/documentation/swiftui/view/sensoryfeedback(_:trigger:))
- **Check minimum OS** — Look for `#available` checks and deployment target in project settings

### Project Conventions
- **Design system** — Does the project define its own design system (colors, text styles, UI component catalogue)? Propose changes in the design system when appropriate, not only per-feature.
- **Semantic colors and text styles** — Does the project use semantic colors (`.label`, `.systemBackground`) and text styles (`.preferredFont(forTextStyle:)` in UIKit, `.font(.body)` in SwiftUI) vs hardcoded values?
- **Existing accessibility patterns** — Search for `.accessibilityLabel`, `.accessibilityTraits`, etc. to match project style.
- **Localization** — Accessibility labels, values, and hints should be localized. Match the project's localization conventions.
- **UI construction** — Interface Builder (XIB/Storyboard) or code-only?
- **Custom gestures** — Identify if custom gestures need accessible alternatives.
- **Accessibility test coverage** — Existing UI tests auditing for accessibility?

### When Settings Are Unknown
If you can't determine the above, ask the developer to confirm before giving version-specific or framework-specific guidance.

## Quick Decision Tree

When a developer needs accessibility guidance, follow this decision tree:

1. **VoiceOver issues?**
   - Core concepts: Read `references/voiceover.md`
   - UIKit implementation: Read `references/voiceover-uikit.md`
   - SwiftUI implementation: Read `references/voiceover-swiftui.md`

2. **Dynamic Type, text scaling, or adaptive layout?**
   - Core concepts: Read `references/dynamic-type.md`
   - UIKit implementation: Read `references/dynamic-type-uikit.md`
   - SwiftUI implementation: Read `references/dynamic-type-swiftui.md`

3. **Other assistive technologies?**
   - Voice Control: Read `references/voice-control.md`
   - Switch Control: Read `references/switch-control.md`
   - Full Keyboard Access: Read `references/full-keyboard-access.md`

4. **Testing accessibility?**
   - Manual testing: Read `references/testing-manual.md`
   - Automated testing: Read `references/testing-automated.md`

5. **Cross-cutting concerns?**
   - Contrast, targets, motion, haptics: Read `references/good-practices.md`
   - Culture and mindset: Read `references/concepts-and-culture.md`

6. **Quick reference needed?**
   - Common mistakes, patterns, checklists: Read `references/playbook.md`

7. **Need definitions or sources?**
   - Glossary: Read `references/glossary.md`
   - Sources and further reading: Read `references/resources.md`

## Quick Playbook (Start Here)

1. Confirm **framework** (UIKit vs SwiftUI) and **iOS target**.
2. Identify **assistive technology** and **user-experience issue**.
3. Use the **Decision Tree** and jump into the relevant reference file.
4. Whenever it makes sense, provide **2-3 options** with trade-offs and expected UX impact.
5. Always include **testing guidance** alongside any code changes.

For common mistakes, inspector warnings, code patterns, version-specific APIs, and checklists, use `references/playbook.md`.

## Example Prompts and Expected Shape

**Example prompt:** “VoiceOver reads ‘button’ for my close button.”
**Expected response:**
- Confirm framework and iOS target if unknown.
- Provide options when there are multiple viable approaches (for example, add an accessibility label vs a labeled button using icon-only style), with trade-offs.
- Include a framework-appropriate snippet.
- Add testing steps (VoiceOver, Voice Control...).

**Example prompt:** “Dynamic Type breaks my header layout in UIKit.”
**Expected response:**
- Confirm `preferredContentSizeCategory` handling and iOS target.
- Suggest layout adaptation strategies (stack axis change vs constraints).
- Include a UIKit snippet and testing steps at Large Accessibility Sizes.

## Edge Cases and Gotchas

- Mixed UIKit/SwiftUI screens: use correct API set per view layer.
- Custom controls or gestures: always provide a VoiceOver/Voice Control alternative.
- Unknown iOS target: ask before suggesting version-specific APIs.
- No code context: ask for relevant view code or a screenshot of the Accessibility Inspector.
- Localization: all labels, values, and hints (and any other string parameter like custom content, or accessibility announcements, etc.) must be localized.
Pliki w paczce (20)
  • LICENSE 1 KB
  • LICENSE.txt 1 KB
  • SKILL.md 9 KB
  • agents/openai.yaml 1 KB
  • references/concepts-and-culture.md 11 KB
  • references/dynamic-type-swiftui.md 14 KB
  • references/dynamic-type-uikit.md 12 KB
  • references/dynamic-type.md 3 KB
  • references/full-keyboard-access.md 4 KB
  • references/glossary.md 9 KB
  • references/good-practices.md 18 KB
  • references/playbook.md 21 KB
  • references/resources.md 4 KB
  • references/switch-control.md 4 KB
  • references/testing-automated.md 5 KB
  • references/testing-manual.md 8 KB
  • references/voice-control.md 4 KB
  • references/voiceover-swiftui.md 17 KB
  • references/voiceover-uikit.md 26 KB
  • references/voiceover.md 6 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · velimirmueller/ai-development-skills100MIT
pstuart/pstuart100MIT
JordanCoin/ios-skills-collection95MIT
apexbymanish/claude-ai-agents-ios90MIT
rusel95/ios-agent-skills87MIT

Migawka bazy z 13.11.2026 · wersja paczki d37ed43e7070 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90iOS Accessibility Skill
    Pomaga projektować, wdrażać i testować dostępność w iOS i iPadOS: VoiceOver, Voice Control, Switch Control i Dynamic Type.
  • 100swift-accessibility-pro
    Dodaje dostępność do aplikacji SwiftUI i UIKit: etykiety VoiceOver, Dynamic Type, kontrast kolorów, redukcję ruchu i testy.
  • 100accessibility-generator
    Generuje infrastrukturę dostępności dla VoiceOver, Dynamic Type i innych funkcji, dodaje etykiety i podpowiedzi oraz audytuje zgodność aplikacji.
  • 100accessibility-voiceover-specialist
    Sprawdza widoki iOS pod kątem VoiceOver: etykiety, cechy elementów, obrazy i własne kontrolki dla czytników ekranu.
  • 100uikit-accessibility-auditor
    Audytuje ekrany UIKit pod kątem VoiceOver, Dynamic Type, Voice Control i struktury, z ustaleniami P0 do P2.
  • 95accessibility-testing
    Testuje dostępność aplikacji iOS: etykiety, VoiceOver, kontrast kolorów i zgodność z WCAG 2.1.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.