Hig Project Context
raintree-technology/hig-doctor
Create or update a shared Apple design context document that other HIG skills use to tailor guidance.
Apple Human Interface Guidelines expert across iOS, iPadOS, macOS, watchOS, tvOS, and visionOS.
Install Apple Hig Expert
$ npx skills add borghei/Claude-Skills --skill apple-hig-expert -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install borghei/Claude-Skills apple-hig-expert --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/product-team/apple-hig-expert .claude/skills/apple-hig-expert && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "apple-hig-expert" agent skill from https://github.com/borghei/Claude-Skills/tree/main/product-team/apple-hig-expert into .claude/skills/apple-hig-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apple-hig-expert", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/borghei/Claude-Skills/tree/main/product-team/apple-hig-expertType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add borghei/Claude-Skills --skill apple-hig-expert -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install borghei/Claude-Skills apple-hig-expert --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/product-team/apple-hig-expert .agents/skills/apple-hig-expert && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "apple-hig-expert" agent skill from https://github.com/borghei/Claude-Skills/tree/main/product-team/apple-hig-expert into .agents/skills/apple-hig-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apple-hig-expert", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add borghei/Claude-Skills --skill apple-hig-expert -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install borghei/Claude-Skills apple-hig-expert --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/product-team/apple-hig-expert .cursor/skills/apple-hig-expert && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "apple-hig-expert" agent skill from https://github.com/borghei/Claude-Skills/tree/main/product-team/apple-hig-expert into .cursor/skills/apple-hig-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apple-hig-expert", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/borghei/Claude-Skills.git --path product-team/apple-hig-expert--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add borghei/Claude-Skills --skill apple-hig-expert -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install borghei/Claude-Skills apple-hig-expert --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/product-team/apple-hig-expert .gemini/skills/apple-hig-expert && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "apple-hig-expert" agent skill from https://github.com/borghei/Claude-Skills/tree/main/product-team/apple-hig-expert into .gemini/skills/apple-hig-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apple-hig-expert", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install borghei/Claude-Skills apple-hig-expertInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add borghei/Claude-Skills --skill apple-hig-expert -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/product-team/apple-hig-expert .github/skills/apple-hig-expert && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "apple-hig-expert" agent skill from https://github.com/borghei/Claude-Skills/tree/main/product-team/apple-hig-expert into .github/skills/apple-hig-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apple-hig-expert", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add borghei/Claude-Skills --skill apple-hig-expert -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install borghei/Claude-Skills apple-hig-expert --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/product-team/apple-hig-expert .opencode/skills/apple-hig-expert && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "apple-hig-expert" agent skill from https://github.com/borghei/Claude-Skills/tree/main/product-team/apple-hig-expert into .opencode/skills/apple-hig-expert/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "apple-hig-expert", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
apple-hig-expert- GitHub stars
- 891
- Token cost
- ~1.7k tokens
- SKILL.md length
- 766 words
- Files
- 7 (incl. scripts, references)
- Skills in repo
- 354
- Repo updated
- First seen
- Licence
- MIT
At a glance
Apple Human Interface Guidelines expert across iOS, iPadOS, macOS, watchOS, tvOS, and visionOS.
- Works in 3 steps: Describe or reference each screen. → Run hig_compliance_checker.py with the… → Address findings by category…
- Reviewing an Apple-platform app
- SKILL.md covers When to use this skill, Inputs the advisor expects, Workflows and Decision frameworks, plus 4 more sections
- Runs Python scripts from its folder; calls python3
What it does
Apple Hig Expert is an agent skill from borghei/Claude-Skills. 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.
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `references/cross-platform-considerations.md`, `references/hig-fundamentals.md` and `references/ios-component-patterns.md`).
It sits in Mobile, covering iOS development. It works with iOS and macOS. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.
When your agent uses it
- Reviewing an Apple-platform app
- Auditing for HIG compliance
- Picking native components
- Validating accessibility
Example prompts
- “/apple-hig-expert”
Requirements
- Python 3
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Describe or reference each screen.
- Run hig_compliance_checker.py with the screen inventory.
- Address findings by category (navigation, typography, controls, spacing, motion).
What it can do on your machine
Read from SKILL.md and the folder at commit 4a698e8. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 3 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Apple Hig Expert loads about 1.7k tokens when it runs, and up to ~6.9k if it reads all its reference files. Until then it costs about 63 tokens; SKILL.md has 766 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from borghei/Claude-Skills at commit 4a698e8, republished under its MIT licence (© borghei). 766 words, ~1,748 tokens.
Download SKILL.mdSave it as
.claude/skills/apple-hig-expert/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.- name
- apple-hig-expert
- description
- 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.
- license
- MIT + Commons Clause
- metadata.version
- 1.0.0
- metadata.author
- borghei
- metadata.category
- product-team
- metadata.domain
- design
- metadata.updated
- 2026-05-27
- metadata.tags
- apple, ios, ipados, macos, watchos, tvos, visionos, hig, design, accessibility
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
- Describe or reference each screen.
- Run
hig_compliance_checker.pywith the screen inventory. - Address findings by category (navigation, typography, controls, spacing, motion).
python3 apple-hig-expert/scripts/hig_compliance_checker.py \
--input screens.json --format markdownWorkflow 2 — Pick the right component for a flow
- Describe the interaction goal.
- Use
component_pattern_lookup.pyto surface candidate patterns, trade-offs, and platform-specific guidance.
python3 apple-hig-expert/scripts/component_pattern_lookup.py \
--platform ios --goal "show options without leaving context" --format markdownWorkflow 3 — Audit accessibility against Apple expectations
- Capture screen inventory + accessibility attributes (labels, hints, traits).
- Run
accessibility_auditor.pyto surface gaps. - Use Apple Accessibility Inspector to validate.
python3 apple-hig-expert/scripts/accessibility_auditor.py \
--input a11y_state.json --format markdownDecision frameworks
Sheets vs popovers vs full-screen
| Pattern | When to use | Platform |
|---|---|---|
| Sheet (medium / large) | Modal task with clear escape | iOS, iPadOS, macOS, visionOS |
| Popover | Context-anchored options, brief | iPadOS (compact: replaced with sheet), macOS |
| Full-screen cover | Immersive task, e.g., photo editing | iOS |
| Push (navigation stack) | Hierarchical drill-in | iOS, iPadOS |
| Inspector | Persistent secondary content | macOS, iPadOS |
| Toolbar item | Quick action on current context | All |
Common mistake: popover on compact iPhone (it becomes a sheet automatically; design for both).
When to use SwiftUI vs UIKit
- SwiftUI — new apps, simple-to-moderate complexity, multi-platform from one codebase
- UIKit — legacy code, complex interactions not yet ergonomic in SwiftUI, performance-sensitive
- Mixed — common; embed SwiftUI in UIKit hosts or vice versa
The trend (2026) is SwiftUI-first for new development; UIKit retains strength in performance-sensitive lists and complex gesture handling.
Color and dark mode
- Use semantic colors (
systemBackground,secondaryLabel) — they adapt to light/dark mode automatically - Avoid hardcoded hex values for system-feeling content
- Test in both light + dark mode + increased contrast settings
- Brand colors: assess contrast in both modes; use Asset Catalog with separate light/dark variants
Typography
- Use Dynamic Type styles (
largeTitle,body,caption) — they scale with user accessibility settings - Don't hardcode font sizes for body text
- Custom fonts: still respect Dynamic Type through
UIFontMetrics/ SwiftUIdynamicTypeSize - Test at largest Dynamic Type setting; design must remain usable
Show full SKILL.md (295 more words)Show less
Common engagements
"Help me adapt our iPhone app for iPad"
- Identify navigation: sidebar (NavigationSplitView) vs tabs at iPad sizes
- Use Inspector for secondary content
- Convert sheets to popovers where appropriate
- Adapt to multitasking (split view, slide over)
- Add hardware support: Pencil, keyboard shortcuts, pointer interactions
"Our app feels un-Apple-y. What's wrong?"
- Check typography — using Dynamic Type styles, not hardcoded sizes?
- Check colors — semantic colors, dark mode parity?
- Check spacing — multiples of 4 or 8; not custom every-screen
- Check controls — using native ones, not custom toggles/buttons?
- Check navigation — does back gesture work? Does state persist correctly?
"Make our app accessible"
- Every interactive element has a label
- Decorative images marked
accessibilityHidden - Focus order makes sense for VoiceOver
- Custom controls have correct
accessibilityTraits - Touch targets ≥44pt × 44pt
- Color isn't the only way information is conveyed
- Reduced motion respected
- Test with VoiceOver, Voice Control, Switch Control, Dynamic Type max
Anti-patterns to avoid
- Custom UI for things iOS already provides. Use native; users expect it.
- Hardcoded font sizes. Breaks Dynamic Type; breaks accessibility.
- Same UI across all Apple platforms. Each platform has different conventions.
- Hamburger menu on iOS. Tab bar is more discoverable.
- Modal-heavy navigation. Apple's nav stack is the primary pattern.
- Custom navigation bar. Use the system one; users know how it works.
- Ignoring safe area insets. Content gets clipped behind notches and home indicators.
- No haptic feedback on iOS. Apps that use it feel premium.
- No keyboard support on iPad. Power users will leave.
References
references/hig-fundamentals.md— principles, design language, foundational patternsreferences/ios-component-patterns.md— sheets, navigation, controls, gestures, listsreferences/cross-platform-considerations.md— iPad, Mac, Watch, TV, Vision differences
Related skills
product-team/product-designer— broader product designproduct-team/ui-design-system— design system constructionproduct-team/ux-researcher-designer— research informing designengineering/senior-frontend— implementation
© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 6 other files (scripts, references) in product-team/apple-hig-expert of borghei/Claude-Skills.
- SKILL.md
- references/cross-platform-considerations.md
- references/hig-fundamentals.md
- references/ios-component-patterns.md
- scripts/accessibility_auditor.py
- scripts/component_pattern_lookup.py
- scripts/hig_compliance_checker.py
Open the folder on GitHubat commit 4a698e8
Compare with similar skills
Apple Hig Expert next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Apple Hig Expert this skillborghei/Claude-Skills | 891 | — | ~1.7k | Automated safety check: Pass | MIT | |
| Hig Project Contextraintree-technology/hig-doctor | 143 | 5 repos | ~1.2k | Automated safety check: Pass | MIT | |
| Hig Components Contentraintree-technology/hig-doctor | 143 | 5 repos | ~1.3k | Automated safety check: Pass | MIT | |
| iOS Accessibilitydpearson2699/swift-ios-skills | 1.2k | — | ~4.6k | Automated safety check: Pass | Custom licence | |
| Native App Designercuriositech/some_claude_skills | 244 | — | ~1.9k | Automated safety check: Notes | MIT | |
| SwiftUI Design SkillWholiver/swiftui-design-skill | 204 | — | ~2.8k | Automated safety check: Pass | MIT |
Similar skills
Hig Components Content
raintree-technology/hig-doctor
Apple Human Interface Guidelines for content display components.
iOS Accessibility
dpearson2699/swift-ios-skills
Build and audit SwiftUI, UIKit, and AppKit accessibility for VoiceOver, Voice Control, Switch Control, Full Keyboard Access, Dynamic Type, focus restoration, labels/traits/actions, traversal, custom…
Native App Designer
curiositech/some_claude_skills
Creates breathtaking iOS/Mac and web apps with organic, non-AI aesthetic.
SwiftUI Design Skill
Wholiver/swiftui-design-skill
Guides the agent to design distinctive SwiftUI interfaces for iOS and macOS, with six anti-generic rules, a design direction workflow and a five-dimension review.
Orca iOS Simulator Control
stablyai/orca
iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…
More from borghei/Claude-Skills
All 354 skills in this repoAgent Harness
borghei/Claude-Skills
Test and evaluation harness for AI agents — scenario suites, deterministic replay, regression diffing, cost and latency budgets.
Agents In The Team
borghei/Claude-Skills
Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.
AI Content Disclosure
borghei/Claude-Skills
Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.
AI Prototyping
borghei/Claude-Skills
Idea to AI-generated prototype to customer validation to engineering handoff.
Analytics Engineer
borghei/Claude-Skills
Analytics engineering across data modeling, dbt, transformation, and semantic layers.
Ansoff Matrix
borghei/Claude-Skills
Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.
Related
Categories
Questions about Apple Hig Expert
What does Apple Hig Expert do?
Apple Human Interface Guidelines expert across iOS, iPadOS, macOS, watchOS, tvOS, and visionOS. Apple Hig Expert is an agent skill from borghei/Claude-Skills. Apple Human Interface Guidelines expert across iOS, iPadOS, macOS, watchOS, tvOS, and visionOS.
When should I use Apple Hig Expert?
Apple Hig Expert fits situations like: reviewing an Apple-platform app; auditing for HIG compliance; picking native components; validating accessibility.
How do I install Apple Hig Expert in Claude Code?
Run `npx skills add borghei/Claude-Skills --skill apple-hig-expert -a claude-code`. Or copy the skill folder (product-team/apple-hig-expert in borghei/Claude-Skills) into .claude/skills/apple-hig-expert in your project. Claude Code loads it when a task matches its description.
How do I install Apple Hig Expert in Codex?
Run `npx skills add borghei/Claude-Skills --skill apple-hig-expert -a codex`. Or copy the skill folder (product-team/apple-hig-expert in borghei/Claude-Skills) into .agents/skills/apple-hig-expert in your project. Codex loads it when a task matches its description.
Can I use Apple Hig Expert in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add borghei/Claude-Skills --skill apple-hig-expert -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/apple-hig-expert, .gemini/skills/apple-hig-expert, .github/skills/apple-hig-expert and .opencode/skills/apple-hig-expert in your project.
What does Apple Hig Expert need to run?
Going by SKILL.md and its folder, Apple Hig Expert needs Python for the scripts in its folder and the command-line tools its instructions call (python3). Our summary lists: Python 3.
Does Apple Hig Expert access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Apple Hig Expert safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Apple Hig Expert use?
Apple Hig Expert is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Apple Hig Expert use?
About 1.7k tokens (SKILL.md is roughly 7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.2k tokens, read only when the agent opens those files.
What are the alternatives to Apple Hig Expert?
Skills that share tags, products or a category with Apple Hig Expert: Hig Project Context (raintree-technology/hig-doctor, 143 stars), Hig Components Content (raintree-technology/hig-doctor, 143 stars), iOS Accessibility (dpearson2699/swift-ios-skills, 1.2k stars) and Native App Designer (curiositech/some_claude_skills, 244 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Apple Hig Expert?
borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 891 GitHub stars. The repository holds 354 skills in this directory. The repository was last updated on October 7, 2026.
Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.