Agent skill · design visual · alirezarezvani
apple-hig-expert
Use when designing or reviewing iOS, macOS, watchOS or visionOS UI against Apple's Human Interface Guidelines, including Liquid Glass, contrast and tap targets. Checks it with hig_checker.py.
Why this skill is useful
Provides a specialized compliance tool and domain-specific knowledge for auditing Apple platform interfaces against the latest HIG, which the AI wouldn't reliably generate on its own.
What it needs
Requires python3 installed locally. About 3k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
Apple HIG Expert Design and audit apps against the Apple Human Interface Guidelines (HIG, developer.apple.com/design/human-interface-guidelines), including the Liquid Glass design language. HIG content evolves with each OS release — when a claim matters, verify against the live HIG pages cited in references/. Before Starting If product-context.md or ios-design-context.md exists, read it before asking questions. Then gather: 1. Platform target: iOS, macOS, watchOS, or visionOS? 2. Current state: new design or auditing an existing mockup/code? 3. App category: utility, productivity, game, social, etc. Modes Mode 1 — Design from scratch: pick the platform navigation paradigm and layout primitives first (see references/platform-specifics.md), then apply typography and semantic color (references/visual-design.md). Mode 2 — HIG audit: fill in templates/hig-audit-template.md, run scripts/higchecker.py on every measurable element, and deliver a scored report (see Worked example below). The Compliance Tool scripts/higchecker.py (stdlib-only) has three subcommands: Batch input shape: Scorecard rubric: the batch score starts at 100 and subtracts 10 per failed check; violations are listed by element name. 90-100 = ship, 70-80 = fix before release, below 70 = systematic rework. Checks the tool cannot measure (VoiceOver labels, Dynamic Type behavior, Reduce Transparency) are assessed manually via the audit template and tagged with confidence. Worked example: iOS settings-screen audit Input: mockup with body text #1C1C1E and captions #8E8E93 on white cards, a 32x32 pt close button, and a 343x50 pt primary CTA. Run: Output (real): Findings → fixes (bottom line first): HIG score 80/100 — two fixes before release. 1. Captions fail contrast (3.26 < 4.5). Use .secondaryLabel (semantic color) instead of hardcoded #8E8E93, or darken to ≥ #6E6E73 on white. 🟢 verified by tool. 2. Close button is 32x32 pt (< 44x44 minimum). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/apple-hig-expert--c19375