Skip to main content
skill CX Codex

ios-hig · johnrogers — Claude Code skill for iOS interfaces

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.

MIT ★ 233 updated 2026-01-18

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Open on GitHub

What ios-hig 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.

What it helps with

  • 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 for the agent

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

How to install ios-hig

1Plugin marketplace

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

This installs the whole swift-engineering plugin with all its skills

2Skills CLI (Vercel)

npx skills add johnrogers/claude-swift-engineering --skill ios-hig -a claude-code

3Manually: put the files in place

~/.claude/skills/ios-hig/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ios-hig/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ios-hig

How do I install ios-hig in Claude Code?

Run /plugin marketplace add johnrogers/claude-swift-engineering, then run /plugin install swift-engineering@claude-swift-engineering.

What does ios-hig do?

It guides iOS interface work around Apple’s recommendations for accessibility, appearance, and interaction, including VoiceOver, dark mode, and permission prompts.

What touch area size does ios-hig recommend?

Buttons and other interactive elements should have touch areas of at least 44x44 points.

Source text

SKILL.md · MIT
---
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.

6. **Haptic overuse** — Every action does NOT need haptic feedback. Reserve haptics for confirmations (purchase, critical action) and errors. Excessive haptics are annoying and drain battery.

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

Similar skills

All skills for Mobile →

ios-hig by other authors comes first.

ios-hig pproenca ios-hig — a skill with 34 Apple HIG rules for iOS 26 and Swift 6.2 apps: navigation, gestures, accessibility, loading and error states in SwiftUI. CX Codex +1 310installs ios-hig-design wondelai ios-hig-design is a Claude Code skill for designing native iOS interfaces according to Apple's Human Interface Guidelines, covering safe areas, typography, color, navigation, and SF Symbols. CX Codex +1 9,200installs expo-ios-hig pproenca expo-ios-hig is a Claude Code skill with Apple Human Interface Guidelines rules for screens, components, and navigation in Expo and React Native. CX Codex +1 169installs ios-hig-design-guide davepoon ios-hig-design-guide is a Claude Code skill that turns Apple Human Interface Guidelines into specs for iOS features. It activates for questions about UI rules, accessibility, components, or interaction patterns. CX Codex +1 133installs apple-hig nexu-io apple-hig integrates Apple Human Interface Guidelines for iOS, macOS, visionOS, watchOS, and tvOS into your coding agent during planning. CX Codex +1 3,500installs apple-hig-designer jamesrochabrun apple-hig-designer generates native iOS interfaces for iPhone, iPad, and Apple Watch following Apple Human Interface Guidelines. It formats SwiftUI components and validates accessibility. CX Codex +1 1,100installs hig Prisma-Labs-Dev hig is a Claude Code skill that searches a local Markdown reference for Apple HIG facts, including touch targets, Dynamic Type, and system components. It supports checks without network access. CX Codex +1 1,000installs

From the same set33

The whole set →
swift-documenter swift-documenter is a Claude Code subagent that creates and updates README files and Swift doc comments after a feature is finished or during package documentation revisions. CX Codex ★ 233repo stars swift-modernizer The swift-modernizer subagent updates legacy Swift code toward async/await, modern APIs, and SwiftUI. Use it to plan and verify incremental migrations in an existing project. CX Codex ★ 233repo stars reflect reflect is a Claude Code command that reviews chat context and project settings, then suggests changes to instructions, commands, and configuration. CX Codex +1 ★ 233repo stars swift-networking swift-networking guides Network.framework implementation in Swift, handling low-level TCP and UDP traffic, concurrency queues, and connection state transitions. CX Codex +1 ★ 233repo stars swift-engineer swift-engineer — a Claude subagent that writes vanilla Swift for models, services, networking and persistence when the plan rules out TCA. CX Codex ★ 233repo stars grdb Guides Claude Code in writing direct SQLite queries, schema migrations, and reactive observations with GRDB.swift on iOS and macOS. CX Codex +1 ★ 233repo stars swift-diagnostics The swift-diagnostics skill guides investigations into navigation, build, and memory issues in iOS and macOS projects. Use it to follow diagnostic checks before changing code. CX Codex +1 ★ 233repo stars localization Walks the agent through iOS localization: String Catalogs, plural forms, locale-aware formats and right-to-left layout. CX Codex +1 ★ 233repo stars

Project sponsors

Companies that keep this analytics open