Provides Apple Human Interface Guidelines as contextual skills for designing and building Apple platform interfaces across iOS, macOS, visionOS, watchOS, and tvOS, covering components, patterns, inputs, technologies, and platform conventions.
Apple Human Interface Guidelines for content display components. Use this skill when the user asks about "charts component", "collection view", "image view", "web view", "color well", "image well", "activity view", "lockup", "data visualization", "content display", displaying images, rendering web content, color pickers, or presenting collections of items in Apple apps. Also use when the user says "how should I display charts", "what's the best way to show images", "should I use a web view", "how do I build a grid of items", "what component shows media", or "how do I present a share sheet". Cross-references: hig-foundations for color/typography/accessibility, hig-patterns for data visualization patterns, hig-components-layout for structural containers, hig-platforms for platform-specific component behavior.
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, rating indicators, and gauges. Use this skill when the user says "picker or segmented control," "how should my form look," "what keyboard type should I use," "toggle vs checkbox," or asks about picker design, toggle, switch, slider, stepper, text field, text input, segmented control, combo box, label, token field, virtual keyboard, rating indicator, gauge, form design, input validation, or control state management. Cross-references: hig-components-menus, hig-components-dialogs, hig-components-search.
Apple HIG guidance for presentation components including alerts, action sheets, popovers, sheets, and digit entry views. Use this skill when the user says "should I use an alert or a sheet," "how do I show a confirmation dialog," "when should I use a popover," "my modals are annoying users," or asks about alert design, action sheet, popover, sheet, modal, dialog, digit entry, confirmation dialog, warning dialog, modal presentation, non-modal content, destructive action confirmation, or overlay UI patterns. Cross-references: hig-components-menus, hig-components-controls, hig-components-search, hig-patterns.
Apple Human Interface Guidelines for layout and navigation components. Use this skill when the user asks about "sidebar", "split view", "tab bar", "tab view", "scroll view", "window design", "panel", "list view", "table view", "column view", "outline view", "navigation structure", "app layout", "boxes", "ornaments", or organizing content hierarchically in Apple apps. Also use when the user says "how should I organize my app", "what navigation pattern should I use", "my layout breaks on iPad", "how do I build a sidebar", "should I use tabs or a sidebar", or "my app doesn't adapt to different screen sizes". Cross-references: hig-foundations for layout/spacing principles, hig-platforms for platform-specific navigation, hig-patterns for multitasking and full-screen, hig-components-content for content display.
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 controls, and standard buttons. Use this skill when the user says "how should my buttons look," "what goes in the menu bar," "should I use a context menu or action sheet," "how do I design a toolbar," or asks about button design, menu design, context menu, toolbar, menu bar, action button, pop-up button, pull-down button, disclosure control, dock menu, edit menu, or any menu/button component layout and behavior. Cross-references: hig-components-search, hig-components-controls, hig-components-dialogs.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Agent-native Apple Human Interface Guidelines: a structured skills corpus, MCP server, and universal compliance auditor for AI coding agents and developers.
hig_list_skills, hig_lookup, and hig_audit for Claude Desktop, Cursor, Windsurf, and Claude Code.Content is © Apple Inc.; this repository provides organization, cross-referencing, and detection rules for AI agent use. MIT-licensed for structure and tooling.
Production logo files and usage guidance are available in brand/.
/plugin marketplace add raintree-technology/hig-doctor
Or add as a git submodule into any project's .claude/ directory.
Expose the skills and audit tool to any MCP-compatible client.
# From a git clone of this repo
bun packages/hig-doctor/src-mcp/src/index.ts
Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"hig-doctor": {
"command": "bun",
"args": ["/absolute/path/to/hig-doctor/packages/hig-doctor/src-mcp/src/index.ts"]
}
}
}
Tools:
| Tool | Purpose |
|---|---|
hig_list_skills | Enumerate skills, descriptions, and reference topics. |
hig_lookup | Fetch HIG reference markdown by skill (and optional topic). |
hig_audit | Run the HIG compliance audit on a project directory. |
Set HIG_SKILLS_DIR if you relocate the skills/ folder.
Scan any project for Apple HIG compliance. Works with SwiftUI, UIKit, React, Next.js, Vue, Nuxt, Svelte, SvelteKit, Angular, React Native, Flutter, Jetpack Compose, Android XML, and plain HTML/CSS. Detects 348 patterns across accessibility, color systems, typography, responsive layout, dark mode, motion, i18n, and more.
Requires Bun.
cd packages/hig-doctor/src-termcast
bun run audit <directory>
Example output:
HIG Audit: my-app 2 serious
nextjs · 412 detections · 48 files
────────────────────────────────────────────────────────────────────
Foundations 312 ██████████████░░░░░░ 286 good 2 serious
Layout & Navigation 41 ████░░░░░░░░░░░░░░░░ 9 good
Controls 24 ░░░░░░░░░░░░░░░░░░░░
Input Methods 15 ██████████████░░░░░░ 11 good
────────────────────────────────────────────────────────────────────
Totals 412 306 good 2 serious 4 moderate
Serious issues found — Significant HIG violations degrade UX.
| Flag | Description |
|---|---|
--export | Write a full audit report to <directory>/hig-audit.md |
--stdout | Print raw audit markdown to stdout (pipe to an AI for evaluation) |
--json | Print structured results as JSON (for CI/scripts) |
--fail-on <severity> | Exit 1 if any concern at/above critical, serious, or moderate is found |
--help | Show help |
Concerns are classified as:
user-scalable=no, <video> without captions, etc.)div with onClick and no role, positive tabindex, outline: none outside progressive enhancement, onTapGesture without traits, hover-without-focus, autoplay, etc.)!important usage, physical text-align, etc.)npx claudepluginhub raintree-technology/hig-doctor --plugin apple-hig-skillsPull server-rendered web content from any URL into Claude Code. Indexes sites in seconds with conditional-GET caching, then exposes them as MCP tools (fetch_url, ensure_docs, list_sources, list_indexed, grep_docs, read_doc, add_source, remove_source). Local, browser-free, no API keys.
Pull docs from any URL into Claude Code. Indexes static docs sites in seconds with conditional-GET caching, then exposes them as MCP tools (fetch_url, ensure_docs, list_sources, list_indexed, grep_docs, read_doc, add_source, remove_source). Local, browser-free, no API keys.
Editorial "Apple Platform Design" bundle for Claude Code from Antigravity Awesome Skills.
Apple development skills for Claude Code and Codex — iOS 26+ APIs, SwiftUI, UIKit, Liquid Glass, SwiftData, and more.
Claude skill for applying Apple macOS design guidelines and Human Interface Guidelines. For iOS and macOS app designers building platform-compliant interfaces.
Evaluates code against Apple's App Store Review Guidelines for iOS, macOS, tvOS, watchOS, and visionOS apps
Platform accessibility guidance for SwiftUI, UIKit, and AppKit UI tasks, audits, and Nutrition Label readiness.
Guide for preparing iOS apps for App Store submission with automated preflight checks and compliance verification.