Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/soulmachine/skillsnpx agentmods add skills/soulmachine/skills/apple-designWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/soulmachine/skills/apple-design)<a href="https://agentmods.dev/skills/soulmachine/skills/apple-design"><img src="https://agentmods.dev/badge/skills/soulmachine/skills/apple-design/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/soulmachine/skills/apple-design"><img src="https://agentmods.dev/badge/skills/soulmachine/skills/apple-design.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00131 | $0.01884 |
| Opus 5.5 | $0.00052 | $0.00754 |
| Sonnet 5.5 | $0.00026 | $0.00377 |
| Haiku 4.5 | $0.00013 | $0.00188 |
Grade A, and why
apple-design scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 106 lines — stays where its author put it; the contents beside it link to each section on GitHub.
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
What ships with it
60 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.
- references/hig-index.md 37 KB
- references/hig/accessibility.md 20 KB
- references/hig/action-button.md 4.9 KB
- references/hig/action-sheets.md 4.6 KB
- references/hig/activity-rings.md 6.3 KB
- references/hig/activity-views.md 6.9 KB
- references/hig/airplay.md 7.4 KB
- references/hig/alerts.md 10 KB
- references/hig/always-on.md 4.1 KB
- references/hig/app-clips.md 31 KB
- references/hig/app-icons.md 15 KB
- references/hig/app-shortcuts.md 9.7 KB
- references/hig/apple-pay.md 31 KB
- references/hig/apple-pencil-and-scribble.md 14 KB
- references/hig/augmented-reality.md 23 KB
- references/hig/boxes.md 2.0 KB
- references/hig/branding.md 4.6 KB
- references/hig/buttons.md 18 KB
- references/hig/camera-control.md 5.1 KB
- references/hig/carekit.md 18 KB
- references/hig/carplay.md 8.6 KB
- references/hig/charting-data.md 7.4 KB
- references/hig/charts.md 20 KB
- references/hig/collaboration-and-sharing.md 7.2 KB
- references/hig/collections.md 2.3 KB
- references/hig/color-wells.md 1.8 KB
- references/hig/color.md 28 KB
- references/hig/column-views.md 2.2 KB
- references/hig/combo-boxes.md 1.6 KB
- references/hig/complications.md 22 KB
- references/hig/context-menus.md 9.0 KB
- references/hig/controls.md 7.2 KB
- references/hig/dark-mode.md 8.4 KB
- references/hig/design-principles.md 9.3 KB
- references/hig/designing-for-games.md 14 KB
- references/hig/designing-for-ios.md 3.7 KB
- references/hig/designing-for-ipados.md 3.3 KB
- references/hig/designing-for-iphone-duo.md 17 KB
- references/hig/designing-for-macos.md 3.4 KB
- references/hig/designing-for-tvos.md 2.9 KB
- references/hig/designing-for-visionos.md 7.4 KB
- references/hig/designing-for-watchos.md 4.5 KB
- references/hig/digit-entry-views.md 1.0 KB
- references/hig/digital-crown.md 5.2 KB
- references/hig/disclosure-controls.md 3.6 KB
- references/hig/dock-menus.md 2.0 KB
- references/hig/drag-and-drop.md 15 KB
- references/hig/edit-menus.md 6.2 KB
- references/hig/entering-data.md 4.8 KB
- references/hig/eyes.md 10 KB
- references/hig/feedback.md 4.2 KB
- references/hig/file-management.md 11 KB
- references/hig/focus-and-selection.md 13 KB
- references/hig/game-center.md 18 KB
- references/hig/game-controls.md 12 KB
- references/hig/gauges.md 3.9 KB
- references/hig/generative-ai.md 18 KB
- references/hig/gestures.md 16 KB
- references/hig/going-full-screen.md 7.2 KB
- references/hig/gyro-and-accelerometer.md 1.9 KB
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 106 lines · 131 tokens per session scan A 32ccdf8d8c0f
apple-design is a skill published in the GitHub repository soulmachine/skills (3 stars, last pushed 6d ago), licensed MIT. It adds 131 tokens to every session and 1,884 once invoked, about $0.0005 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-16.
Other skills, from other repositories
baoyu-diagram
Create professional, dark-themed SVG diagrams of any type — architecture diagrams, flowcharts, sequence diagrams, structural diagrams, mind maps, timelines, illustrative/conceptual diagrams, and more. Use this skill whenever the user asks for any kind of technical or conceptual diagram, visualization of a system…
flutter-ui
Build Flutter UI from Figma MCP or image input. Scans src for design tokens (colors, sizes, text styles), existing components, and naming conventions before writing a single line of code. Never hard-codes values.
design-mobile-apps
Use when the user wants to design a mobile app or UI screens, when they mention their Sleek (sleek.design) projects, or when implementing Sleek designs in code (HTML, React Native, SwiftUI).
appllama-app-design-skill
Build native-feeling, benchmark-quality mobile app screens (Expo / React Native). Use when designing or implementing any mobile UI — screens, flows, onboarding, paywalls, tab bars, sheets, settings, empty states — or when polishing motion, navigation, typography, dark mode, or perceived performance. Enforces Apple HIG…
daftai-image-to-svg
Converts transparent or solid-background single-color PNG files and SVG files containing one embedded or local PNG into verified path-only SVG output. Removes pure-color backgrounds automatically. Uses Potrace threshold and parameter scans with alpha error metrics to preserve detailed logos, stamps, engravings, and…
web-frontend-designer
Scaffold frontend architecture, components, routing, and UI dependencies from project config and wireframes.