iOS HIG Design Skill (wondelai) for Claude Code: What It Does and How to Install It

Makes Claude design and review iPhone and iPad interfaces against Apple's Human Interface Guidelines, with a 10-point score.

Installs: 8.5K; on skills.sh
Stars: 2.6K; on GitHub
Files: 11; besides SKILL.md
Updated: Sep 2026; last repo commit

The skill is wondelai's own framework based on Apple's HIG, not an Apple product. It gives Claude 8 design areas (layout and safe areas, typography, color and Dark Mode, navigation, controls, accessibility, icons, gestures and haptics), a table of 8 common mistakes and a 6-row diagnostic.

When you ask for a review, SKILL.md tells Claude to state a score out of 10 and the specific changes needed to reach 10. It loads when you mention an iPhone app, SwiftUI, UIKit, Dynamic Island, SF Symbols or similar. The folder holds SKILL.md and 11 reference files, with no scripts.

Good for

iOS and SwiftUI developers who want an app to feel native
Designers checking layouts for safe areas, Dynamic Type and Dark Mode
Teams auditing an iOS interface for VoiceOver and touch-target problems

Install ios-hig-design

Claude Code

Copy this prompt.

Install the ios-hig-design skill in Claude Code. Run this command:

/plugin marketplace add wondelai/skills
/plugin install ux-design@wondelai-skills

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route. The ux-design plugin installs 11 skills (counted from the repo marketplace file); the skills CLI, folder and Claude app routes install only ios-hig-design. The folder holds markdown only, so it needs nothing else.

From the project README. Source.

What's in the skill

When it loads

Design native iOS interfaces following Apple Human Interface Guidelines. Use when the user mentions "iPhone app", "iPad layout", "SwiftUI", "UIKit", "Dynamic Island", "safe areas", "HIG compliance", "SF Symbols", "haptic feedback", "iOS accessibility", "make my app feel native", or "follow Apple design guidelines". Also trigger when building tab bars, navigation stacks, sheets, or modals for iOS, implementing dark mode, or adapting layouts across screen sizes. Covers navigation patterns, accessibility, SF Symbols, and platform conventions. For general UI polish, see refactoring-ui. For affordance design, see design-everyday-things.

Sections in SKILL.md

Core Principle
Scoring
iOS Design Framework
1. Layout & Safe Areas
2. Typography & Dynamic Type
3. Color & Dark Mode
4. Navigation Patterns
5. Controls & Inputs
6. Accessibility
7. Icons & Images
8. Gestures & Haptics
Common Mistakes
Quick Diagnostic
Beyond Core UI
Further Reading
About the Author

Key facts

Author: wondelai (SKILL.md metadata; repo owner is Wondel.ai)
Repo: wondelai/skills
License: MIT (SKILL.md, LICENSE and marketplace.json agree)
Installs on skills.sh: 8,524 (Nov 2, 2026)
GitHub stars: 2,560 for the whole repo (Nov 2, 2026)
Last repo commit: Sep 10, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: pass
What it includes: 13 files: SKILL.md and 11 reference files (markdown); no scripts
Part of: The ux-design plugin: 11 skills

What it includes

Rules for safe areas, 44pt touch targets and screen margins.
Reference: references/navigation.md.
Read · 1. Layout and safe areas
Semantic text styles that scale, with minimum sizes and line length.
Reference: references/typography.md.
Read · 2. Typography and Dynamic Type
Semantic system colors, contrast of 4.5:1 and testing both appearances.
Reference: references/colors-depth.md.
Read · 3. Color and Dark Mode
Tab bars, navigation stacks and modals; no hamburger menus.
Read · 4. Navigation patterns
Native controls, keyboard types and confirmation for destructive actions.
References: components.md and keyboard-input.md.
Read · 5. Controls and inputs
VoiceOver labels, Dynamic Type and not conveying meaning by color alone.
Reference: references/accessibility.md.
Read · 6. Accessibility
SF Symbols and the 1024px app icon with the system mask.
Reference: references/app-icons.md.
Read · 7. Icons and images
Gestures never to override and the three haptic types.
Reference: references/gestures.md.
Read · 8. Gestures and haptics
Scores a design out of 10 and lists the changes needed to reach 10.
Six points come from the Quick Diagnostic rows and up to four from native idiom.
Try: “Review this SwiftUI screen against the HIG”
Scoring
A table of 8 mistakes and a 6-question audit with fixes.
Read · Common mistakes and Quick Diagnostic
Three references: privacy permissions, widgets and extensions, system integration.
Files: privacy-permissions.md, widgets-extensions.md and system-integration.md.
Read · Beyond core UI

From the official docs

Questions

What does the ios-hig-design skill do?

It makes Claude design or review iOS interfaces using Apple's Human Interface Guidelines. It covers safe areas, Dynamic Type, Dark Mode, navigation, controls, accessibility, SF Symbols and gestures, and gives a score out of 10.

Is this Apple's skill?

No. It is wondelai's skill, based on Apple's Human Interface Guidelines. SKILL.md links Apple's guidelines as the full reference.

How do I install it?

Use the install box at the top of this page. The README documents a Claude Code plugin called ux-design that holds this skill and 10 others, and a skills CLI command for this skill alone.

Does it work in the Claude app?

The install box has a Claude app upload route for the ios-hig-design folder. The folder holds only SKILL.md and 11 reference files, with no scripts.

Does it work in Codex?

The README says the skills CLI commands target Codex too and that every skill works in Codex CLI. The install box has a Codex tab.

Does it need an API key?

SKILL.md names no API key and the folder bundles no scripts.

Is it safe?

The folder holds markdown only. It shapes Claude's design advice and any SwiftUI or UIKit code Claude writes, so review that code as usual. SKILL.md's Further Reading section links to Amazon books with an affiliate tag in the URL.

ios-hig-design vs refactoring-ui?

SKILL.md says to use refactoring-ui for general UI polish and design-everyday-things for affordance design. This skill is for native iOS conventions.

Information

updated Nov 2, 2026

Repository: wondelai/skills
Folder: ios-hig-design

wondelai/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

wondelai/skills README · github.com
wondelai/skills marketplace.json · github.com
ios-hig-design SKILL.md · github.com