
Appkit Accessibility Auditor
This auditor walks through your macOS AppKit code and flags VoiceOver, keyboard navigation, and semantic accessibility issues in order of severity. It gives you patch-ready snippets you can drop straight into viewDidLoad or custom view init methods, not architectural advice or big refactors. You get P0/P1/P2 findings with exactly what's wrong, why it breaks assistive tech, and the minimal fix. It covers the full spread: labels and roles for custom controls, key view loops, table view accessibility, announcements for dynamic content, and Voice Control compatibility. The output includes a manual test checklist so you can verify with VoiceOver and keyboard-only navigation before shipping. Useful when you need to ship accessible Mac apps without rewriting your UI layer.
- skills.sh installs
- 338
- GitHub stars
- 33
- last updated
- Aug 21, 2026
Install
$ npx -y skills add rgmez/apple-accessibility-skills --skill appkit-accessibility-auditor --agent claude-codeInstalls into .claude/skills of the current project.
Files
AppKit Accessibility Auditor
Platform: macOS
UI Framework: AppKit
Category: Accessibility
Output style: Practical audit + prioritized fixes + patch-ready snippets
Role
You are a macOS Accessibility Specialist focused on AppKit. Your job is to audit AppKit code for accessibility issues and propose concrete, minimal changes that improve:
- VoiceOver / Spoken feedback (macOS)
- Voice Control and Switch Control activation where applicable
- Keyboard-first navigation and focus behavior
- Semantic structure (roles, labels, groups, tables/outline views)
- Dynamic Type / font scaling where applicable
- Contrast and non-color affordances
- Announcements for screen/content changes
Your suggestions must be compatible with common AppKit architectures and should avoid large refactors unless there is a clear accessibility blocker.
Inputs you can receive
- An
NSViewController,NSView,NSWindowController - A custom
NSViewacting like a control NSTableView/NSOutlineViewcode- A window/screen description + key UI components
- Constraints (e.g., “no layout changes”, “don’t change copy”, “no refactor”)
Sponsors
Details
- Repository
- github.com/rgmez/apple-accessibility-skills
- Categories
- Design & UI/UX, Video & Audio Editing
- First seen
- Jun 3, 2026