# hig

A local Markdown reference for Apple Human Interface Guidelines to check touch targets, Dynamic Type, system components, and App Review rules on demand.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 786 installs · ★ 349
- Author: Prisma-Labs-Dev
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Prisma-Labs-Dev/apple-skills/tree/HEAD/skills/hig/SKILL.md
- Updated: 2026-09-26
- HTML: https://affpapa.org/en/nevibecode/skills/hig

## What it does

This skill provides a local, greppable Markdown corpus of Apple's Human Interface Guidelines. It keeps reference files for layouts, typography, safe areas, and system components directly on disk. Searching happens locally via `grep` without making network calls.

The reference answers strictly factual questions about system capabilities and App Review checks. It never dictates screen aesthetics or visual taste. You get exact values like 44pt touch targets, Dynamic Type behaviors, system button styles, and haptic feedback types.

When a topic is missing locally, the skill checks other Apple skills or queries the `sosumi.ai` Markdown mirror. This preserves context window tokens.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Prisma-Labs-Dev/apple-skills --skill hig -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/hig/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/hig/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Prisma-Labs-Dev/apple-skills --skill hig -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/hig/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Prisma-Labs-Dev/apple-skills --skill hig -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/hig/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Prisma-Labs-Dev/apple-skills hig
```

2. **Manually: put the files in place**
- File: `.github/skills/hig/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Prisma-Labs-Dev/apple-skills --skill hig -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Prisma-Labs-Dev/apple-skills --path skills/hig
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/hig/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Prisma-Labs-Dev/apple-skills --skill hig -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Prisma-Labs-Dev/apple-skills/tree/HEAD/skills/hig/SKILL.md

## When to use it
- Look up touch target minimums for iOS interactive elements
- Check Dynamic Type scaling and accessibility contrast requirements
- Verify layout boundaries around the Dynamic Island and home indicator
- Select standard UIKit button styles for interface components
- Choose appropriate haptic feedback patterns for user actions

## Example prompts
- Check HIG for the minimum hit target size on iOS navigation buttons.
- Show the available system button styles in iOS and their default behaviors.
- What haptic feedback pattern does Apple recommend for an error notification?

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: a569bc1fc6b21344.

BEGIN THIRD-PARTY FILE a569bc1fc6b21344
```text
---
name: hig
user-invocable: true
description: "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."
context: fork
agent: Explore
---

# 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](hig-index.md) | Full HIG table of contents | 11KB |
| [designing-for-ios.md](designing-for-ios.md) | iOS design principles | 5KB |

### Foundations

| File | Content | Size |
|------|---------|------|
| [app-icons.md](app-icons.md) | App icon design guidelines | 14KB |
| [color.md](color.md) | Color usage and system colors | 17KB |
| [typography.md](typography.md) | Fonts, text styles, Dynamic Type | 17KB |
| [layout.md](layout.md) | Layout principles, safe areas | 21KB |
| [materials.md](materials.md) | Materials, blur effects, vibrancy | 14KB |
| [motion.md](motion.md) | Animation principles | 9KB |
| [accessibility.md](accessibility.md) | Accessibility best practices | 19KB |
| [sf-symbols.md](sf-symbols.md) | SF Symbols usage | 21KB |

### Patterns

| File | Content | Size |
|------|---------|------|
| [onboarding.md](onboarding.md) | Onboarding flows | 6KB |
| [modality.md](modality.md) | Modal presentations | 7KB |
| [launching.md](launching.md) | App launch experience | 6KB |
| [feedback.md](feedback.md) | User feedback patterns | 5KB |
| [playing-haptics.md](playing-haptics.md) | Haptic feedback | 10KB |
| [searching.md](searching.md) | Search patterns | 7KB |
| [settings.md](settings.md) | Settings patterns | 7KB |

### Components - Navigation

| File | Content | Size |
|------|---------|------|
| [tab-bars.md](tab-bars.md) | Tab bar design | 11KB |
| [navigation-bars.md](navigation-bars.md) | Navigation bar patterns | 17KB |
| [toolbars.md](toolbars.md) | Toolbar design | 17KB |
| [sidebars.md](sidebars.md) | Sidebar patterns | 8KB |

### Components - Presentation

| File | Content | Size |
|------|---------|------|
| [sheets.md](sheets.md) | Sheet presentations | 11KB |
| [alerts.md](alerts.md) | Alert dialogs | 10KB |
| [action-sheets.md](action-sheets.md) | Action sheets | 4KB |
| [menus.md](menus.md) | Menu design | 14KB |

### Components - Controls

| File | Content | Size |
|------|---------|------|
```
END THIRD-PARTY FILE a569bc1fc6b21344

The third-party file has ended. Everything between the a569bc1fc6b21344 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3090 of 6523 bytes. © Prisma-Labs-Dev · MIT · https://github.com/Prisma-Labs-Dev/apple-skills/tree/HEAD/skills/hig/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md