Apple HIG Expert
Apple HIG Expert audits and designs iOS, macOS, watchOS, and visionOS interfaces against the Apple Human Interface Guidelines, including the Liquid Glass design language. It provides a compliance tool to check contrast and tap-target sizes, and delivers scored audit reports with actionable fixes.
✨ What it does
- Checks contrast ratios using WCAG formula (pass >= 4.5:1 for normal text).
- Checks tap-target sizes (pass >= 44x44 pt).
- Batch audit from JSON produces a scorecard starting at 100, subtracting 10 per violation.
- Provides guidance on Liquid Glass design principles and accessibility.
- Includes proactive triggers for common HIG violations.
- Offers communication guidelines with confidence tagging.
🎯 When to use it
- When reviewing an Apple-platform mockup or app for HIG compliance.
- When checking contrast ratios or tap-target sizes against HIG minimums.
- When designing native-feeling Apple UI, especially with Liquid Glass.
- When you need a structured audit report with a compliance score.
🚀 How to use
Trigger by asking for an HIG audit or design help, e.g., 'audit my iOS app against the HIG' or 'is this text readable on Liquid Glass?'. Provide platform target, current state (new design or existing mockup), and app category. For audits, fill the audit template and run the checker script with contrast, target, or batch commands.
📄 Output: A scored audit report (e.g., JSON scorecard) with violations and recommended fixes, or design guidance.
📦 Add this skill to Claude Code
# 1. Get the skills repo
git clone --depth 1 https://github.com/alirezarezvani/claude-skills /tmp/claude-skills
# 2. Copy this skill into your project (or ~/.claude/skills for all projects)
mkdir -p .claude/skills
cp -r /tmp/claude-skills/product-team/apple-hig-expert/skills/apple-hig-expert .claude/skills/apple-hig-expertSkill source: product-team/apple-hig-expert/skills/apple-hig-expert/SKILL.md
⚠️ Good to know
The tool cannot measure VoiceOver labels, Dynamic Type behavior, or Reduce Transparency; these require manual assessment and device testing.
❓ FAQ
What is the minimum contrast ratio for normal text?
The minimum contrast ratio for normal text is 4.5:1, as per HIG.
What is the minimum tap-target size?
The minimum tap-target size is 44x44 points.
How is the batch audit score calculated?
The batch score starts at 100 and subtracts 10 for each failed check; violations are listed by element name.
🤖 Overview, features, install steps and FAQ were generated from the project's SKILL.md on Sep 4, 2026. Always check the original source before running commands.