Apple HIG guidance for input methods and interaction patterns: gestures, Apple Pencil, keyboards, game controllers, pointers, Digital Crown, eye tracking, focus system, remotes, spatial…

MITAuto-check passedMobile

Install Hig Inputs

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

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

GitHub CLI
$ gh skill install raintree-technology/hig-doctor hig-inputs --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-inputs .claude/skills/hig-inputs && 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-inputs
GitHub stars
143
Used in
5 other repos
Token cost
~1.5k tokens
SKILL.md length
579 words
Files
14 (incl. references)
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Apple HIG guidance for input methods and interaction patterns: gestures, Apple Pencil, keyboards, game controllers, pointers, Digital Crown, eye tracking, focus system, remotes, spatial…

  • Works in 12 steps: Support multiple input methods. Touch,… → Consistent feedback for every input… → Standard gestures must behave… → …
  • Asked about: gesture design
  • SKILL.md covers Key Principles, Reference Index, Output Format and Questions to Ask, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hig Inputs is an agent skill from raintree-technology/hig-doctor. Apple HIG guidance for input methods and interaction patterns: gestures, Apple Pencil, keyboards, game controllers, pointers, Digital Crown, eye tracking, focus system, remotes, spatial interactions, gyroscope, accelerometer, and nearby interactions. Use when asked about: "gesture design", "Apple Pencil", "keyboard shortcuts", "game controller", "pointer support", "mouse support", "trackpad", "Digital Crown", "eye tracking", "visionOS input", "focus system", "remote control", "gyroscope", "spatial interaction"…

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 14 other files, including reference files (for example `references/apple-pencil-and-scribble.md`, `references/camera-control.md` and `references/digital-crown.md`).

It sits in Mobile, covering iOS development and Text to speech and voice. 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

  • Asked about: gesture design
  • Keyboard shortcuts
  • Game controller
  • Pointer support

Example prompts

  • “gesture design”
  • “Apple Pencil”
  • “keyboard shortcuts”
  • “/hig-inputs”

Workflow steps

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

  1. Support multiple input methods. Touch, pointer, keyboard, pencil, voice, eyes, hands, controllers. Design for the inputs available on each…
  2. Consistent feedback for every input action. Visible, audible, or haptic response.
  3. Standard gestures must behave consistently. Tap to activate, swipe to scroll/navigate, pinch to zoom, long press for context menus, drag…
  4. Use standard recognizers; keep custom gestures discoverable. Apple's built-in recognizers handle edge cases and accessibility. If you add…
  5. Apple Pencil: precision drawing, markup, and selection. Support pressure, tilt, and hover. Distinguish finger from Pencil when appropriate…
  6. Support Scribble in text fields. Users expect to write with Pencil in any text input.
  7. Keyboard shortcuts and full navigation. Standard shortcuts (Cmd+C/V/Z) plus custom ones visible in the iPadOS Command key overlay. Logical…
  8. Respect the software keyboard. Adjust layout when keyboard appears. Use keyboard-avoidance APIs.
  9. Game controllers: MFi controllers with on-screen fallbacks. Map to extended gamepad profile, sensible defaults, remappable. Always offer…
  10. Pointer and trackpad: native feel. Hover effects, pointer shape adaptation, standard cursor behaviors. Two-finger scroll, pinch to zoom…
  11. Digital Crown: primary scrolling and value-adjustment input on watchOS. Scrolling lists, adjusting values, navigating views. Haptic…
  12. Eyes and spatial (visionOS): look and pinch. Generous hit targets (eye tracking is less precise than touch). Avoid sustained gaze for…

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 Inputs loads about 1.5k tokens when it runs, and up to ~7.9k if it reads all its reference files. Until then it costs about 209 tokens; SKILL.md has 579 words of instructions outside code blocks.

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

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). 579 words, ~1,541 tokens.

Download SKILL.mdSave it as .claude/skills/hig-inputs/SKILL.md (or your agent's skills folder). This skill also uses 13 other files; get the full folder from GitHub.
name
hig-inputs
description
Apple HIG guidance for input methods and interaction patterns: gestures, Apple Pencil, keyboards, game controllers, pointers, Digital Crown, eye tracking, focus system, remotes, spatial interactions, gyroscope, accelerometer, and nearby interactions. Use when asked about: "gesture design", "Apple Pencil", "keyboard shortcuts", "game controller", "pointer support", "mouse support", "trackpad", "Digital Crown", "eye tracking", "visionOS input", "focus system", "remote control", "gyroscope", "spatial interaction". Also use when the user says "what gestures should I support," "how do I add keyboard shortcuts," "how does input work on Apple TV," "should I support Apple Pencil," or asks about input device handling. Cross-references: hig-components-status, hig-components-system, hig-technologies for VoiceOver and Siri.
version
1.0.0

Apple HIG: Inputs

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

Key Principles

  1. Support multiple input methods. Touch, pointer, keyboard, pencil, voice, eyes, hands, controllers. Design for the inputs available on each platform. On iPadOS, support both touch and pointer; on macOS, both pointer and keyboard.

  2. Consistent feedback for every input action. Visible, audible, or haptic response.

  3. Standard gestures must behave consistently. Tap to activate, swipe to scroll/navigate, pinch to zoom, long press for context menus, drag to move. Don't override system gestures (edge swipes for back, Home, notifications).

  4. Use standard recognizers; keep custom gestures discoverable. Apple's built-in recognizers handle edge cases and accessibility. If you add non-standard gestures, provide hints or coaching to teach them.

  5. Apple Pencil: precision drawing, markup, and selection. Support pressure, tilt, and hover. Distinguish finger from Pencil when appropriate (finger pans, Pencil draws).

  6. Support Scribble in text fields. Users expect to write with Pencil in any text input.

  7. Keyboard shortcuts and full navigation. Standard shortcuts (Cmd+C/V/Z) plus custom ones visible in the iPadOS Command key overlay. Logical tab order.

  8. Respect the software keyboard. Adjust layout when keyboard appears. Use keyboard-avoidance APIs.

  9. Game controllers: MFi controllers with on-screen fallbacks. Map to extended gamepad profile, sensible defaults, remappable. Always offer touch or keyboard alternatives.

  10. Pointer and trackpad: native feel. Hover effects, pointer shape adaptation, standard cursor behaviors. Two-finger scroll, pinch to zoom, swipe to navigate.

  11. Digital Crown: primary scrolling and value-adjustment input on watchOS. Scrolling lists, adjusting values, navigating views. Haptic feedback at detents.

  12. Eyes and spatial (visionOS): look and pinch. Generous hit targets (eye tracking is less precise than touch). Avoid sustained gaze for activation. Direct hand manipulation in immersive experiences.

  13. Focus system: critical for tvOS and visionOS. Predictable focus movement. Every interactive element focusable. Clear visual indicators (scale, highlight, elevation). Logical focus groups.

  14. Siri Remote: limited surface. Touch area for swiping, clickpad for selection, few physical buttons. Keep interactions simple.

  15. Gyroscope, accelerometer, UWB: use judiciously. Suits gaming, fitness, AR. Not for essential tasks. Provide calibration and reset. For UWB, communicate distance and direction with visual or haptic cues.

Show full SKILL.md (212 more words)Show less

Reference Index

ReferenceTopicKey content
gestures.mdTouch gesturesTap, swipe, pinch, long press, drag, system gestures
apple-pencil-and-scribble.mdApple PencilPrecision, pressure, tilt, hover, handwriting
keyboards.mdKeyboardsShortcuts, navigation, software keyboard, Command key
game-controls.mdGame controllersMFi, extended gamepad, remapping, fallbacks
pointing-devices.mdPointer/trackpadHover, cursor morphing, trackpad gestures
digital-crown.mdDigital CrownScrolling, value adjustment, haptic detents
eyes.mdEye trackingLook and tap, gaze targeting, hit target sizing
spatial-interactions.mdSpatial inputHand gestures, direct manipulation, immersive input
focus-and-selection.mdFocus systemtvOS/visionOS navigation, focus indicators, groups
remotes.mdRemotesTouch surface, clickpad, simple interactions
gyro-and-accelerometer.mdMotion sensorsGyroscope, accelerometer, calibration, gaming
nearby-interactions.mdNearby interactionsU1 chip, directional finding, proximity triggers
camera-control.mdCamera ControliPhone camera hardware button, quick launch

Output Format

  1. Input method recommendations by platform and how they interact.
  2. Gesture specification table -- standard and custom gestures with expected behaviors.
  3. Keyboard shortcut recommendations following system conventions.
  4. Accessibility input alternatives for VoiceOver, Switch Control, etc.

Questions to Ask

  1. Which platforms and input devices?
  2. Productivity or casual app?
  3. Custom gestures in the design?
  4. Game controller support needed?
  • hig-components-status -- Progress indicators responding to input (pull-to-refresh)
  • hig-components-system -- System experiences with unique input constraints
  • hig-technologies -- VoiceOver, Siri voice input, ARKit spatial gesture context

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 13 other files (references) in skills/hig-inputs of raintree-technology/hig-doctor.

  • SKILL.md
  • references/apple-pencil-and-scribble.md
  • references/camera-control.md
  • references/digital-crown.md
  • references/eyes.md
  • references/focus-and-selection.md
  • references/game-controls.md
  • references/gestures.md
  • references/gyro-and-accelerometer.md
  • references/keyboards.md
  • references/nearby-interactions.md
  • references/pointing-devices.md
  • references/remotes.md
  • references/spatial-interactions.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 Inputs 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 Inputs compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hig Inputs this skillraintree-technology/hig-doctor1435 repos~1.5kAutomated safety check: PassMIT
iOS Accessibilitydpearson2699/swift-ios-skills1.2k—~4.6kAutomated safety check: PassCustom licence
Orca iOS Simulator Controlstablyai/orca87k1 repos~584Automated safety check: PassApache-2.0
Apple Crash Log .NET Symbolicationdotnet/skills5.6k1 repos~2.4kAutomated safety check: PassMIT
Swiftui Expert Skillomarshahine/HomeClaw1764 repos~2.8kAutomated safety check: PassMIT
Phoneagentrounak/PhoneAgent798—~2.2kAutomated safety check: PassMIT

Similar skills

  • iOS Accessibility

    dpearson2699/swift-ios-skills

    Build and audit SwiftUI, UIKit, and AppKit accessibility for VoiceOver, Voice Control, Switch Control, Full Keyboard Access, Dynamic Type, focus restoration, labels/traits/actions, traversal, custom…

    1.2k GitHub stars~4.6k tokensUpdated 2 mo ago
    MobileAuto-check passed
  • 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…

    87k 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…

    176 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.

    798 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

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

Questions about Hig Inputs

What does Hig Inputs do?

Apple HIG guidance for input methods and interaction patterns: gestures, Apple Pencil, keyboards, game controllers, pointers, Digital Crown, eye tracking, focus system, remotes, spatial…. Hig Inputs is an agent skill from raintree-technology/hig-doctor. Apple HIG guidance for input methods and interaction patterns: gestures, Apple Pencil, keyboards, game controllers, pointers, Digital Crown, eye tracking, focus system, remotes, spatial interactions, gyroscope, accelerometer, and nearby interactions.

When should I use Hig Inputs?

Hig Inputs fits situations like: asked about: gesture design; keyboard shortcuts; game controller; pointer support.

How do I install Hig Inputs in Claude Code?

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

How do I install Hig Inputs in Codex?

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

Can I use Hig Inputs 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-inputs -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-inputs, .gemini/skills/hig-inputs, .github/skills/hig-inputs and .opencode/skills/hig-inputs in your project.

What does Hig Inputs need to run?

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

Does Hig Inputs 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 Inputs 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 Inputs use?

Hig Inputs 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 Inputs use?

About 1.5k tokens (SKILL.md is roughly 6.2k 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 6.4k tokens, read only when the agent opens those files.

What are the alternatives to Hig Inputs?

Skills that share tags, products or a category with Hig Inputs: iOS Accessibility (dpearson2699/swift-ios-skills, 1.2k stars), Orca iOS Simulator Control (stablyai/orca, 87k stars), Apple Crash Log .NET Symbolication (dotnet/skills, 5.6k stars) and Swiftui Expert Skill (omarshahine/HomeClaw, 176 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hig Inputs?

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.