You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
"description": "Master Apple's Human Interface Guidelines (HIG) with focus on 2026 Liquid Glass aesthetics. Design and audit iOS, macOS, and visionOS apps for full compliance and premium feel. Includes hig_checker Python tool for tap targets and contrast.",
"description": "Agile product ownership for backlog management and sprint execution. Covers user story writing, acceptance criteria, sprint planning, and velocity tracking. Use for writing user stories, creating acceptance criteria, planning sprints, estimating story points, breaking down epics, or prioritizing backlog."
967
967
},
968
+
{
969
+
"name": "apple-hig-expert",
970
+
"source": "../../product-team/apple-hig-expert",
971
+
"category": "product",
972
+
"description": "Expert guidance on Apple Human Interface Guidelines (HIG). Covers iOS, macOS, and visionOS with 2026 Liquid Glass aesthetics and accessibility-first design."
973
+
},
968
974
{
969
975
"name": "code-to-prd",
970
976
"source": "../../product-team/code-to-prd",
@@ -1208,7 +1214,7 @@
1208
1214
"description": "Marketing, content, and demand generation skills"
1209
1215
},
1210
1216
"product": {
1211
-
"count": 15,
1217
+
"count": 16,
1212
1218
"source": "../../product-team",
1213
1219
"description": "Product management and design skills"
Copy file name to clipboardExpand all lines: .gemini/skills-index.json
+6-1Lines changed: 6 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -1,7 +1,7 @@
1
1
{
2
2
"version": "1.0.0",
3
3
"name": "gemini-cli-skills",
4
-
"total_skills": 282,
4
+
"total_skills": 283,
5
5
"skills": [
6
6
{
7
7
"name": "README",
@@ -1298,6 +1298,11 @@
1298
1298
"category": "product",
1299
1299
"description": "UX research and design toolkit for Senior UX Designer/Researcher including data-driven persona generation, journey mapping, usability testing frameworks, and research synthesis. Use for user research, persona creation, journey mapping, and design validation."
1300
1300
},
1301
+
{
1302
+
"name": "apple-hig-expert",
1303
+
"category": "product",
1304
+
"description": "Expert guidance on Apple Human Interface Guidelines (HIG). Covers iOS, macOS, and visionOS with focus on 2026 Liquid Glass aesthetics and accessibility-first design."
Copy file name to clipboardExpand all lines: CLAUDE.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
6
6
7
7
This is a **comprehensive skills library** for Claude AI and Claude Code - reusable, production-ready skill packages that bundle domain expertise, best practices, analysis tools, and strategic frameworks. The repository provides modular skills that teams can download and use directly in their workflows.
8
8
9
-
**Current Scope:**233 production-ready skills across 9 domains with 305 Python automation tools, 424 reference guides, 25 agents, and 22 slash commands.
9
+
**Current Scope:**234 production-ready skills across 9 domains with 306 Python automation tools, 427 reference guides, 25 agents, and 22 slash commands.
10
10
11
11
**Key Distinction**: This is NOT a traditional application. It's a library of skill packages meant to be extracted and deployed by users into their own Claude workflows.
description: "Expert guidance on Apple Human Interface Guidelines (HIG). Covers iOS, macOS, and visionOS with 2026 Liquid Glass aesthetics and accessibility-first design."
4
+
license: MIT
5
+
metadata:
6
+
version: 1.0.0
7
+
author: Alireza Rezvani
8
+
category: design
9
+
updated: 2026-04-09
10
+
---
11
+
12
+
# Apple HIG Expert
13
+
14
+
You are a Senior Apple Design Lead with decades of experience shipping award-winning apps on the App Store. Your goal is to help users design and audit apps that feel natively integrated into the Apple ecosystem while pushing the boundaries of the **Liquid Glass** aesthetic.
15
+
16
+
## Before Starting
17
+
18
+
**Check for context first:**
19
+
If `product-context.md` or `ios-design-context.md` exists, read it before asking questions.
20
+
21
+
Gather this context:
22
+
1.**Platform Target**: iOS, macOS, watchOS, or visionOS?
23
+
2.**Current State**: New project or auditing an existing mockup?
When starting fresh. Focus on atomic design, layout primitives, and navigation paradigms that align with Apple's core philosophies (Clarity, Deference, Depth).
32
+
33
+
### Mode 2: HIG Audit
34
+
When reviewing mockups or code. Use the [templates/hig-audit-template.md](templates/hig-audit-template.md) to systematically identify violations and refinement opportunities.
35
+
36
+
## Core Design Principles (2026)
37
+
38
+
### 1. Liquid Glass Aesthetic
39
+
Modern Apple design emphasizes translucency and fluid motion.
40
+
-**Translucency**: Use materials (thin, thick, ultra-thin) to create hierarchy.
41
+
-**Depth**: Layers should reflect z-axis relationships.
42
+
-**Fluidity**: Interactions should feel like physical objects responding to touch/eyes.
43
+
44
+
### 2. Accessibility First
45
+
Design for everyone from Day 1.
46
+
-**VoiceOver**: All elements must have semantic descriptions.
47
+
-**Tap Targets**: Minimum 44x44 points for all interactive elements.
48
+
-**Contrast**: Ensure legibility against translucent backgrounds.
49
+
50
+
## Workflows
51
+
52
+
### Phase 1: Navigation & Layout
53
+
Choose the right navigation pattern (Sidebars for macOS, Tab Bars for iOS, Ornaments for visionOS).
54
+
See [references/platform-specifics.md](references/platform-specifics.md) for details.
55
+
56
+
### Phase 2: Visual Styling
57
+
Apply typography (San Francisco family) and semantic colors.
58
+
See [references/visual-design.md](references/visual-design.md).
59
+
60
+
### Phase 3: Final Audit
61
+
Run the `hig_checker.py` tool to automate contrast and layout checks.
62
+
63
+
## Proactive Triggers
64
+
65
+
Surface these issues WITHOUT being asked:
66
+
-**Low Contrast**: Translucent layers masking text legibility.
67
+
-**Tiny Targets**: Interactive elements smaller than 44pt.
68
+
-**Missing Semantics**: Buttons with icons but no accessibility labels.
69
+
-**Density Overload**: Layouts that ignore white space/deference.
70
+
71
+
## Output Artifacts
72
+
73
+
| When you ask for... | You get... |
74
+
|---------------------|------------|
75
+
| "Audit my iOS app" | Detailed HIG Scorecard (0-100) with prioritized fixes. |
76
+
| "Design a visionOS ornament" | Spatial design specs with depth and gaze-contingent hover rules. |
77
+
| "Accessibility check" | Compliance report for VoiceOver, Dynamic Type, and Contrast. |
78
+
79
+
## Communication
80
+
81
+
All output follows the structured communication standard:
82
+
-**Bottom line first** — HIG compliance status before the details.
83
+
-**What + Why + How** — e.g., "Increase padding (What) because targets are too small (Why). Use 12pt margins (How)."
Accessibility isn't a feature; it's a foundational standard. Apple's design philosophy requires apps to be fully usable by everyone, regardless of their physical or cognitive abilities.
4
+
5
+
## The 4 Pillars of Accessibility
6
+
7
+
### 1. Perceivable
8
+
Information and UI components must be presentable to users in ways they can perceive.
9
+
-**VoiceOver**: Provide meaningful accessibility labels and hints. Avoid "Button 1". Use "Submit Order" with hint "Double tap to place your order."
10
+
-**Visuals**: Don't rely on color alone to convey meaning (e.g., use icons + color for errors).
11
+
12
+
### 2. Operable
13
+
User interface components and navigation must be operable.
14
+
-**Tap Targets**: 44x44 points minimum.
15
+
-**Motor Control**: Support Switch Control and AssistiveTouch.
16
+
17
+
### 3. Understandable
18
+
Information and the operation of the user interface must be understandable.
19
+
-**Predictability**: Use standard Apple UI patterns (Tab Bars, Sidebars) so users already know how they work.
20
+
21
+
### 4. Robust
22
+
Content must be robust enough to be interpreted by a wide variety of user agents, including assistive technologies.
23
+
24
+
## Technical Requirements (2026)
25
+
26
+
### Dynamic Type
27
+
Apps must respond to system-wide font size changes.
28
+
-**Scaling Layouts**: Use Auto Layout or SwiftUI `VStack`/`HStack` that wrap content when fonts get large.
29
+
-**No Clipped Text**: Text should never be truncated unnecessarily.
30
+
31
+
### Contrast Ratios
32
+
-**Normal Text**: 4.5:1 minimum against its background.
33
+
-**Large Text**: 3:1 minimum.
34
+
-**Liquid Glass Exception**: Be extremely careful with translucency (vibrancy). If a background is too busy, reduce transparency for accessibility.
35
+
36
+
### Haptics & Audio
37
+
- Provide haptic feedback for primary actions (success, failure, selection change).
38
+
- Ensure all audio content has captions or visual equivalents.
39
+
40
+
## Checklist for Designers
41
+
42
+
-[ ] Does the app work in Grayscale mode?
43
+
-[ ] Are all buttons at least 44pt tall?
44
+
-[ ] Is every icon labeled for VoiceOver?
45
+
-[ ] Does the layout remain usable at the largest Dynamic Type size?
46
+
-[ ] Have you tested with "Reduce Transparency" enabled in system settings?
0 commit comments