apple-hig-skills

Apple HIG Skills

Apple Human Interface Guidelines as agent skills for Claude Code, Cursor, and other AI coding agents.

14 skills covering the complete Apple HIG — foundations, components, patterns, inputs, platforms, and technologies. Source: Apple Human Interface Guidelines (February 2025).

Install

npx skills add raintree-technology/apple-hig-skills

Or install via Claude Code plugin:

/plugin marketplace add raintree-technology/apple-hig-skills

HIG Audit

Audit 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 349 patterns across accessibility, color systems, typography, responsive layout, dark mode, motion, i18n, and more.

Requires Bun.

cd packages/hig-doctor/src-termcast
bun install
bun run audit <directory>

Example output:

  HIG Audit: website   100/100
  nextjs · 751 detections · 56 files

  ────────────────────────────────────────────────────────────────────
  Foundations                610  ███████████████████░  593 good
  Interaction Patterns        34  ███████████████████░  32 good
  Layout & Navigation         42  █████░░░░░░░░░░░░░░░  11 good
  Controls                    25  ░░░░░░░░░░░░░░░░░░░░
  Input Methods               17  ████████████████░░░░  14 good
  ────────────────────────────────────────────────────────────────────
  Totals                     751  650 good  101 patterns

  Excellent — Strong HIG compliance across the board.

Options

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)
--help	Show help

What it detects

The audit scans code, stylesheets, and config files, then categorizes findings across HIG areas:

• Foundations — semantic vs hardcoded colors, Dynamic Type vs fixed font sizes, dark mode, motion preferences, accessibility labels, focus management, heading hierarchy, landmark regions, touch targets, i18n/RTL support
• Layout & Navigation — navigation patterns, responsive breakpoints, semantic HTML, adaptive layout, sidebar/tab patterns
• Controls — buttons, toggles, form elements, interactive controls, labels
• Content Display — images, collections, tables, cards, accordions, lists
• Input Methods — keyboard support, gesture handling, form validation, input types, fieldset/legend, autocomplete
• Interaction Patterns — drag and drop, pull-to-refresh, undo, animations, haptics, error handling
• Dialogs & Presentations — modals, sheets, alerts, popovers, toasts, tooltips
• Menus & Actions — dropdown menus, context menus, toolbars, menu roles
• Search & Navigation — search fields, search roles, page controls
• Status & Progress — progress indicators, loading states, aria-busy
• Apple Technologies — WidgetKit, ActivityKit, HealthKit, ARKit, Apple Pay, Sign in with Apple

Accessibility anti-patterns detected: div/span with click handlers but no ARIA role, missing alt text, ambiguous link text ("click here"), empty headings/buttons, outline: none, positive tabindex, mouse-only handlers, autoplay media, user-scalable=no.

Context-aware rules: !important inside @media print and prefers-reduced-motion blocks is not flagged. outline: none inside :focus:not(:focus-visible) progressive enhancement is not flagged. Hover rules skip pseudo-element selectors like ::-webkit-scrollbar-thumb. Test/spec files are excluded from scanning.

Each detection is classified as a positive (good HIG practice), concern (potential violation), or pattern (neutral usage detected).

Supported frameworks