Apple Hig Expert

What it does

When your agent uses it

• Reviewing an Apple-platform mockup
• App for HIG compliance
• Checking contrast
• Tap-target sizes

Example prompts

• “audit my iOS app against the HIG”
• “is this text readable on Liquid Glass?”
• “Use the apple-hig-expert skill to audit and designs iOS/macOS/watchOS/visionOS interfaces against the Apple Human Interface Guidelines, including…”
• “/apple-hig-expert”

Requirements

• Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

1. 1Platform target: iOS, macOS, watchOS, or visionOS?
2. 2Current state: new design or auditing an existing mockup/code?
3. 3App category: utility, productivity, game, social, etc.

What it can do on your machine

Read from SKILL.md and the folder at commit 19392f7. 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 1 file 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

  Links to these hosts (documentation or services it may open):

  • developer.apple.com

  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.3k tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 115 tokens; SKILL.md has 500 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~115

When it runs · the whole SKILL.md, loaded when a task matches

~1.3k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3.6k

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

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 alirezarezvani/claude-skills at commit 19392f7, republished under its MIT licence (© alirezarezvani). 500 words, ~1,344 tokens.

name

apple-hig-expert

description

Audits and designs iOS/macOS/watchOS/visionOS interfaces against the Apple Human Interface Guidelines, including the Liquid Glass design language (announced WWDC25, shipped with iOS 26/macOS Tahoe, Sept 2025). Use when reviewing an Apple-platform mockup or app for HIG compliance, checking contrast or tap-target sizes, or designing native-feeling Apple UI (e.g., 'audit my iOS app against the HIG', 'is this text readable on Liquid Glass?').

license

MIT

metadata.version

1.1.0

metadata.author

Alireza Rezvani

metadata.category

design

metadata.updated

2026-06-11

# 1. Contrast ratio (WCAG formula; pass >= 4.5:1 for normal text)
python3 scripts/hig_checker.py contrast "#8E8E93" "#FFFFFF"
# -> Contrast Ratio: 3.26 [FAILED]

# 2. Tap-target size (pass >= 44x44 pt per HIG)
python3 scripts/hig_checker.py target 32 32
# -> Tap Target: 32x32 [FAILED]

# 3. Batch audit from JSON -> scorecard (starts at 100, -10 per violation)
python3 scripts/hig_checker.py batch audit.json

{
  "checks": [
    {"type": "contrast", "name": "caption-on-card", "fg": "#8E8E93", "bg": "#FFFFFF"},
    {"type": "target", "name": "close-button", "w": 32, "h": 32}
  ]
}

python3 scripts/hig_checker.py batch audit.json

{
  "score": 80,
  "violations": [
    "Contrast 3.26 fails for caption-on-card",
    "Target 32x32 small for close-button"
  ]
}

© alirezarezvani, 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 5 other files (scripts, references) in product-team/apple-hig-expert/skills/apple-hig-expert of alirezarezvani/claude-skills.

• SKILL.md
• references/accessibility.md
• references/platform-specifics.md
• references/visual-design.md
• scripts/hig_checker.py
• templates/hig-audit-template.md

Open the folder on GitHubat commit 19392f7