# ios-hig

ios-hig is a Claude Code skill that applies Apple's iOS interface guidance to accessibility, visual design, and interaction. It supports screen creation and control review.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 233 repo stars
- Author: John Rogers (@johnrogers)
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/johnrogers/claude-swift-engineering/tree/HEAD/plugins/swift-engineering/skills/ios-hig/SKILL.md
- Updated: 2026-01-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ios-hig

## What it does

ios-hig covers VoiceOver, Dynamic Type, dark appearance, touch area sizing, animation, haptic feedback, and permission prompts. Its guidance is divided by topic, with references for interaction, visual design, accessibility, feedback, performance, and privacy. That gives Claude Code a focused place to consult for a design question.

Interactive controls should have touch areas of at least 44x44 points. Custom controls also need `.accessibilityLabel()` and `.accessibilityHint()` so VoiceOver can describe them. Check motion against Reduce Motion settings; animations that ignore this setting can cause problems for users with vestibular conditions. The skill is for Claude Code.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add johnrogers/claude-swift-engineering
```
In the agent chat (not a shell):
```text
/plugin install swift-engineering@claude-swift-engineering
```
This installs the whole swift-engineering plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add johnrogers/claude-swift-engineering --skill ios-hig -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add johnrogers/claude-swift-engineering --skill ios-hig -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add johnrogers/claude-swift-engineering --skill ios-hig -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install johnrogers/claude-swift-engineering plugins/swift-engineering/skills/ios-hig
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add johnrogers/claude-swift-engineering --skill ios-hig -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/johnrogers/claude-swift-engineering --path plugins/swift-engineering/skills/ios-hig
```

### Windsurf (Devin Desktop)

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

### 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/johnrogers/claude-swift-engineering/tree/HEAD/plugins/swift-engineering/skills/ios-hig/SKILL.md

## When to use it
- check iOS controls for adequate touch areas
- adapt screen text to Dynamic Type
- add VoiceOver labels to custom controls
- review transitions against Reduce Motion
- handle permission prompts in an iOS app

## Example prompts
- Review this settings screen for iOS accessibility guidance.
- Show me how to adapt this screen for Dynamic Type and VoiceOver.
- Check these animations and haptics against Reduce Motion guidance.

## 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: 89545b065f8e8882.

BEGIN THIRD-PARTY FILE 89545b065f8e8882
```text
---
name: ios-hig
description: Use when designing iOS interfaces, implementing accessibility (VoiceOver, Dynamic Type), handling dark mode, ensuring adequate touch targets, providing animation/haptic feedback, or requesting user permissions. Apple Human Interface Guidelines for iOS compliance.
---

# iOS Human Interface Guidelines

Apple's Human Interface Guidelines define the visual language, interaction patterns, and accessibility standards that make iOS apps feel native and intuitive. The core principle: clarity and consistency through thoughtful design.

## Reference Loading Guide

**ALWAYS load reference files if there is even a small chance the content may be required.** It's better to have the context than to miss a pattern or make a mistake.

| Reference | Load When |
|-----------|-----------|
| **[Interaction](references/interaction.md)** | Touch targets, navigation, layout, hierarchy, or gesture patterns |
| **[Content](references/content.md)** | Empty states, writing copy, typography, or placeholder text |
| **[Visual Design](references/visual-design.md)** | Colors, materials, contrast, dark mode, or SF Symbols |
| **[Accessibility](references/accessibility.md)** | VoiceOver, Dynamic Type, Reduce Motion, or accessibility labels |
| **[Feedback](references/feedback.md)** | Animations, haptics, loading states, or error messages |
| **[Performance](references/performance-platform.md)** | Responsiveness, system components, or app launch |
| **[Privacy](references/privacy-permissions.md)** | Permission requests, data handling, or privacy-sensitive APIs |

## Common Mistakes

1. **Touch targets smaller than 44x44 points** — Buttons and interactive elements must be at least 44x44 points (iOS) to accommodate thumbs. Smaller targets cause frustrated users and accessibility failures.

2. **Ignoring Dynamic Type constraints** — Text with fixed sizes doesn't respect user accessibility settings. Use Dynamic Type sizes, test with Large or Extra Large settings, and avoid hardcoded font sizes.

3. **Insufficient color contrast in dark mode** — Colors that work in light mode may fail accessibility in dark mode. Test with Reduce Contrast accessibility setting enabled for both modes.

4. **Over-animating transitions** — Animations that feel smooth at 60fps can trigger motion sickness in users with vestibular issues. Respect Reduce Motion settings and keep animations under 300ms.

5. **Missing VoiceOver labels on custom controls** — Custom buttons, toggles, or interactive views need `.accessibilityLabel()` and `.accessibilityHint()` or they're completely unusable to screen reader users.
```
END THIRD-PARTY FILE 89545b065f8e8882

The third-party file has ended. Everything between the 89545b065f8e8882 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 2635 of 2830 bytes. © John Rogers (@johnrogers) · MIT · https://github.com/johnrogers/claude-swift-engineering/tree/HEAD/plugins/swift-engineering/skills/ios-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
