hig
Fact lookup: Apple Human Interface Guidelines corpus (greppable markdown). Query on demand for accessibility and ergonomic minimums (hit-target sizes, Dynamic Type), platform terminology, system component capabilities, and App-Review-relevant conventions. Not design direction.
- Installs
- 899
- Last 24h
- +108
- Trending rank
- #1893
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/prisma-labs-dev/apple-skills --skill hig- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads hig automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Human Interface Guidelines Reference
Local greppable copy of Apple's Human Interface Guidelines — an on-demand fact lookup, not design direction.
Use it to answer factual questions: what a system component can do, what Apple calls something, accessibility and ergonomic minimums (44pt hit targets, Dynamic Type behavior, contrast), and conventions App Review actually checks.
Visual design in our repos is the designing model's own taste. Consult the HIG for facts, never for aesthetics — it describes what the system provides and requires, not what your screen should look like.
Downloaded Reference Files
All key HIG documentation is available locally (grep-friendly):
Getting Started
| File | Content | Size |
|---|---|---|
| hig-index.md | Full HIG table of contents | 11KB |
| designing-for-ios.md | iOS design principles | 5KB |
Foundations
| File | Content | Size |
|---|---|---|
| app-icons.md | App icon design guidelines | 14KB |
| color.md | Color usage and system colors | 17KB |
| typography.md | Fonts, text styles, Dynamic Type | 17KB |
| layout.md | Layout principles, safe areas | 21KB |
| materials.md | Materials, blur effects, vibrancy | 14KB |
| motion.md | Animation principles | 9KB |
| accessibility.md | Accessibility best practices | 19KB |
| sf-symbols.md | SF Symbols usage | 21KB |
Patterns
| File | Content | Size |
|---|---|---|
| onboarding.md | Onboarding flows | 6KB |
| modality.md | Modal presentations | 7KB |
| launching.md | App launch experience | 6KB |
| feedback.md | User feedback patterns | 5KB |
| playing-haptics.md | Haptic feedback | 10KB |
| searching.md | Search patterns | 7KB |
| settings.md | Settings patterns | 7KB |
Components - Navigation
| File | Content | Size |
|---|---|---|
| tab-bars.md | Tab bar design | 11KB |
| navigation-bars.md | Navigation bar patterns | 17KB |
| toolbars.md | Toolbar design | 17KB |
| sidebars.md | Sidebar patterns | 8KB |
Components - Presentation
| File | Content | Size |
|---|---|---|
| sheets.md | Sheet presentations | 11KB |
| alerts.md | Alert dialogs | 10KB |
| action-sheets.md | Action sheets | 4KB |
| menus.md | Menu design | 14KB |
Components - Controls
| File | Content | Size |
|---|---|---|
| buttons.md | Button styles and usage | 17KB |
| lists-and-tables.md | List and table patterns | 9KB |
| toggles.md | Toggle/switch design | 9KB |
| pickers.md | Picker controls | 6KB |
| sliders.md | Slider controls | 6KB |
| steppers.md | Stepper controls | 2KB |
| text-fields.md | Text input fields | 6KB |
Searching the Docs
# Find color guidance
grep -i "semantic" color.md
# Find button styles
grep -i "bordered" buttons.md
# Find haptic patterns
grep -i "notification" playing-haptics.md
# Browse the full HIG index
grep -i "navigation" hig-index.md
Fetching More Docs
- Search this skill's local
.mdfiles first. - If the topic is not here, check the other installed Apple skills you have available by their names, descriptions, or
SKILL.mdfrontmatter, then grep their local files. This is faster and uses less context than fetching new docs from the internet. - If no installed skill has the page, use the relevant Human Interface Guidelines path with the
sosumi.aiMarkdown mirror. For example,/design/human-interface-guidelines/buttonsmaps tohttps://sosumi.ai/design/human-interface-guidelines/buttons.
Common HIG Doc Paths
| Topic | URL Path |
|---|---|
| Full Index | human-interface-guidelines |
| iOS Design | human-interface-guidelines/designing-for-ios |
| iPadOS Design | human-interface-guidelines/designing-for-ipados |
| macOS Design | human-interface-guidelines/designing-for-macos |
| App Icons | human-interface-guidelines/app-icons |
| Color | human-interface-guidelines/color |
| Typography | human-interface-guidelines/typography |
| Layout | human-interface-guidelines/layout |
| Accessibility | human-interface-guidelines/accessibility |
| SF Symbols | human-interface-guidelines/sf-symbols |
| Buttons | human-interface-guidelines/buttons |
| Tab Bars | human-interface-guidelines/tab-bars |
| Navigation Bars | human-interface-guidelines/navigation-bars |
| Sheets | human-interface-guidelines/sheets |
| Alerts | human-interface-guidelines/alerts |
Quick Facts
System Button Styles (iOS)
What the system provides out of the box:
- Plain - Text only, minimal visual weight
- Gray - Gray background
- Tinted - Tinted background with accent color
- Filled - Solid background
- Bordered - Outlined with border
- Bordered Prominent - Filled background, high prominence
Haptic Feedback Types
- Selection - Light tap for selection changes
- Impact - Light/medium/heavy/rigid/soft for collisions
- Notification - Success/warning/error for outcomes
Safe Areas (ergonomic facts)
- Content outside safe areas can be clipped by the notch/Dynamic Island, home indicator, or rounded corners
- Interactive elements outside safe areas may be unreachable or intercepted by system gestures
- Backgrounds can extend edge-to-edge without those risks
Sources
Apple Documentation
WWDC Sessions
FAQ
What does the hig skill do?
Fact lookup: Apple Human Interface Guidelines corpus (greppable markdown). Query on demand for accessibility and ergonomic minimums (hit-target sizes, Dynamic Type), platform terminology, system component capabilities, and App-Review-relevant conventions. Not design direction.
How do I install hig?
Run npx skills add https://github.com/prisma-labs-dev/apple-skills --skill hig in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/hig/ (personal) or .claude/skills/hig/ (project).
Which AI agents can use hig?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is hig safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains hig?
It is published by prisma-labs-dev in prisma-labs-dev/apple-skills. It has 899 recorded installs.
More from prisma-labs-dev/apple-skills
ios-liquid-glass
prisma-labs-dev/apple-skills
API reference: Liquid Glass (iOS 26+). Query for glass effects, navigation patterns, GlassEffect modifiers, design principles.
apple-docs-index
prisma-labs-dev/apple-skills
Index of Apple developer documentation for iOS, macOS, and related frameworks. Use when looking up what APIs exist in a framework, browsing available documentation, or deciding what docs to fetch. Covers SwiftUI, UIKit, Core Animation (QuartzCore), XCTest, HealthKit, Combine, SwiftData, and more.
healthkit
prisma-labs-dev/apple-skills
API reference: HealthKit. Query for HKHealthStore, HKQuantitySample, workouts, health data read/write.
ios-dev
prisma-labs-dev/apple-skills
Start here for any iOS or SwiftUI task. Coordinates best-practice guides, correctness checks, and full Apple API references. Use before navigating to other Apple skills — for building, reviewing, refactoring, or debugging iOS apps.
xcuitest
prisma-labs-dev/apple-skills
API reference: XCUITest. Query for element queries, waiting patterns, Swift 6 @MainActor, assertions, screenshots, launch arguments.
Popular frontend & design skills
setup-matt-pocock-skills
mattpocock/skills
Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.
frontend-design
anthropics/skills
Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.
hyperframes-animation
heygen-com/hyperframes
All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.
prototype
mattpocock/skills
Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.
hyperframes-core
heygen-com/hyperframes
The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.
vercel-react-best-practices
vercel-labs/agent-skills
React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.