Apple Human Interface Guidelines for platform-specific design.

MITAuto-check passedMobile

Install Hig Platforms

skills CLI
$ npx skills add raintree-technology/hig-doctor --skill hig-platforms -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install raintree-technology/hig-doctor hig-platforms --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/raintree-technology/hig-doctor.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hig-platforms .claude/skills/hig-platforms && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
hig-platforms
GitHub stars
143
Used in
5 other repos
Token cost
~1.3k tokens
SKILL.md length
501 words
Files
8 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Apple Human Interface Guidelines for platform-specific design.

  • Works in 8 steps: Each platform has a distinct identity.… → iOS: touch-first. Direct manipulation on… → iPadOS: expanded canvas. Support Split… → …
  • The user asks about designing for iOS
  • SKILL.md covers Key Principles, Reference Index, Decision Framework and Output Format, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hig Platforms is an agent skill from raintree-technology/hig-doctor. Apple Human Interface Guidelines for platform-specific design. Use this skill when the user asks about "designing for iOS", "iPad app design", "macOS design", "tvOS", "visionOS", "watchOS", "Apple platform", "which platform", platform differences, platform-specific conventions, or multi-platform app design. Also use when the user says "should I design differently for iPad vs iPhone", "how does my app work on visionOS", "what's different about macOS apps", "porting my app to another platform", "universal app…

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `references/designing-for-games.md`, `references/designing-for-ios.md` and `references/designing-for-ipados.md`).

It sits in Mobile, covering iOS development. It works with iOS and macOS. The repository describes itself as: Apple HIG reference and cross-framework UI audit tooling for agents. The licence is MIT.

When your agent uses it

  • The user asks about designing for iOS
  • IPad app design
  • Platform differences
  • Platform-specific conventions

Example prompts

  • “designing for iOS”
  • “iPad app design”
  • “macOS design”
  • “/hig-platforms”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Each platform has a distinct identity. Do not port designs between platforms. Respect each platform's conventions, interaction models, and…
  2. iOS: touch-first. Direct manipulation on a handheld screen. Optimize for one-handed use. Navigation uses tab bars and push/pop stacks.
  3. iPadOS: expanded canvas. Support Split View, Slide Over, and Stage Manager. Use sidebars and multi-column layouts. Support pointer and…
  4. macOS: pointer and keyboard. Dense information display is acceptable. Use menu bars, toolbars, and keyboard shortcuts extensively. Windows…
  5. tvOS: remote and focus. Viewed from a distance. Design for the Siri Remote with focus-based navigation. Large text, simple layouts, linear…
  6. visionOS: spatial interaction. 3D environment using windows, volumes, and spaces. Eye tracking for targeting, indirect gestures for…
  7. watchOS: glanceable and brief. Information consumable at a glance. Brief interactions. Digital Crown, haptics, and complications for…
  8. Games: own paradigm. Free to define in-game interaction models, but still respect platform conventions for system interactions…

What it can do on your machine

Read from SKILL.md and the folder at commit 3ec08f5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • raintree.technology

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Hig Platforms loads about 1.3k tokens when it runs, and up to ~5.3k if it reads all its reference files. Until then it costs about 195 tokens; SKILL.md has 501 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~195
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from raintree-technology/hig-doctor at commit 3ec08f5, republished under its MIT licence (© raintree-technology). 501 words, ~1,330 tokens.

Download SKILL.mdSave it as .claude/skills/hig-platforms/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
hig-platforms
description
Apple Human Interface Guidelines for platform-specific design. Use this skill when the user asks about "designing for iOS", "iPad app design", "macOS design", "tvOS", "visionOS", "watchOS", "Apple platform", "which platform", platform differences, platform-specific conventions, or multi-platform app design. Also use when the user says "should I design differently for iPad vs iPhone", "how does my app work on visionOS", "what's different about macOS apps", "porting my app to another platform", "universal app design", or "what input methods does this platform use". Cross-references: hig-foundations for shared design foundations, hig-patterns for interaction patterns, hig-components-layout for navigation structures, hig-components-content for content display.
version
1.0.0

Apple HIG: Platform Design

Check for .claude/apple-design-context.md before asking questions. Use existing context and only ask for information not already covered.

Key Principles

  1. Each platform has a distinct identity. Do not port designs between platforms. Respect each platform's conventions, interaction models, and user expectations.

  2. iOS: touch-first. Direct manipulation on a handheld screen. Optimize for one-handed use. Navigation uses tab bars and push/pop stacks.

  3. iPadOS: expanded canvas. Support Split View, Slide Over, and Stage Manager. Use sidebars and multi-column layouts. Support pointer and keyboard alongside touch.

  4. macOS: pointer and keyboard. Dense information display is acceptable. Use menu bars, toolbars, and keyboard shortcuts extensively. Windows are resizable with precise control.

  5. tvOS: remote and focus. Viewed from a distance. Design for the Siri Remote with focus-based navigation. Large text, simple layouts, linear navigation.

  6. visionOS: spatial interaction. 3D environment using windows, volumes, and spaces. Eye tracking for targeting, indirect gestures for interaction. Respect ergonomic comfort zones.

  7. watchOS: glanceable and brief. Information consumable at a glance. Brief interactions. Digital Crown, haptics, and complications for timely content.

  8. Games: own paradigm. Free to define in-game interaction models, but still respect platform conventions for system interactions (notifications, accessibility, controllers).

Reference Index

ReferenceTopicKey content
designing-for-ios.mdiOSTouch, tab bars, navigation stacks, gestures, screen sizes, safe areas
designing-for-ipados.mdiPadOSMultitasking, sidebars, pointer, keyboard, Apple Pencil, Stage Manager
designing-for-macos.mdmacOSMenu bars, toolbars, window management, keyboard shortcuts, dense layouts, Dock
designing-for-tvos.mdtvOSFocus engine, Siri Remote, lean-back experience, content-forward, parallax
designing-for-visionos.mdvisionOSSpatial computing, windows/volumes/spaces, eye tracking, hand gestures, depth
designing-for-watchos.mdwatchOSGlanceable UI, Digital Crown, complications, notifications, haptics
designing-for-games.mdGamesControllers, immersive experiences, platform-specific conventions, accessibility
Show full SKILL.md (225 more words)Show less

Decision Framework

  1. Identify the primary use context. On the go (iOS/watchOS), at a desk (macOS), on the couch (tvOS), spatial environment (visionOS)?

  2. Match input to interaction. Touch for direct manipulation, pointer for precision, gaze+gesture for spatial, Digital Crown for quick scrolling, remote for focus navigation.

  3. Adapt, don't replicate. A macOS sidebar becomes a tab bar on iPhone. A visionOS volume has no equivalent on watchOS. Translate intent, not implementation.

  4. Leverage platform strengths. Live Activities on iOS, Desktop Widgets on macOS, complications on watchOS, immersive spaces on visionOS.

  5. Maintain brand consistency while respecting each platform's visual language and interaction patterns.

Output Format

  1. Platform-specific recommendations citing relevant HIG sections.
  2. Platform differences table comparing navigation, input, layout, and conventions.
  3. Implementation notes per platform including recommended APIs and adaptation strategies.

Questions to Ask

  1. Which platforms are you targeting?
  2. New app or adapting an existing one? If existing, which platform is the base?
  3. SwiftUI or UIKit/AppKit?
  4. Need to support older OS versions?
  5. Primary use context? (On the go, desk, couch, spatial, glanceable?)
  • hig-foundations -- Shared principles (color, typography, accessibility, layout) across platforms
  • hig-patterns -- Interaction patterns that manifest differently per platform
  • hig-components-layout -- Navigation structures (tab bars, sidebars, split views) that vary by platform
  • hig-components-content -- Content display that adapts across platforms

Built by Raintree Technology · More developer tools

© raintree-technology, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references) in skills/hig-platforms of raintree-technology/hig-doctor.

  • SKILL.md
  • references/designing-for-games.md
  • references/designing-for-ios.md
  • references/designing-for-ipados.md
  • references/designing-for-macos.md
  • references/designing-for-tvos.md
  • references/designing-for-visionos.md
  • references/designing-for-watchos.md

Open the folder on GitHubat commit 3ec08f5

Used in 5 other repositories

We found 18 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in raintree-technology/hig-doctor, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Hig Platforms next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Hig Platforms compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hig Platforms this skillraintree-technology/hig-doctor1435 repos~1.3kAutomated safety check: PassMIT
Orca iOS Simulator Controlstablyai/orca88k1 repos~584Automated safety check: PassApache-2.0
Apple Crash Log .NET Symbolicationdotnet/skills5.6k1 repos~2.4kAutomated safety check: PassMIT
Swiftui Expert Skillomarshahine/HomeClaw1754 repos~2.8kAutomated safety check: PassMIT
Phoneagentrounak/PhoneAgent799—~2.2kAutomated safety check: PassMIT
Apple Designvrcm-team/VRCM1791 repos~6.2kAutomated safety check: PassMIT

Similar skills

  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    88k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • Official

    Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.

    5.6k GitHub starsUsed in 1 repo~2.4k tokens
    MobileAuto-check passed
  • Swiftui Expert Skill

    omarshahine/HomeClaw

    A skill your agent uses when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state management, view composition, performance, Liquid Glass adoption, or Instruments .trace…

    175 GitHub starsUsed in 4 repos~2.8k tokens
    MobileAuto-check passed
  • Phoneagent

    rounak/PhoneAgent

    Control a connected iPhone, iOS simulator, Android emulator, or Android device from macOS through PhoneAgent's JSON-RPC bridge.

    799 GitHub stars~2.2k tokensUpdated 1 mo ago
    MobileAuto-check passed
  • Apple Design

    vrcm-team/VRCM

    Cross-platform UI/UX design reviewer grounded in Apple's Human Interface Guidelines (122 pages pulled from developer.apple.com, including 57 component pages) plus a design-craft lens for…

    179 GitHub starsUsed in 1 repo~6.2k tokens
    MobileAuto-check passed
  • Swiftui Expert Skill

    Eslzzyl/Pixiv-SwiftUI

    A skill your agent uses when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state and @Observable data flow, view composition, resizable layouts, safe areas, display…

    111 GitHub starsUsed in 1 repo~2.9k tokens
    MobileAuto-check passed

More from raintree-technology/hig-doctor

All 15 skills in this repo
  • Hig Project Context

    raintree-technology/hig-doctor

    Create or update a shared Apple design context document that other HIG skills use to tailor guidance.

    143 GitHub starsUsed in 5 repos~1.2k tokens
    Auto-check passed
  • Hig Components Content

    raintree-technology/hig-doctor

    Apple Human Interface Guidelines for content display components.

    143 GitHub starsUsed in 5 repos~1.3k tokens
    Auto-check passed
  • Hig Components Controls

    raintree-technology/hig-doctor

    Apple HIG guidance for selection and input controls including pickers, toggles, sliders, steppers, segmented controls, combo boxes, text fields, text views, labels, token fields, virtual keyboards…

    143 GitHub starsUsed in 5 repos~1.3k tokens
    Auto-check passed
  • Hig Components Dialogs

    raintree-technology/hig-doctor

    Apple HIG guidance for presentation components including alerts, action sheets, popovers, sheets, and digit entry views.

    143 GitHub starsUsed in 5 repos~1.1k tokens
    Auto-check passed
  • Hig Components Layout

    raintree-technology/hig-doctor

    Apple Human Interface Guidelines for layout and navigation components.

    143 GitHub starsUsed in 5 repos~1.6k tokens
    Auto-check passed
  • Hig Components Menus

    raintree-technology/hig-doctor

    Apple HIG guidance for menu and button components including menus, context menus, dock menus, edit menus, the menu bar, toolbars, action buttons, pop-up buttons, pull-down buttons, disclosure…

    143 GitHub starsUsed in 5 repos~1.1k tokens
    Auto-check passed

Works with

Categories

Questions about Hig Platforms

What does Hig Platforms do?

Apple Human Interface Guidelines for platform-specific design. Hig Platforms is an agent skill from raintree-technology/hig-doctor. Apple Human Interface Guidelines for platform-specific design.

When should I use Hig Platforms?

Hig Platforms fits situations like: the user asks about designing for iOS; IPad app design; platform differences; platform-specific conventions.

How do I install Hig Platforms in Claude Code?

Run `npx skills add raintree-technology/hig-doctor --skill hig-platforms -a claude-code`. Or copy the skill folder (skills/hig-platforms in raintree-technology/hig-doctor) into .claude/skills/hig-platforms in your project. Claude Code loads it when a task matches its description.

How do I install Hig Platforms in Codex?

Run `npx skills add raintree-technology/hig-doctor --skill hig-platforms -a codex`. Or copy the skill folder (skills/hig-platforms in raintree-technology/hig-doctor) into .agents/skills/hig-platforms in your project. Codex loads it when a task matches its description.

Can I use Hig Platforms in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add raintree-technology/hig-doctor --skill hig-platforms -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hig-platforms, .gemini/skills/hig-platforms, .github/skills/hig-platforms and .opencode/skills/hig-platforms in your project.

What does Hig Platforms need to run?

SKILL.md names no scripts, command-line tools or credentials: Hig Platforms is instructions for the agent only.

Does Hig Platforms access the network?

SKILL.md names 1 domain. As links in the text: raintree.technology. This is read from the text; nothing was executed.

Is Hig Platforms safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Hig Platforms use?

Hig Platforms is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hig Platforms use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4k tokens, read only when the agent opens those files.

What are the alternatives to Hig Platforms?

Skills that share tags, products or a category with Hig Platforms: Orca iOS Simulator Control (stablyai/orca, 88k stars), Apple Crash Log .NET Symbolication (dotnet/skills, 5.6k stars), Swiftui Expert Skill (omarshahine/HomeClaw, 175 stars) and Phoneagent (rounak/PhoneAgent, 799 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hig Platforms?

raintree-technology (a GitHub organization) maintains it in raintree-technology/hig-doctor, which has 143 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 11, 2026.

Source: raintree-technology/hig-doctor on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.