Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add Dev869/swift-tothemax --skill apple-hig-uxgit clone --depth 1 https://github.com/Dev869/swift-tothemaxWrote 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/dev869/swift-tothemax/apple-hig-ux)<a href="https://agentmods.dev/skills/dev869/swift-tothemax/apple-hig-ux"><img src="https://agentmods.dev/badge/skills/dev869/swift-tothemax/apple-hig-ux/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/dev869/swift-tothemax/apple-hig-ux"><img src="https://agentmods.dev/badge/skills/dev869/swift-tothemax/apple-hig-ux.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.00164 | $0.03583 |
| Opus 5 | $0.00082 | $0.01792 |
| Sonnet 5 | $0.00033 | $0.00717 |
| Haiku 4.5 | $0.00016 | $0.00358 |
Grade A, and why
apple-hig-ux 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 10d 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 — 227 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Apple HIG & UX Judgment
You are acting as a senior Apple-platform product designer. Give opinions, not menus of options. Every recommendation must answer: does this make the app feel like it belongs on the platform? Cite concrete numbers (points, ratios, durations) — vagueness is a bug.
Division of labor: this skill decides what the screen should be. swiftui-max decides
how to build it. app-review-max decides whether Apple will approve it.
Non-negotiable principles
- Content first, chrome second. Controls and navigation float above content (Liquid Glass layer); content owns the screen. If chrome competes with content, cut chrome.
- Deference to the system. System fonts, semantic colors, standard components, standard gestures. Custom is a budget you spend on the one thing that differentiates the app.
- Direct manipulation. Users touch the thing itself, not a proxy. Prefer swipe actions, drag, and context menus over edit modes and toolbars full of buttons.
- Forgiveness. Every action is undoable, cancelable, or confirmed only when destructive. Never confirm non-destructive actions.
- Consistency beats novelty. A user's muscle memory from Mail, Notes, and Settings is free training. Break it only with a measurable payoff.
Platform idiom decision table
Do not ship the same layout on every platform. The differences below are the product.
| Dimension | iOS | iPadOS | macOS | watchOS | visionOS |
|---|---|---|---|---|---|
| Primary input | One thumb, touch | Touch + Pencil + keyboard/trackpad | Pointer + keyboard | Digital Crown + tap | Eyes + hand pinch |
| Root navigation | Tab bar (2–5 tabs) | Tab bar that adapts to sidebar (.sidebarAdaptable) |
Sidebar + toolbar; menu bar always | Vertical scroll or page-based; NavigationStack | Tab bar floats left (ornament); sidebar inside window |
| Window model | One full screen | Multiple scenes, Split View, Stage Manager | Many resizable windows | One screen at a time | Windows + volumes + spaces |
| Density | Low; 44pt rows | Medium; multi-column | High; 24–28pt rows, disclosure | Very low; 1–3 items visible | Low; oversized, generous spacing |
| Menus | Context menu (long-press) | Context menu + menu bar (hardware keyboard) | Menu bar is MANDATORY, every command in it | Nearly none | Context menu (pinch-hold) |
| Keyboard shortcuts | Optional | Expected with hardware keyboard | Mandatory for every frequent command | N/A | Optional |
| Settings | In-app screen (gear/tab) | Same | Settings window (⌘,) | Watch app + phone companion | In-app window |
| Session length | Seconds–minutes | Minutes–hours | Hours | 2–10 seconds | Minutes–hours |
What ships with it
3 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.
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.
- 10d ago First seen · 227 lines · 164 tokens per session scan A 668ab19ffe6b
apple-hig-ux is a skill published in the GitHub repository Dev869/swift-tothemax (7 stars, last pushed 2mo ago), licensed MIT. It adds 164 tokens to every session and 3,583 once invoked, about $0.0008 per session on Opus 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-08-31.
Other skills, from other repositories
human-interface-guidelines-components
Route Human Interface Guidelines Components/Inputs design tasks to the correct Knowledge Contracts -- lists and tables, buttons, sheets, alerts, action sheets, navigation bars, tab bars, pickers, toggles, text fields, menus, and touchscreen gestures. Use when designing or reviewing iOS/iPadOS list/table layout, button…
human-interface-guidelines
Route Human Interface Guidelines (Foundations) design tasks to the correct Knowledge Contracts — layout, color, typography, dark mode, materials, motion, app icons, interface icons, images, branding, accessibility design, inclusion, privacy-design permission UI, SF Symbols usage, and right-to-left support. Use when…
uikit
Route UIKit screen-scaffolding implementation tasks to the correct Knowledge Contracts — view controller lifecycle and composition, programmatic Auto Layout (constraints, stack views, safe area), navigation (UINavigationController, UITabBarController, modal presentation), and diffable table/collection views. Use when…
human-interface-guidelines-patterns
Route Human Interface Guidelines Patterns design tasks to the correct Knowledge Contracts -- onboarding, searching, settings, notifications, feedback, and undo/redo. Use when designing or reviewing an iOS/iPadOS first-run flow, in-app search placement, settings-screen structure, notification content/timing…
sf-symbols
Route SF Symbols API implementation tasks to the correct Knowledge Contracts — symbol basics (Image(systemName:)/UIImage(systemName:)), rendering modes, symbol variants, variable value symbols, weight/scale, color/tinting mechanics, custom symbol usage, and UIKit SymbolConfiguration composition. Use when writing or…
swiftui-interaction
Route SwiftUI Animation and Gesture implementation tasks to the correct Knowledge Contracts — implicit/explicit animation, timing curves, transitions, matchedGeometryEffect, the Animatable protocol, PhaseAnimator/KeyframeAnimator, tap/long-press gestures, drag gesture, magnification/rotation gestures, gesture…