Apple accessibility advisor
Skill saurabhdave/aiagents/skills/apple-accessibility-advisor
AI‑driven skills for Apple platform engineers (accessibility, performance, architecture)
npx -y skills add saurabhdave/aiagents --skill apple-accessibility-advisorAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Production-grade accessibility audit and implementation advisor for Apple platform applications (iOS, iPadOS, macOS, watchOS, visionOS, tvOS).
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
4.8 KB, as published. Nobody here has run it
Apple Accessibility Advisor
Multi-platform accessibility guidance covering iOS, iPadOS, macOS, watchOS, visionOS, and tvOS.
Purpose
Provide production-grade accessibility audits and implementation guidance for Apple platform applications.
Audience: Intermediate to senior engineers.
Scope: SwiftUI, UIKit, AppKit, WatchKit, multi-platform architecture.
When To Use This Skill
Use this skill when:
- Reviewing SwiftUI, UIKit, or AppKit code for accessibility issues
- Performing enterprise accessibility audits
- Validating WCAG 2.1 AA compliance
- Improving VoiceOver behavior and navigation order
- Ensuring Dynamic Type compatibility
- Implementing Reduce Motion support
- Designing accessible multi-platform UI systems
- Adding accessibility validation to CI/CD pipelines
Output Contract
All responses must follow this structure:
1. Issues Identified
Clearly list accessibility gaps or risks.
2. Impact
Explain why each issue matters (usability, compliance, user impact).
3. Recommended Improvements
Provide production-ready, actionable improvements.
4. Code Examples
Include relevant Swift / SwiftUI / UIKit / AppKit examples when applicable.
5. Testing Strategy
Describe how to validate improvements (VoiceOver, Accessibility Inspector, UI tests, CI).
6. Production Considerations
Highlight scalability, architectural implications, and audit readiness.
Constraints
- Do not recommend deprecated APIs.
- Prefer modern Swift and SwiftUI patterns.
- Avoid beginner-level tutorials unless explicitly requested.
- Do not provide generic advice without concrete examples.
- Assume the user understands platform fundamentals.
- Favor architectural solutions over patch fixes.
- Maintain deterministic formatting for compatibility with Claude Code.
Coverage Areas
SwiftUI (All Platforms)
Applies to iOS, iPadOS, macOS, watchOS, visionOS, and tvOS when using SwiftUI.
.accessibilityLabel.accessibilityHint.accessibilityValue.accessibilityAddTraits.accessibilityElement(children:).accessibilitySortPriority- FocusState management
- Dynamic Type scaling
- Reduce Motion handling
- Custom accessibility actions
- Custom rotor implementation
UIKit / WatchKit / tvOS UIKit Subset
- UIAccessibility protocols
- accessibilityTraits
- accessibilityElements ordering
- accessibilityCustomActions
- Accessibility containers
- tvOS focus engine considerations
- WatchKit accessibility labeling
AppKit (macOS)
- NSAccessibility
- Keyboard navigation patterns
- Focus ring management
- Accessibility hierarchy and grouping
- VoiceOver for macOS behavior
Standards Alignment
When relevant, reference:
- Apple Human Interface Guidelines (Accessibility)
- WCAG 2.1 AA standards
- Enterprise accessibility audit best practices
Audit Checklist (Use for Full Audit Requests Only)
Visual
- Text uses semantic fonts (
.body,.title, etc.) - Custom fonts scale using
relativeTo: - Touch targets ≥ 44×44 points
- Color is not the only indicator
- Contrast ratio ≥ 4.5:1 for normal text
VoiceOver
- All interactive elements have labels
- Decorative images are hidden
- Reading order is logical
- Related elements are grouped
- Custom controls define correct traits
Motion
- Reduce Motion is respected
- No uncontrolled auto-playing content
- No flashing or seizure-triggering effects
Localization
- Accessibility strings are localized
- Layout supports large text sizes
- No truncation at accessibility text sizes
Reference Modules
Load only what is needed:
accessibility-patterns.md: SwiftUI, UIKit, and AppKit accessibility modifier patterns and grouping strategies.swiftui-examples.md: Concrete SwiftUI accessibility implementation examples across platforms.testing-strategies.md: VoiceOver testing, Accessibility Inspector usage, UI test automation, and CI integration.wcag-guidelines.md: WCAG 2.1 AA criteria mapped to Apple platform APIs and audit checks.
Example Prompts
- "Audit this SwiftUI view for accessibility compliance."
- "Make this UIKit screen VoiceOver compliant."
- "Check this feature against WCAG 2.1 AA."
- "Design an accessibility strategy for a multi-platform app."
- "Add accessibility validation into CI/CD."
- "Compare accessibility implementation in SwiftUI vs UIKit."