alirezarezvani/claude-skills / product-team/apple-hig-expert/skills/apple-hig-expert
apple-hig-expert
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.0 KB |
| references/accessibility.md | markdown | 2.7 KB |
| references/platform-specifics.md | markdown | 2.7 KB |
| references/visual-design.md | markdown | 3.4 KB |
| scripts/hig_checker.py | script | 3.5 KB |
| templates/hig-audit-template.md | markdown | 2.0 KB |
scripts/hig_checker.py
View on GitHub#!/usr/bin/env python3
"""
Apple HIG Compliance Checker
Quantitative checks for tap targets, contrast, and typography.
"""
import sys
import argparse
import json
import math
def calculate_luminance(hex_color):
"""Calculates relative luminance for a given hex color."""
hex_color = hex_color.lstrip('#')
if len(hex_color) != 6:
return 0
r, g, b = [int(hex_color[i:i+2], 16) / 255.0 for i in (0, 2, 4)]
def adjust(c):
return c / 12.92 if c <= 0.03928 else ((c + 0.055) / 1.055) ** 2.4
return 0.2126 * adjust(r) + 0.7152 * adjust(g) + 0.0722 * adjust(b)
def check_contrast(fg, bg):
"""Checks contrast ratio between foreground and background."""
l1 = calculate_luminance(fg)
l2 = calculate_luminance(bg)
if l1 < l2:
l1, l2 = l2, l1
ratio = (l1 + 0.05) / (l2 + 0.05)
return round(ratio, 2)
def main():
parser = argparse.ArgumentParser(description="Apple HIG Compliance Checker")
subparsers = parser.add_subparsers(dest="command", help="Compliance command")
# Contrast command
contrast_parser = subparsers.add_parser("contrast", help="Check contrast ratio")
contrast_parser.add_argument("fg", help="Foreground Hex (e.g. #FFFFFF)")
contrast_parser.add_argument("bg", help="Background Hex (e.g. #000000)")
# Target command
target_parser = subparsers.add_parser("target", help="Check tap target size")
target_parser.add_argument("width", type=int, help="Width in points")
target_parser.add_argument("height", type=int, help="Height in points")
# Batch command
batch_parser = subparsers.add_parser("batch", help="Batch check from JSON")
batch_parser.add_argument("file", help="Path to JSON file")
args = parser.parse_args()
results = {"score": 100, "violations": []}
if args.command == "contrast":
ratio = check_contrast(args.fg, args.bg)
status = "PASSED" if ratio >= 4.5 else "FAILED"
print(f"Contrast Ratio: {ratio} [{status}]")
if status == "FAILED":
print("Recommendation: Increase contrast to at least 4.5:1 for accessibility.")
elif args.command == "target":
if args.width < 44 or args.height < 44:
print(f"Tap Target: {args.width}x{args.height} [FAILED]")
print("Recommendation: Minimum tap target size is 44x44 points per Apple HIG.")
else:
print(f"Tap Target: {args.width}x{args.height} [PASSED]")
elif args.command == "batch":
try:
with open(args.file, 'r') as f:
data = json.load(f)
# Sample batch processing
for item in data.get("checks", []):
if item['type'] == 'contrast':
r = check_contrast(item['fg'], item['bg'])
if r < 4.5:
results["violations"].append(f"Contrast {r} fails for {item.get('name', 'element')}")
results["score"] -= 10
elif item['type'] == 'target':
if item['w'] < 44 or item['h'] < 44:
results["violations"].append(f"Target {item['w']}x{item['h']} small for {item.get('name', 'element')}")
results["score"] -= 10
print(json.dumps(results, indent=2))
except Exception as e:
print(f"Error: {e}")
sys.exit(1)
else:
parser.print_help()
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |