Teach your AI
Apple's design language

Give your AI the complete Apple Human Interface Guidelines. No more hallucinated patterns. No more wrong-platform advice.

Accurate, platform-specific guidance for iOS, iPadOS, macOS, watchOS, and visionOS — without reading 500 pages yourself.

npx skills add raintree-technology/apple-hig-skills

What can you ask

Ask a design question. Get a specific, platform-aware answer grounded in Apple's actual guidelines.

Building an iPad app?
Skip the guesswork on sidebars vs. tab bars, split views, multitasking, and pointer interactions. Get the iPadOS-specific answer, not generic iOS advice.
Platforms
Layout
Inputs
Adding Apple Pay?
Get the exact button placement, flow design, and error handling patterns Apple requires — so you pass App Review the first time.
Technologies
Patterns
Designing for visionOS?
Ornaments, volumes, immersive spaces, eye tracking, and spatial interactions — the full visionOS design language in one place.
Platforms
Inputs
Layout
Getting dark mode right?
System colors, materials, elevation, and vibrancy — every rule for a dark mode that feels native, not bolted on.
Foundations
Content

See the difference

Same question. Same AI. The only difference is whether it has Apple's actual guidelines or not.

How should I handle navigation in my iPad app?

Without HIG Skills
Based on common iOS patterns, you should
use a UITabBarController with bottom tabs
for your main navigation. Add 3-5 tabs for
your key sections. You can also add a
hamburger menu for additional options.
  • Applies iOS phone patterns to iPad
  • Suggests hamburger menus (Apple discourages these)
  • No mention of iPadOS-specific conventions
With HIG Skills
Per Apple's HIG for iPadOS, use a sidebar
instead of a bottom tab bar. iPadOS has more
screen space, so a sidebar gives users
persistent, scannable navigation.
Use a split view with a two- or three-column
layout. The sidebar should collapse on compact
widths and support iPad multitasking.
  • Knows iPadOS uses sidebars, not tab bars
  • References split views and multitasking
  • Cites the specific HIG topic

Your agent loads only what it needs

~4,000 tokens per question instead of 50,000+ for the full HIG. Your agent gets the answer without burning your context window.

50,000+

Full HIG dump

~4,000

With progressive disclosure

92%

Less context used

Seconds

Not hours in Apple's docs

Grounded

Apple's actual text, not guesses

Current

Updated when Apple updates

  1. Step 1
    ~50 tokens
    Discovery
    Your agent scans 14 skill descriptions to find the right one. Costs ~700 tokens total — barely a rounding error.
  2. Step 2
    ~1,500 tokens
    Activation
    The matching skill loads its key principles and reference index. Just enough to route to the right answer.
  3. Step 3
    ~200 tokens
    Context
    Your project context (platform, tech stack, constraints) tailors the guidance to your specific app.
  4. Step 4
    ~2,000 tokens
    Deep Reference
    Only the exact HIG topic you asked about loads. Not the entire guide — just the page you need.

Built for how you work

Solo developer or full team — same accurate answers, zero HIG research time.

Indie iOS developers
Stop context-switching between Xcode and Apple's docs. Ask your agent a design question and keep building.
Design teams
Give Claude, Cursor, or Copilot the same HIG knowledge your senior designers have. Every team member gets consistent, accurate answers.
Agencies and consultancies
Deliver Apple-quality design guidance to clients without memorizing every guideline. Your AI handles the reference work.
Teams building AI features
AI-generated UI that feels native, not generic. Your agent knows what Apple expects before you ship.

What's included

14 skills. 156 reference topics. The full Apple Human Interface Guidelines, structured for AI.

New here? Start with to set up your app details, then try for your target platform. The rest load on demand as you ask questions.

SkillReferences
Project Context
Open Standard

Works everywhere, updates automatically

Built on Agent Skills — an open standard for giving AI agents reusable expertise. Install once, use with any tool, update with a single command.

Learn about Agent Skills (opens in new tab)
Portable
Switch AI tools without rebuilding your setup. Works with Claude Code, Cursor, Copilot, Windsurf, and custom agents.
Versionable
Run git pull when Apple updates the HIG. New guidance, zero reconfiguration.
Universal
One install, every tool. No more fragmented .cursorrules, CLAUDE.md, and copilot-instructions.md files.

Common questions