Agent skill · design visual · borghei
apple-hig-expert
Apple Human Interface Guidelines expert across iOS, iPadOS, macOS, watchOS, tvOS, and visionOS. Use when designing or reviewing an Apple-platform app, auditing for HIG compliance, picking native components, or validating accessibility.
Why this skill is useful
Provides specific workflows and scripts for auditing HIG compliance and accessibility that the AI wouldn't generate reliably on its own.
What it needs
Requires python3 installed locally. About 4k tokens when loaded. Last updated 2026-07-21. 462 stars on the source repository.
What this skill does
Apple Human Interface Guidelines (HIG) Expert A skill focused on shipping apps that feel native on Apple platforms. Covers the underlying HIG principles, platform-specific patterns, native component selection, and accessibility expectations. This skill is opinionated about native conventions. It's not the right skill if your goal is to maximize cross-platform UX uniformity over native fit (see web design guides for that). When to use this skill Designing or reviewing an iOS / iPadOS / macOS / watchOS / tvOS / visionOS app Auditing an existing app for HIG compliance Picking the right native component (sheet vs popover vs full-screen) Adapting an app from one Apple platform to another Reviewing typography, color, spacing, and motion against HIG Auditing accessibility against Apple's accessibility expectations Onboarding a designer or PM new to Apple-platform design Inputs the advisor expects Target platform(s) and version range (iOS 17+, macOS 14+, etc.) App type (utility, productivity, social, games, media) Current designs / screenshots (described or referenced) Stack: SwiftUI vs UIKit / AppKit, recent or legacy codebase Accessibility maturity (WCAG audit done; VoiceOver tested) Workflows Workflow 1 — Audit screens for HIG compliance 1. Describe or reference each screen. 2. Run higcompliancechecker.py with the screen inventory. 3. Address findings by category (navigation, typography, controls, spacing, motion). Workflow 2 — Pick the right component for a flow 1. Describe the interaction goal. 2. Use componentpatternlookup.py to surface candidate patterns, trade-offs, and platform-specific guidance. Workflow 3 — Audit accessibility against Apple expectations 1. Capture screen inventory + accessibility attributes (labels, hints, traits). 2. Run accessibilityauditor.py to surface gaps. 3. Use Apple Accessibility Inspector to validate. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills borghei/apple-hig-expert