agentleFS
soulmachinesoulmachine/skills/apple-design/SKILL.md

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

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.
  • cal1888Skill

    pick-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

  • sanmidableSkill

    write-swift

    Also in 26 projects that use this

  • wxyhgkSkill

    find-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

  • wxyhgkSkill

    improve-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

  • sanmidableSkill

    ask-sonner

    Also in 24 projects that use this

  • attentiondotnetSkill

    animation-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

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
  1. Very specific:

    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 …

    line 26
  2. Very specific:

    Done when: every element on screen has been checked against a page you opened, every claim carries a file.md › Heading citation or is …

    line 50
  3. Distinctive:

    Only sections with content appear.

    line 94

“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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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.

PathWhat it is
references/hig-index.mdRouting 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>.mdOne 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.mdThe rest of developer.apple.com/design: Figma/Sketch kits, fonts, SF Symbols, Icon Composer, bezels, the learning pathway
scripts/pull_hig.pyRegenerates hig/ and hig-index.md from Apple's site. Not needed for a task

Steps

  1. 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).
  2. 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>.md if platform behaviour matters.
    • Question about a guideline: the page alone.
    • Resource, kit, font, tool: resources.md.
  3. 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 › Heading plus 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.
  4. Done when every element on screen has been checked against a page you opened, every claim carries a file.md › Heading citation or is labelled judgment, and every number (contrast ratio, control size, type size, icon size) comes from a ## Specifications table rather than recall.

Routing

The design shows, or the question is aboutLoad
Tabs, sidebar, split view, navigation bar, toolbartab-bars.md, sidebars.md, split-views.md, toolbars.md
Buttons, menus, actionsbuttons.md, menus.md, context-menus.md, pop-up-buttons.md, pull-down-buttons.md
Sheets, alerts, popovers, panels, modal flowsmodality.md, sheets.md, alerts.md, action-sheets.md, popovers.md, panels.md
Forms, text entry, pickers, toggles, slidersentering-data.md, text-fields.md, pickers.md, toggles.md, sliders.md, virtual-keyboards.md
Lists, tables, collections, outlines, cardslists-and-tables.md, collections.md, outline-views.md, labels.md, scroll-views.md
Searchsearching.md, search-fields.md
Liquid Glass, blur, translucency, vibrancymaterials.md › Liquid Glass, color.md › Liquid Glass color
Dark appearancedark-mode.md, color.md
Icons, symbols, app icon, artworkicons.md, sf-symbols.md, app-icons.md, images.md
Motion, haptics, soundmotion.md, playing-haptics.md, playing-audio.md
Loading, progress, feedback, errors, empty states, copyloading.md, feedback.md, progress-indicators.md, writing.md
First run, sign-in, permissionslaunching.md, onboarding.md, managing-accounts.md, privacy.md, sign-in-with-apple.md
Settingssettings.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, filesmultitasking.md, drag-and-drop.md, undo-and-redo.md, file-management.md
Notifications, widgets, Live Activities, complicationsnotifications.md, managing-notifications.md, widgets.md, live-activities.md, complications.md
Chartscharting-data.md, charts.md
AI, Siri, shortcutsgenerative-ai.md, machine-learning.md, siri.md, app-shortcuts.md
Payments, subscriptions, ratingsapple-pay.md, in-app-purchase.md, ratings-and-reviews.md
Watchdesigning-for-watchos.md, digital-crown.md, always-on.md, watch-faces.md
Vision Prodesigning-for-visionos.md, spatial-layout.md, immersive-experiences.md, eyes.md, ornaments.md
TVdesigning-for-tvos.md, remotes.md, top-shelf.md, focus-and-selection.md
Gamesdesigning-for-games.md, game-controls.md, game-center.md
Brand, personalitybranding.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 iteration

Only 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 JSON

Apple 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.