dickwu / apple-design-skill

# Apple Design Skill
An AI design reviewer grounded in Apple's Human Interface Guidelines, packaged as an agent skill.
It audits and improves mobile and desktop UI, including layouts for the two-display iPhone Duo,
against 123 HIG pages pulled straight from developer.apple.com, translates Apple's vocabulary for
**Flutter**, **React Native**, **Tauri**, **Electron**, **SwiftUI**, **UIKit**, and **AppKit**, and
adds a design-craft lens so the result feels at home on the platform without looking like a
template.
## Install
### With the skills CLI
 [code] 
This works for Claude Code, Codex, Cursor, Antigravity, OpenCode, Windsurf, and every other agent the
skills CLI supports. Useful variations:
 [code] 
### Claude Code, by hand
Claude Code reads skills from `.claude/skills/` in a project or `~/.claude/skills/` for the user:
 [code] 
The skill triggers on design-review requests and is also available as `/apple-design`.
### Cursor
Install with `npx skills add dickwu/apple-design-skill -a cursor`, or clone the repository into
your project and keep its `.cursorrules` next to your own rules. Then ask Cursor:
*"Review this screen against Apple's HIG"*.
### Codex
Install with `npx skills add dickwu/apple-design-skill -a codex`, or add the repository as a
submodule and point `AGENTS.md` at it:
 [code] 
 [code] 
### Antigravity
Install with `npx skills add dickwu/apple-design-skill -a antigravity`, or clone the repository into
`.agents/skills/apple-design` in your project or global `~/.gemini/antigravity/` configuration:
 [code] 
You can also keep its `GEMINI.md` next to your own project rules to activate Apple HIG design
reviews automatically in your Antigravity workspace.
### Other agents
Add the same three lines to your rules file (`.windsurfrules`, `.ai-rules`, or similar):
follow `SKILL.md`, route with `references/hig-lookup.md`, load the relevant `references/hig/*.md`
files before giving feedback.
## Use it
Ask your agent things like:
- *"Review my Flutter app's home screen against Apple's guidelines"*
- *"Audit this Tauri app for accessibility"*
- *"Does this settings screen follow macOS conventions?"*
- *"Is my Flutter app ready for iPhone Duo's two displays?"*
- *"This looks generic. Give it a point of view without breaking iOS patterns"*
- *"How do I do Liquid Glass in React Native?"*
- *"Check this app icon"*
- *"Audit this repo for anything App Review would reject in our Apple Pay checkout"*
- *"Is this onboarding flow asking for permissions the right way?"*
## What a review covers
The reviewer reads the relevant guideline files before it writes a word, then works through:
1. **Apple's eight design principles** (reintroduced June 2026): purpose, agency, responsibility,
 familiarity, flexibility, simplicity, craft, delight.
2. **Accessibility**, blocking: text scaling, contrast ratios, control sizes, screen readers,
 keyboard access, motion and transparency settings, with the actual numbers.
3. **Platform conventions**: tab bars, toolbars, sheets,