Skip to main content
skill CX Codex

ios-ui-craft — Claude Code skill: what it does, how to install

ios-ui-craft builds production-grade SwiftUI screens and components aligned with Apple Design Award aesthetics and screenshot verification.

MIT 184 installs ★ 359 updated 2026-09-26

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add Prisma-Labs-Dev/apple-skills --skill ios-ui-craft -a claude-code
Open on GitHub

What ios-ui-craft does

The skill instructs the agent to write working SwiftUI code for screens, custom controls, and app redesigns. It enforces a strict aesthetic direction inspired by flagship Apple apps such as Weather, Journal, and Health. Generic templates, purple gradients, emojis as icons, and unstyled tab bars are explicitly treated as anti-patterns.

Development relies on a screenshot verification loop: the agent takes captures of the booted simulator with xcrun simctl and inspects the output before finishing the task. Code patterns for navigation layers and glass surfaces expect the companion reference in skills/ios-liquid-glass/.

When design advice is needed without actual Swift implementation, the repository recommends using ios-design-consultant instead.

What it helps with

  • generate full SwiftUI views with intentional typographic scale and SF Pro Display
  • replace flat list views with layered backgrounds and spring animations
  • add haptic feedback and bouncy transitions to interactive controls
  • inspect iOS simulator screenshots automatically during interface refinement

Example prompts for the agent

  • Build a fitness summary dashboard in SwiftUI with a dark-mode-first color scheme
  • Create a custom audio player bar using SF Symbols and tactile haptics
  • Redesign this settings view to eliminate default grouped list styling

How to install ios-ui-craft

1Skills CLI (Vercel)

npx skills add Prisma-Labs-Dev/apple-skills --skill ios-ui-craft -a claude-code

2Manually: put the files in place

~/.claude/skills/ios-ui-craft/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ios-ui-craft/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ios-ui-craft

How to install ios-ui-craft in Claude Code?

Run npx skills add Prisma-Labs-Dev/apple-skills --skill ios-ui-craft -a claude-code in your terminal. The configuration writes to ~/.claude/skills/ios-ui-craft/SKILL.md.

What does ios-ui-craft do?

It guides the coding agent to produce clean SwiftUI views with spring motion, dark-first styling, and hardware-aligned corner radii.

How does it differ from ios-design-consultant?

The ios-ui-craft skill outputs functional SwiftUI code verified via simulator captures, while ios-design-consultant focuses purely on advisory critique.

Source text

SKILL.md · MIT
---
name: ios-ui-craft
user-invocable: true
description: Production-grade SwiftUI with Apple Design Award-quality aesthetics. Use when building visually striking iOS interfaces — screens, components, redesigns. Screenshot-driven visual iteration, Liquid Glass (iOS 26+), bold design direction. For design advice without code, use ios-design-consultant instead.
---

# iOS UI Craft

Create distinctive, Apple Design Award-worthy iOS interfaces. This skill produces real, working SwiftUI code with exceptional attention to aesthetic details and creative choices that avoid generic AI-generated aesthetics.

The user provides iOS requirements: a screen, component, view, or interface to build. They may include context about the purpose, audience, or technical constraints.

## Design Thinking

Before writing ANY code, understand the context and commit to a BOLD aesthetic direction:

1. **Purpose**: What problem does this interface solve? Who uses it?
2. **Tone**: Pick a direction: calm/serene, playful/energetic, premium/refined, utilitarian/focused, editorial/magazine, brutalist/raw, warm/organic, cold/technical. Commit fully.
3. **Inspiration**: Which Apple apps set the bar? (Weather, Health, Fitness, Notes, Apple TV, Journal)
4. **Differentiation**: What makes this UNFORGETTABLE? What's the one thing users will remember?
5. **Glass Philosophy**: Is glass framing content or would it compete with it?

**CRITICAL**: Choose a clear conceptual direction and execute it with precision. Bold maximalism and refined minimalism both work—the key is intentionality, not intensity.

Then implement working SwiftUI code that is:
- Production-grade and functional
- Visually striking and memorable
- Cohesive with a clear aesthetic point-of-view
- Meticulously refined in every detail

## Anti-Patterns: What to Avoid

These are hallmarks of generic AI-generated iOS design. NEVER do these:

| Anti-Pattern | Why It's Bad | Instead |
|--------------|--------------|---------|
| **Boring solid backgrounds** | No depth or atmosphere | Gradients, subtle textures, or layered colors |
| **System fonts everywhere** | No typographic intention | Intentional hierarchy, consider display fonts |
| **Cookie-cutter tab bars** | No personality | Custom styling, meaningful icons |
| **Purple/indigo gradients** | Quintessential AI slop | Find a distinctive, contextual palette |
| **Flat, lifeless interactions** | No delight | Haptics, spring animations, feedback |
| **Glass on everything** | Defeats the purpose | Glass only for controls/navigation layer |
| **Ignoring content layer** | Glass where it doesn't belong | Glass frames content, never obscures |
| **Generic card layouts** | White rectangles with shadows | Context-specific, purposeful containers |
| **Emojis as design elements** | Lazy, unprofessional | SF Symbols, custom assets |
| **Evenly distributed colors** | Timid, uncommitted | Dominant color with sharp accents |

## iOS Aesthetics Guidelines

Focus on:

- **Typography**: Create clear hierarchy. Display fonts for impact, proper weight progression. Don't default to system everywhere—make intentional choices. Consider SF Pro Display for headers, custom fonts for brand identity.
- **Color & Theme**: Commit to a cohesive aesthetic. Dominant colors with sharp accents outperform timid, evenly-distributed palettes. Dark mode often produces more distinctive results. Design dark first, then adapt to light.
- **Motion**: Spring/bouncy animations are the new default. Morph between states, don't swap. Add haptics to every meaningful interaction. Use `.bouncy` not `.easeInOut`.
- **Spatial Composition**: Intentional spacing (8pt grid). Breathing room where needed, density where appropriate. Concentric corners that match device hardware.
- **Backgrounds & Depth**: Create atmosphere. Gradients, subtle layers, radial glows. Never flat white unless that's a deliberate minimal choice.

## The Three Principles

| Principle | Description |
|-----------|-------------|
| **Hierarchy** | Controls float above content. Glass frames, never obscures. Content is king. |
| **Harmony** | Software design aligns with hardware. Concentric corners. Fluid gestures. |
| **Consistency** | Adapt fluidly across iPhone, iPad, Mac. Same identity, contextual expression. |

## Required Reading

Before implementing, read the shared Liquid Glass reference for API patterns:

**`skills/ios-liquid-glass/`** - Core Liquid Glass API, code patterns, navigation patterns, animation philosophy, haptics

This reference contains the technical implementation details. This skill provides the aesthetic vision; the reference provides the code patterns.

## Typography That Speaks

Don't default to system fonts for everything. Create typographic hierarchy:

```swift
// Display fonts for headers
Text("Dashboard")
    .font(.largeTitle.bold())
    .foregroundStyle(.primary)

// Secondary information
Text("Last updated 5 min ago")
    .font(.subheadline)
    .foregroundStyle(.secondary)

// Consider custom fonts for brand identity
Text("Premium")
    .font(.custom("PlayfairDisplay-Bold", size: 32))
```

### Font Recommendations

| Use Case | Options |
|----------|---------|
| **Display** | SF Pro Display, New York, custom serif |
| **Body** | SF Pro Text (system), custom sans |
| **Technical** | SF Mono, custom monospace |
| **Editorial** | New York, custom serif with character |

## Color with Intention

### Dominant + Accent

Don't distribute color evenly. Choose:
- **One dominant** that defines the brand/mood
- **Sharp accents** for actions and highlights
- **Neutral base** for content readability

### Dark Mode First

Dark mode often produces more distinctive results. Design dark, then adapt to light.

```swift
// Semantic colors that adapt
.foregroundStyle(.primary)
.foregroundStyle(.secondary)
.background(.background)

// Accent with purpose
.tint(.accentColor)
```

## Development Loop: Screenshot-Driven Iteration

**Never submit UI work without visually verifying it.** Use the screenshot script to iterate until the screen is both functional and beautiful.

```bash
# Screenshot simulator
xcrun simctl io booted screenshot /tmp/screenshot.png && sips --resampleHeightWidthMax 1800 /tmp/screenshot.png
```

**The loop:**
1. **Implement** your changes
2. **Screenshot** the simulator
3. **Evaluate** critically — is this share-worthy?
4. **Iterate** if not — fix and screenshot again

**Keep iterating until:**
- You'd proudly screenshot it to show a friend
- It could appear in an App Store feature
- It feels like it belongs on Apple's marketing materials

This is the quality bar: **share-worthy, award-worthy**.

## Quality Checklist

Before considering UI complete:

- [ ] Committed to a clear aesthetic direction (not generic)
- [ ] Glass applied only to navigation layer (not content)
- [ ] Haptics on all meaningful interactions
- [ ] Spring/bouncy animations (not linear)
- [ ] SF Symbols (not emojis or random icons)
- [ ] Dark mode tested and polished
- [ ] Typography hierarchy clear and intentional
- [ ] Colors are purposeful, not default blue
- [ ] Morphing transitions where applicable
- [ ] Loading states animated
- [ ] Empty states designed
- [ ] Error states helpful and styled
- [ ] Accessibility settings respected
- [ ] Screenshot taken and visually verified
- [ ] Would I screenshot this to show someone? (If no, iterate)

## The Mandate

Remember: Claude is capable of extraordinary creative work. Don't settle for "working." Push for **memorable**.

Every interface should have:
1. **A point of view** - A clear aesthetic direction
2. **Intentional details** - Nothing accidental
3. **Emotional resonance** - Users feel something
4. **Technical excellence** - Smooth, performant, accessible

The goal is an app worthy of an Apple Design Award—an app that feels genuinely designed, not generated.

## Related Skills

- **`/ios-dev`** - Start here for any iOS task — coordinates guides, correctness checks, and API references
- **`/ios-design-consultant`** - For design questions before coding

© Prisma-Labs-Dev · MIT · Prisma-Labs-Dev/apple-skills

Similar skills

All skills for Mobile →
swiftui-design-skill wholiver swiftui-design-skill designs custom SwiftUI screens for iOS and macOS without generic AI clichés. Useful when drafting interface prototypes or picking a distinct visual direction. CX Codex +1 1,300installs iphone-duo-dual-pane-patterns mirzaaghazadeh iphone-duo-dual-pane-patterns — a skill for Claude Code, Codex, Cursor and other agents: exact pixel and point dimensions for every iPhone Duo display surface, hinge callback signatures, and pose-to-pattern mapping. CX Codex +1 772installs mobile-ios-design Seth Hobson mobile-ios-design guides native iOS interface work with Apple HIG and SwiftUI patterns. Use it when building views, navigation, or adaptive layouts. CX Codex +1 23,659installs ios-hig-design wondelai ios-hig-design is a Claude Code skill for designing native iOS interfaces according to Apple's Human Interface Guidelines, covering safe areas, typography, color, navigation, and SF Symbols. CX Codex +1 9,200installs ios-design-guidelines platform-design-skills ios-design-guidelines — a skill for Claude Code, Cursor, Codex, and other agents that loads Apple Human Interface Guidelines rules into iPhone UI tasks. Activates when working with SwiftUI, UIKit, Dark Mode, Dynamic Type, or accessibility. CX Codex +1 2,200installs ios-ux-design mosif16 ios-ux-design — a skill that gives your coding agent iOS design expertise: HIG compliance checks, SwiftUI pattern review, and implementation specs for interface fixes. CX Codex +1 549installs

From the same set30

The whole set →
tipkit Apple TipKit API reference for Claude Code and coding agents. Helps configure contextual tips, the Tip protocol, and TipView. CX Codex +1 560installs guide-swift-concurrency guide-swift-concurrency guides AI agents through reviewing and writing concurrent Swift 6.2 code under strict concurrency checks. It flags actor reentrancy bugs, unsafe tasks, and GCD patterns. CX Codex +1 539installs guide-swiftdata guide-swiftdata — a skill for writing, reviewing and debugging SwiftData code: safe predicates, autosave rules and CloudKit constraints. CX Codex +1 538installs guide-swift-testing guide-swift-testing provides patterns and review rules for Swift Testing. Helps write and audit test suites targeting Swift 6.2 concurrency. CX Codex +1 534installs guide-swiftui-charts guide-swiftui-charts — a guide skill covering Swift Charts patterns: marks, axes, selection, styling, composition, Chart3D and accessibility. Useful when you build or rework charts in SwiftUI. CX Codex +1 533installs core-animation core-animation — a skill for Claude Code, Cursor, Codex, and other agents: a local QuartzCore reference covering CALayer, CAAnimation, CASpringAnimation, CATransaction, and around twenty more classes. CX Codex +1 508installs guide-swiftui-animations guide-swiftui-animations — a skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that supplies SwiftUI animation patterns to the agent. Activates when building animations, transitions, or motion in SwiftUI views. CX Codex +1 350installs ios-design-consultant ios-design-consultant is a Claude Code skill that advises on iOS visual hierarchy and screen layouts using Liquid Glass principles before implementation, without writing code. CX Codex +1 224installs

Project sponsors

Companies that keep this analytics open