Skip to content

yerzong/TEMP-LEAGUE / .claude/skills/apple-design

apple-design

Verified

Cross-platform UI/UX design reviewer grounded in Apple Human Interface Guidelines principles. Use this skill to audit, review, critique, or improve any UI/UX design for mobile apps (iOS, Flutter, React Native) or desktop apps (macOS, Tauri, Electron). Triggers when the user mentions: design review, UI audit, HIG compliance, improving app design, design feedback, accessibility audit, or any request to check or improve a design against professional standards. Also use when the user uploads screenshots, mockups, wireframes, or design specs of a mobile or desktop app and wants feedback. Even if they just say "review my design" or "is this good UI", use this skill. Works for native and cross-platform frameworks including Flutter, Tauri, Electron, React Native, SwiftUI, and AppKit/UIKit.

FileKindSize
README.mdmarkdown4.7 KB
SKILL.mdskill md12.2 KB
references/hig-lookup.mdmarkdown3.0 KB
references/hig/accessibility.mdmarkdown12.9 KB
references/hig/app-icons.mdmarkdown8.7 KB
references/hig/apple-pay.mdmarkdown23.8 KB
references/hig/apple-pencil-and-scribble.mdmarkdown12.3 KB
references/hig/augmented-reality.mdmarkdown19.1 KB
references/hig/branding.mdmarkdown2.9 KB
references/hig/charting-data.mdmarkdown5.9 KB
references/hig/collaboration-and-sharing.mdmarkdown4.8 KB
references/hig/color.mdmarkdown11.6 KB
references/hig/dark-mode.mdmarkdown6.7 KB
references/hig/drag-and-drop.mdmarkdown12.0 KB
references/hig/entering-data.mdmarkdown3.4 KB
references/hig/feedback.mdmarkdown3.2 KB
references/hig/file-management.mdmarkdown9.7 KB
references/hig/focus-and-selection.mdmarkdown6.2 KB
references/hig/game-controls.mdmarkdown9.1 KB
references/hig/generative-ai.mdmarkdown14.4 KB
references/hig/gestures.mdmarkdown6.0 KB
references/hig/going-full-screen.mdmarkdown4.3 KB
references/hig/icons.mdmarkdown9.9 KB
references/hig/images.mdmarkdown2.8 KB
references/hig/in-app-purchase.mdmarkdown14.7 KB
references/hig/inclusion.mdmarkdown12.8 KB
references/hig/keyboards.mdmarkdown14.9 KB
references/hig/launching.mdmarkdown3.4 KB
references/hig/layout.mdmarkdown15.3 KB
references/hig/liquid-glass.mdmarkdown8.4 KB
references/hig/live-viewing-apps.mdmarkdown6.2 KB
references/hig/loading.mdmarkdown2.6 KB
references/hig/machine-learning.mdmarkdown33.2 KB
references/hig/managing-accounts.mdmarkdown5.2 KB
references/hig/managing-notifications.mdmarkdown5.9 KB
references/hig/maps.mdmarkdown11.2 KB
references/hig/materials.mdmarkdown1.4 KB
references/hig/modality.mdmarkdown4.5 KB
references/hig/motion.mdmarkdown3.4 KB
references/hig/multitasking.mdmarkdown4.6 KB
references/hig/offering-help.mdmarkdown5.7 KB
references/hig/onboarding.mdmarkdown4.3 KB
references/hig/playing-audio.mdmarkdown7.0 KB
references/hig/playing-haptics.mdmarkdown9.8 KB
references/hig/playing-video.mdmarkdown8.4 KB
references/hig/pointing-devices.mdmarkdown18.8 KB
references/hig/printing.mdmarkdown3.1 KB
references/hig/privacy.mdmarkdown12.0 KB
references/hig/ratings-and-reviews.mdmarkdown2.9 KB
references/hig/right-to-left.mdmarkdown8.7 KB
references/hig/searching.mdmarkdown3.8 KB
references/hig/settings.mdmarkdown5.9 KB
references/hig/sf-symbols.mdmarkdown13.8 KB
references/hig/typography.mdmarkdown9.0 KB
references/hig/undo-and-redo.mdmarkdown3.8 KB
references/hig/writing.mdmarkdown8.1 KB
# Apple Design Skill

Cross-platform UI/UX design reviewer grounded in Apple's Human Interface Guidelines (HIG), adapted as universal design rules for **mobile** and **desktop** apps.

Works with any framework: **Flutter**, **Tauri**, **Electron**, **React Native**, **SwiftUI**, **UIKit**.

## What It Does

- **Design Review** — Systematic audit against 53 design guideline documents covering color, typography, layout, accessibility, motion, gestures, and more
- **Design Improvement** — Prioritized, actionable fixes with framework-specific implementation guidance
- **Specialized Modes** — App icon review, accessibility audit, dark mode review, Liquid Glass / glassmorphism review, generative AI UX review
- **Cross-Platform** — All guidelines generalized from iOS → mobile, macOS → desktop; references Apple-specific APIs only in a translation table

## Quick Start

### Claude Code

```bash
claude install-skill /path/to/apple-design-skill
```

Or clone and install:

```bash
git clone https://github.com/dickwu/apple-design-skill.git
claude install-skill ./apple-design-skill
```

### Cursor

Add this repo as a context source. Two options:

**Option A — `.cursor/rules`**

Create `.cursor/rules/apple-design.mdc` in your project:

```markdown
---
description: Apple HIG design review and improvement
globs: ["**/*.dart", "**/*.tsx", "**/*.jsx", "**/*.vue", "**/*.svelte", "**/*.swift"]
---

@import https://raw.githubusercontent.com/dickwu/apple-design-skill/main/SKILL.md
```

**Option B — Project Rules**

1. Open Cursor Settings → Rules
2. Add a new rule, paste the content of `SKILL.md`
3. Under "Reference Files", add the `references/` directory

Then ask Cursor: *"Review my UI design against Apple HIG guidelines"*

### Codex (OpenAI)

Add as a custom instruction or system prompt source:

1. Clone this repo into your project or reference it as a submodule:

```bash
git submodule add https://github.com/dickwu/apple-design-skill.git .design-rules
```

2. In your Codex instructions or `AGENTS.md`, reference it:

```markdown
## Design Review Rules

When reviewing UI/UX designs, follow the design review process defined in:
- `.design-rules/SKILL.md` — Main review methodology
- `.design-rules/references/hig-lookup.md` — Topic-to-file mapping
- `.design-rules/references/hig/` — 53 design guideline documents

Always load the relevant guideline files before providing design feedback.
```

### Windsurf / Other AI Editors

Add to your project's AI rules file (`.windsurfrules`, `.ai-rules`, etc.):

```markdown
For design reviews, follow the methodology in:
- SKILL.md (review process)
- references/hig-lookup.md (topic routing)
- references/hig/*.md (guideline documents)
```

## File Structure

```
apple-design-skill/
├── SKILL.md                          # Main skill: review process, audit framework, severity system
├── references/
│   ├── hig-lookup.md                 # Topic → file routing table
│   └── hig/                          # 53 design guideline documents
│       ├── accessibility.md
│       ├── color.md
│       ├── dark-mode.md
│       ├── gestures.md
│       ├── layout.md
│       ├── liquid-glass.md           # Liquid Glass / glassmorphism rules + cross-platform impl
│       ├── typography.md
│       └── ... (46 more)
```

## Coverage

| Category | Topics | Files |
|----------|--------|-------|
| **Visual Design** | Color, typography, icons, images, materials, Liquid Glass, motion, branding, layout | 10 |
| **Interaction** | Gestures, keyboards, pointer, stylus, focus, game controls, drag-and-drop | 7 |
| **UX Patterns** | Onboarding, loading, modals, settings, notifications, auth, search, undo, etc. | 18 |
| **Accessibility** | Screen readers, contrast, inclusion, RTL, privacy | 4 |
| **Media** | Audio, video, haptics | 3 |
| **Technologies** | Payments, maps, ML/AI, AR, live-viewing | 5 |

## Example Usage

Ask your AI assistant:

- *"Review my Flutter app's home screen design against HIG guidelines"*
- *"Audit my Tauri desktop app for accessibility issues"*
- *"How should I implement Liquid Glass / glassmorphism in my React Native app?"*
- *"Improve the navigation pattern in my Electron app"*
- *"Check if my app icon follows design best practices"*

## Origin

Design rules extracted and generalized from [Apple's Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/). Platform-specific terms (iOS → mobile, macOS → desktop) and Apple APIs have been replaced with framework-agnostic equivalents while preserving all design principles.

## License

The design guidelines are derived from Apple's publicly available HIG documentation. This repository packages them for AI-assisted design review. Use at your own discretion.
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall