apple-design
Skill3 starsChanged yesterdayMITView on GitHub
Apple's Human Interface Guidelines and design resources, offline — 158 HIG pages pulled from developer.apple.com plus the design kits, fonts, SF Symbols, and Icon Composer links. Use when designing, building, or reviewing UI for iOS, iPadOS, macOS, watchOS, tvOS, or visionOS (SwiftUI, UIKit, AppKit); when the user asks what Apple's guidelines say about a component, pattern, or platform; for an app icon, Liquid Glass, Dark Mode, Dynamic Type, or accessibility check; or to find an Apple Figma/Sketch kit, system font, or SF Symbols download.
117 other projects use a version of this.
Adopted by
Most recently taken up by
- titouannwtt/claude-toolstheir own version, first seen Nov 15, 2026
- upamune/skillstheir own version, first seen Nov 15, 2026
- egagofur/ai-engineering-looptheir own version, first seen Nov 15, 2026
- theishandubey/dotclaudetheir own version, first seen Nov 15, 2026
- FimawLLC/fimaw-skillstheir own version, first seen Nov 15, 2026
- emilkowalski/skillstheir own version, first seen Nov 13, 2026
Used with
Projects with it also use pick-ui-library, write-swift and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
cal1888Skillpick-ui-library
Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.
Also in 43 projects that use this
sanmidableSkillwrite-swift
Also in 26 projects that use this
wxyhgkSkillfind-animation-opportunities
Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.
Also in 50 projects that use this
wxyhgkSkillimprove-animations
Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.
Also in 56 projects that use this
sanmidableSkillask-sonner
Also in 24 projects that use this
attentiondotnetSkillanimation-vocabulary
Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.
Also in 57 projects that use this
- +2 more from sanmidable
Other versions117 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 117
- emilkowalski/skills★ 57ksame name
- emilkowalski/skill★ 55ksame name
- spree/spree★ 16ksame name
- mengxi-ream/read-frog★ 10ksame name
- usekaneo/kaneo★ 9.8ksame name
- 1weiho/open-slide★ 9.7ksame name
- open-slide/open-slide★ 9.7ksame name
- dickwu/apple-design-skill★ 3.3ksame name
- wxyhgk/retain-pdf★ 2.7ksame name
- poco-ai/Agentero★ 2.5ksame name
107 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository31 other files it gives its agents.
- affix-domainsSkill
- apwcli-pairSkill
- ask-always-on-agentSkill
- asus-esc8000-firmware-upgradeSkill
- asus-esc8000-gpu-bios-tuningSkill
- build-stealth-rustdeskSkill
- chrome-cdp-setupSkill
- cua-macos-lume-sandboxSkill
- deploy-kimi-k26-on-rtx-pro-6000Skill
- deploy-kimi-k3-on-rtx-pro-6000Skill
- deploy-stealth-rustdeskSkill
- ghostty-terminfoSkill
- herdr-rename-hookSkill
- imsg-permissionsSkill
- llm-inference-benchmarkSkill
- lxd-docker-firewall-conflictSkill
- mac-mini-as-headless-serverSkill
- macos-app-multi-instancesSkill
- macos-smb-serverSkill
- mac-smb-automountSkill
- openclaw-diagnoseSkill
- paseo-profilesSkill
- private-fork-syncSkill
- refresh-claude-accountSkill
- ssh-claude-authSkill
- sync-claude-accountsSkill
- to-featuresSkill
- trusted-publishSkill
- ubuntu-lxd-gpu-serverSkill
- ubuntu-nvidia-gpu-enablementSkill
- ubuntu-zfs-mirror-installSkill
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 1 is distinctive, and 2 are very specific to this project.
0
Common
Most of the 110 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 26
Load the pages, then read them: Start from the always-load set for the branch, add pages from the routing table below, and take anything …
- Very specific: line 50
Done when: every element on screen has been checked against a page you opened, every claim carries a file.md › Heading citation or is …
- Distinctive: line 94
Only sections with content appear.
“Common” is measured: kept by at least 6 in 10 of the 110 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
apple-design
Apple's design guidance as local reference. The agent's job is to cite: open the page, quote the rule, name the system component. Read before you cite; Apple rewrote large parts of the HIG for Liquid Glass (2025) and reintroduced its design principles (June 2026), so recall is stale.
| Path | What it is |
references/hig-index.md | Routing table: every HIG page grouped as Apple groups them, with Apple's one-line summary, platforms, and the date Apple last changed it |
references/hig/<slug>.md | One file per HIG page, Apple's own wording and headings, all six platforms. ## Specifications sections hold the numbers (type sizes, control sizes, contrast, icon sizes) |
references/resources.md | The rest of developer.apple.com/design: Figma/Sketch kits, fonts, SF Symbols, Icon Composer, bezels, the learning pathway |
scripts/pull_hig.py | Regenerates hig/ and hig-index.md from Apple's site. Not needed for a task |
Steps
- Pin the platform and the artifact. Which platforms (iOS, iPadOS, macOS, watchOS, tvOS, visionOS), which framework, and what is in front of you: a screenshot, a mockup, source, a description, or a question. Say what the artifact cannot show (a code fragment shows no contrast; a JPEG shows no exact colors).
- Load the pages, then read them. Start from the always-load set for the branch, add pages
from the routing table below, and take anything else from
hig-index.md. About ten files, never the whole directory.- Review or build a screen:
design-principles.md,designing-for-<platform>.md,accessibility.md,layout.md,typography.md,color.md, then the routed pages. - Single component or pattern: its page, plus
designing-for-<platform>.mdif platform behaviour matters. - Question about a guideline: the page alone.
- Resource, kit, font, tool:
resources.md.
- Review or build a screen:
- Do the task against the pages.
- Review: filter through the eight principles first (Purpose, Agency, Responsibility,
Familiarity, Flexibility, Simplicity, Craft, Delight, defined in
design-principles.md), then accessibility, platform conventions, visual design, interaction, writing. Each finding is What (with numbers), Why (file.md › Headingplus a short quote), Fix (the system component, modifier, or value to use). Rate Critical for accessibility failures and convention breaks that confuse, High for friction and looks-foreign, Medium for missed system components, Low for polish. - Build: reach for the system component before a custom view and name it (
TabView,NavigationSplitView,.sheet,.searchable,NSToolbar). A custom control still needs its press, hover, focus, and disabled states, Dynamic Type, both appearances, and safe areas. - Question: quote the guideline, cite the file and heading, add the developer link the page gives.
- Review: filter through the eight principles first (Purpose, Agency, Responsibility,
Familiarity, Flexibility, Simplicity, Craft, Delight, defined in
- Done when every element on screen has been checked against a page you opened, every
claim carries a
file.md › Headingcitation or is labelled judgment, and every number (contrast ratio, control size, type size, icon size) comes from a## Specificationstable rather than recall.
Routing
| The design shows, or the question is about | Load |
| Tabs, sidebar, split view, navigation bar, toolbar | tab-bars.md, sidebars.md, split-views.md, toolbars.md |
| Buttons, menus, actions | buttons.md, menus.md, context-menus.md, pop-up-buttons.md, pull-down-buttons.md |
| Sheets, alerts, popovers, panels, modal flows | modality.md, sheets.md, alerts.md, action-sheets.md, popovers.md, panels.md |
| Forms, text entry, pickers, toggles, sliders | entering-data.md, text-fields.md, pickers.md, toggles.md, sliders.md, virtual-keyboards.md |
| Lists, tables, collections, outlines, cards | lists-and-tables.md, collections.md, outline-views.md, labels.md, scroll-views.md |
| Search | searching.md, search-fields.md |
| Liquid Glass, blur, translucency, vibrancy | materials.md › Liquid Glass, color.md › Liquid Glass color |
| Dark appearance | dark-mode.md, color.md |
| Icons, symbols, app icon, artwork | icons.md, sf-symbols.md, app-icons.md, images.md |
| Motion, haptics, sound | motion.md, playing-haptics.md, playing-audio.md |
| Loading, progress, feedback, errors, empty states, copy | loading.md, feedback.md, progress-indicators.md, writing.md |
| First run, sign-in, permissions | launching.md, onboarding.md, managing-accounts.md, privacy.md, sign-in-with-apple.md |
| Settings | settings.md |
| Windows, menu bar, keyboard, pointer, Dock (Mac) | windows.md, the-menu-bar.md, keyboards.md, pointing-devices.md, focus-and-selection.md, dock-menus.md |
| Multitasking, drag and drop, undo, files | multitasking.md, drag-and-drop.md, undo-and-redo.md, file-management.md |
| Notifications, widgets, Live Activities, complications | notifications.md, managing-notifications.md, widgets.md, live-activities.md, complications.md |
| Charts | charting-data.md, charts.md |
| AI, Siri, shortcuts | generative-ai.md, machine-learning.md, siri.md, app-shortcuts.md |
| Payments, subscriptions, ratings | apple-pay.md, in-app-purchase.md, ratings-and-reviews.md |
| Watch | designing-for-watchos.md, digital-crown.md, always-on.md, watch-faces.md |
| Vision Pro | designing-for-visionos.md, spatial-layout.md, immersive-experiences.md, eyes.md, ornaments.md |
| TV | designing-for-tvos.md, remotes.md, top-shelf.md, focus-and-selection.md |
| Games | designing-for-games.md, game-controls.md, game-center.md |
| Brand, personality | branding.md, design-principles.md |
Report shape for a review
## Design review: <name> — <platform>
Summary: two sentences, rating Excellent / Good / Needs work / Critical issues.
### Critical — What / Why (`file.md › Heading`: "quote") / Fix
### Improvements — same shape, tagged High / Medium / Low
### What works — specific enough to survive the next iterationOnly sections with content appear. A strong design gets a short review.
Refreshing the references
python3 scripts/pull_hig.py # stdlib only; add --cache /tmp/hig-cache to keep the raw JSONApple stamps each page with its last change; hig-index.md carries the dates, and
https://developer.apple.com/design/whats-new/ lists them. A second run over unchanged pages
writes nothing, and the script refuses to delete more than a tenth of the pages without
--force-prune.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

