iOS HIG Design
Native iOS app design guidelines
Design native-feeling iOS interfaces that follow Apple's Human Interface Guidelines. This skill equips your AI agent with platform conventions for navigation, layout, typography, and interaction patterns that iOS users expect.
npx skills add wondelai/skills/ios-hig-design --global developer.apple.com
Human Interface Guidelines Apple View the book
02 What it is
What is the iOS HIG Design skill?
Apple’s Human Interface Guidelines run to hundreds of pages; the iOS HIG Design skill compresses the parts that change your code into something an agent can apply. It checks navigation choices, safe areas, Dynamic Type, SF Symbols, and haptics against platform convention, so a screen reads as native rather than as a web layout in a phone frame.
03 Key concepts
Five principles your agent applies.
Drawn from Human Interface Guidelines — not advice it repeats back to you, but decisions it makes while it works.
04 Fit
When to use it, and
when not to.
four symptoms it fixes, and four it doesn't.
Reach for it when
Testers keep saying your SwiftUI app feels like a website in a phone frame.
You are porting a web or Android design and every screen needs a native equivalent chosen.
Your layout breaks at the largest accessibility text size and you don’t know what should reflow.
You are about to submit to App Review and want the obvious convention breaks caught first.
Reach for something else when
You are designing for Android or the web. these conventions are Apple’s; use Refactoring UI for neutral polish.
The question is whether a control communicates its purpose at all. Design of Everyday Things sits under the HIG.
You want the small moments specced. Microinteractions defines trigger, rules, and feedback frame by frame.
You still need to prove the feature is worth building. Lean UX or Continuous Discovery come first.
05 Prompts
Say it like this.
Name the skill at the end of a prompt and the agent applies the framework rather than a vibe. Or say nothing — it loads on its own when a task matches.
Design a tab-based navigation structure for my fitness app using ios-hig-design skill
Audit my SwiftUI views for HIG compliance using ios-hig-design skill
Create an onboarding flow that follows iOS conventions using ios-hig-design skill
Add proper haptic feedback to my button interactions using ios-hig-design skill
06 About the source
07 Same stack
The stack it sits in.
Nine Design & UX skills. Most people run two: this one, and whichever fits the next problem.
All Design & UX skills08 Questions
Before you install.
How do I install the iOS HIG Design skill?
Run npx skills add wondelai/skills/ios-hig-design --global. It takes about 30 seconds and needs no account. The iOS HIG Design skill then works in Claude, Claude Code, Claude Cowork, Codex, Cursor, OpenClaw and Hermes Agent — anything that reads the open agentskills.io format — and your agent loads it on its own when a task calls for it. It is free and MIT-licensed, and the source is at https://github.com/wondelai/skills.
Which book is the iOS HIG Design skill based on?
It packages Human Interface Guidelines by Apple — pioneer of modern UI and mobile interaction design. The skill distils the book's method into instructions your agent follows while it works, covering navigation patterns, sf symbols & iconography and dynamic type. It sits in the Design & UX part of the library.
Does this replace reading the Human Interface Guidelines?
No — it front-loads them. Apple revises the HIG continuously and adds material for each new OS and device, so the current page is always the authority on this year’s specifics. What the skill carries is the stable part: which navigation pattern fits which app structure, what Dynamic Type actually demands of your layout, when a sheet beats a push. Check Apple directly for anything version-specific.
Is this about design, or does it write SwiftUI?
The decisions are design decisions — hierarchy, navigation model, presentation style, feedback — but they land as code, because your agent is already in your SwiftUI or UIKit files. In practice you get a changed view with an explanation of which convention drove each change. It is opinionated about structure and layout, not about your architecture or state management.
Will following the HIG get my app approved?
Not on its own, and conflating the two is a common mistake. The HIG is design guidance; the App Store Review Guidelines are policy. Rejections usually come from the policy side — purchase flows, privacy disclosures, account deletion, data use — and this skill has nothing to say about those. It makes your app feel right to iOS users, which is a different test from passing review.
Does it cover iPad, Mac, and visionOS too?
It is centred on iPhone and iPad, where the conventions are most established and most often broken. Multi-column layouts, size classes, and adapting a phone design to a larger canvas are in scope. Catalyst, native macOS idioms, and spatial platforms are not — those have their own interaction models, and asking this skill to reason about them would get you confident guesses rather than conventions.
09 Guides that use it
Put it to work.
Long-form playbooks where this skill does part of the job.
One skill, one command.
Install iOS HIG Design, or the whole stack.
npx skills add wondelai/skills/ios-hig-design --global MIT licensed · Claude, Claude Code, Codex, Cursor, OpenClaw, Hermes · No account