{
  "markdown": "# Apple Design Skill\n\nAn AI design reviewer grounded in Apple's Human Interface Guidelines, packaged as an agent skill.\nIt audits and improves mobile and desktop UI against 122 HIG pages pulled straight from\ndeveloper.apple.com, translates Apple's vocabulary for **Flutter**, **React Native**, **Tauri**,\n**Electron**, **SwiftUI**, **UIKit**, and **AppKit**, and adds a design-craft lens so the result\nfeels at home on the platform without looking like a template.\n\n## Install\n\n### With the skills CLI\n\n```bash\nnpx skills add dickwu/apple-design-skill\n```\n\nThis works for Claude Code, Codex, Cursor, OpenCode, Windsurf, and every other agent the\n[skills CLI](https://skills.sh) supports. Useful variations:\n\n```bash\nnpx skills add dickwu/apple-design-skill -a claude-code   # install for one agent only\nnpx skills add dickwu/apple-design-skill -g               # user-wide instead of this project\nnpx skills add dickwu/apple-design-skill --list           # show what would be installed\nnpx skills update apple-design                            # pull the latest version later\n```\n\n### Claude Code, by hand\n\nClaude Code reads skills from `.claude/skills/` in a project or `~/.claude/skills/` for the user:\n\n```bash\ngit clone https://github.com/dickwu/apple-design-skill.git ~/.claude/skills/apple-design\n```\n\nThe skill triggers on design-review requests and is also available as `/apple-design`.\n\n### Cursor\n\nInstall with `npx skills add dickwu/apple-design-skill -a cursor`, or clone the repository into\nyour project and keep its `.cursorrules` next to your own rules. Then ask Cursor:\n*\"Review this screen against Apple's HIG\"*.\n\n### Codex\n\nInstall with `npx skills add dickwu/apple-design-skill -a codex`, or add the repository as a\nsubmodule and point `AGENTS.md` at it:\n\n```bash\ngit submodule add https://github.com/dickwu/apple-design-skill.git .design-rules\n```\n\n```markdown\n## Design reviews\n\nFollow `.design-rules/SKILL.md`. Route topics with `.design-rules/references/hig-lookup.md` and\nload the relevant `.design-rules/references/hig/*.md` files before giving design feedback.\n```\n\n### Other agents\n\nAdd the same three lines to your rules file (`.windsurfrules`, `.ai-rules`, or similar):\nfollow `SKILL.md`, route with `references/hig-lookup.md`, load the relevant `references/hig/*.md`\nfiles before giving feedback.\n\n## Use it\n\nAsk your agent things like:\n\n- *\"Review my Flutter app's home screen against Apple's guidelines\"*\n- *\"Audit this Tauri app for accessibility\"*\n- *\"Does this settings screen follow macOS conventions?\"*\n- *\"This looks generic. Give it a point of view without breaking iOS patterns\"*\n- *\"How do I do Liquid Glass in React Native?\"*\n- *\"Check this app icon\"*\n- *\"Is this onboarding flow asking for permissions the right way?\"*\n\n## What a review covers\n\nThe reviewer reads the relevant guideline files before it writes a word, then works through:\n\n1. **Apple's eight design principles** (reintroduced June 2026): purpose, agency, responsibility,\n   familiarity, flexibility, simplicity, craft, delight.\n2. **Accessibility**, blocking: text scaling, contrast ratios, control sizes, screen readers,\n   keyboard access, motion and transparency settings, with the actual numbers.\n3. **Platform conventions**: tab bars, toolbars, sheets, search, and safe areas on mobile; the\n   menu bar, windows, sidebars, shortcuts, and settings on desktop; light and dark everywhere.\n4. **Visual design and craft**: color, type, layout, icons, materials, motion, and then whether\n   the design has a point of view or is one of the three looks that dominate generated UI.\n5. **Interaction**: loading, feedback, alerts, modality, destructive actions, undo, data entry.\n6. **Content and writing**: labels that say what happens, platform-correct capitalization,\n   errors and empty states that direct people.\n\nEvery finding has a What, a Why that cites the guideline file and heading, and a Fix written in\nyour framework. Specialized modes cover app icons, accessibility audits, dark mode, Liquid Glass,\nnavigation structure, onboarding and permissions, forms, generative AI, and single components.\n\n**Improvement mode** goes further: it grounds the design in the product, plans a token system\n(palette, type roles, layout wireframe, one signature element, motion), critiques that plan\nagainst generic defaults before proposing it, and sequences the fixes from accessibility to\npolish.\n\n## What's inside\n\n```text\napple-design-skill/\n├── SKILL.md                     # The skill: stance, principles, lenses, report format, improvement mode\n├── AGENTS.md                    # Operating manual for agents and contributors\n├── .cursorrules                 # Cursor entry point\n├── scripts/\n│   └── pull-hig.mjs             # Re-pulls the guidelines from developer.apple.com\n└── references/\n    ├── hig-lookup.md            # Generated routing table with Apple's summaries and change dates\n    └── hig/                     # 122 generated pages + 1 curated guide\n        ├── design-principles.md\n        ├── accessibility.md\n        ├── buttons.md\n        ├── tab-bars.md\n        ├── liquid-glass.md      # Curated: rules, review checklist, cross-platform translation\n        └── ...\n```\n\n| Section | Files | Includes |\n| --- | --- | --- |\n| Getting started | 5 | Design principles; designing for iOS, iPadOS, macOS, and games |\n| Foundations | 16 | Accessibility, color, typography, layout, materials, dark mode, icons, SF Symbols, images, motion, branding, privacy, inclusion, right to left, writing, app icons |\n| Patterns | 24 | Onboarding, launching, loading, feedback, modality, searching, settings, notifications, accounts, data entry, undo, sharing, files, charts, audio, video, haptics, printing, multitasking, full screen, help, drag and drop, ratings, live viewing |\n| Components | 57 | Buttons, menus, the menu bar, toolbars, tab bars, sidebars, split views, sheets, alerts, action sheets, popovers, panels, windows, lists and tables, collections, text fields, pickers, toggles, sliders, steppers, segmented controls, search fields, progress indicators, gauges, labels, charts, widgets, notifications, Live Activities, controls, status bars, and more |\n| Inputs | 7 | Gestures, keyboards, pointing devices, focus and selection, game controls, Apple Pencil, gyroscope and accelerometer |\n| Technologies | 13 | Apple Pay, in-app purchase, Sign in with Apple, Siri, Maps, augmented reality, machine learning, generative AI, iCloud, AirPlay, NFC, App Clips, VoiceOver |\n| Curated | 1 | Liquid Glass |\n\nEach generated page keeps Apple's wording, headings, tables, notes, and change log, links to its\nsource, relabels platform headings by device class (phone, tablet, mobile, desktop), and omits\nthe sections that apply only to tvOS, visionOS, or watchOS. The 35 pages Apple publishes for other platforms or Apple-only\nservices are listed, with the reason, at the end of `references/hig-lookup.md`.\n\n## Keeping the references current\n\nApple revises the HIG several times a year. To pull the latest version:\n\n```bash\nnode scripts/pull-hig.mjs\n```\n\nNode 18 or newer, no dependencies, about 150 requests. The script crawls Apple's section index,\nrenders each page from the same JSON Apple's site uses, writes `references/hig/*.md` and\n`references/hig-lookup.md`, and removes pages Apple has retired. Pass `--cache <dir>` to keep the\nraw JSON for instant re-runs, and `--no-prune` to keep files the crawl no longer finds. Running the\nscript twice produces identical output, so a clean `git status` after a second run is the test.\n\n`AGENTS.md` lists the checks to run before committing a refresh.\n\n## Origin and license\n\nThe guideline text belongs to Apple Inc. and is reproduced from the public\n[Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/)\nfor AI-assisted design review, with a source link at the top of every file. This project is not\naffiliated with or endorsed by Apple. The skill, the curated guide, and the script are provided\nas they are; use them at your own discretion.\n",
  "bytes": 8035,
  "sha": "a112566f7f838ef418f7895c6a53997c98c41e32db42a6fb981786046f278d19",
  "repo_slug": "dickwu/apple-design-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_dickwu_apple_design_skill_apple_design_dfa04b4d/readme"
}