ios-design-skills
heyimjames/ios-design-skills
Four detailed iOS/SwiftUI design-engineering skills for Claude Code, Cursor, Codex, Windsurf, Aider, Continue, and Zed — camera & photos, chat & messaging, interaction primitives (widgets/Live Activities/haptics), and the final 5% of polish.
Instalação
npx convez-ai heyimjames/ios-design-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
iOS Design Engineering Skills
Five detailed, opinionated design-engineering skills for building best-in-class native Swift/SwiftUI apps on iOS and macOS — installable into Claude Code, Cursor, Codex CLI, Windsurf, Aider, Continue, and Zed.
"Whoever made this actually gives a shit." That's the only goal.
Looking for cross-platform skills? OG image design lives in a sibling marketplace: heyimjames/design-engineering-skills.
What's in here
| Skill | What it covers | Lines |
|---|---|---|
| Camera & Photos | Capture UX, viewfinder, editing flows, library, AI photo features, AVFoundation / PhotoKit / Vision / LiDAR / Cinematic / ProRAW / Camera Control button | ~668 |
| Chat & Messaging | Bubble grouping, composer, reactions, voice messages, typing/presence, encryption, CallKit / PushKit / Live Activities / NSE / Communication Notifications | ~881 |
| Interaction Primitives | Home / Lock / StandBy widgets, Live Activities, Dynamic Island, Haptic Touch, .sensoryFeedback, Core Haptics, Action Button, Symbol Effects, Focus filters, Liquid Glass | ~1127 |
| The Final 5% | Motion physics, hero transitions, typography, color hierarchy (OKLCH + Display P3), spacing rhythm, buttons & CTAs, sheets & detents, shareable image generation, loading/empty states, microcopy, accessibility-as-polish, iOS 26 Liquid Glass | ~2978 |
| macOS App Design | Native macOS app design — window architecture, NavigationSplitView sidebar, toolbar conventions, menu bar, Cmd-K command palette, hover/trackpad/right-click, multi-window/document architecture, MenuBarExtra, Liquid Glass on Tahoe, code-app specifics (syntax highlighting, file trees), Settings window, About panel, Sparkle distribution. OpenAI Codex / Linear / Things 3 quality. | ~1919 |
Each skill is opinionated and specific — exact spring damping ratios, exact corner radii, exact haptic styles, exact font sizes. The kind of detail that separates a competent app from a beloved one.
Install
Pick your tool. One command, one place.
First-time:
chmod +x install.sh build.sh(the script will tell you if you forgot).
Claude Code (via plugin marketplace — recommended)
In any Claude Code session:
/plugin marketplace add heyimjames/ios-design-skills
/plugin install heyimjames@heyimjames
After install, the five skills are namespace-prefixed under your brand:
heyimjames:camera-and-photos
heyimjames:chat-and-messaging
heyimjames:interaction-primitives
heyimjames:the-final-5-percent
heyimjames:macos-app-design
Every invocation requires typing heyimjames: — branding by design. Claude Code auto-invokes each skill based on the Triggers on: keyword list in its description, so you rarely have to type the name yourself in conversational use.
For LOCAL development (so edits to your local clone are picked up by Claude Code without re-pushing to GitHub):
/plugin marketplace add /path/to/this/repo
/plugin install heyimjames@heyimjames
To uninstall:
/plugin uninstall heyimjames@heyimjames
/plugin marketplace remove heyimjames
Cursor
./install.sh cursor # project-level: .cursor/rules/
./install.sh cursor --global # user-level: ~/.cursor/rules/
Generates .mdc rule files with file globs so each skill auto-attaches when relevant Swift files are open. Camera skill activates on Camera*.swift / Photo*.swift / AV*.swift; chat skill on Message*.swift / Chat*.swift; etc. The polish skill applies to all Swift files.
Codex CLI (OpenAI)
./install.sh codex # project: appends to ./AGENTS.md
./install.sh codex --global # user: appends to ~/.codex/AGENTS.md
Wraps the four skills in marker comments (<!-- BEGIN ios-design-skills -->) so re-running install/uninstall updates cleanly.
Windsurf
./install.sh windsurf
Drops .windsurfrules into the current project.
Aider
./install.sh aider
Drops CONVENTIONS.md into the current project. Add read: CONVENTIONS.md to your .aider.conf.yml to pin it.
Continue
./install.sh continue # project: .continue/rules/
./install.sh continue --global # user: ~/.continue/rules/
Zed
./install.sh zed
Drops the four skills into .rules/ in the current project.
Uninstall any tool
./install.sh <tool> uninstall
How auto-invocation works in each tool
| Tool | Mechanism | Configured by |
|---|---|---|
| Claude Code | Description-based — the model matches the user's prompt against each skill's description + trigger keywords. Plugin namespacing prefixes every skill name with heyimjames: | Already baked into the canonical SKILL.md frontmatter + plugins/heyimjames/.claude-plugin/plugin.json |
| Cursor | File globs — rule auto-attaches when matching files are in context | globs: injected by the build script |
| Codex / Aider / Windsurf | Always-loaded — present in every prompt of the project | Just install once per project |
| Continue | Description-based + .md file frontmatter | Injected by the build script |
| Zed | Always-loaded if .rules/ exists | Just install once per project |
No changes are needed to the canonical SKILL.md files — the build script injects tool-specific invocation hints.
Updating
git pull
./build.sh all # regenerate dist/ from skills/
./install.sh <tool> # reinstall (idempotent — re-overwrites)
If you edit anything in skills/*/SKILL.md, run ./build.sh before committing so the dist/ variants stay in sync.
Repo layout
ios-design-skills/ ← marketplace root
├── README.md
├── LICENSE ← MIT
├── .claude-plugin/
│ └── marketplace.json ← Claude Code marketplace catalog
├── plugins/
│ └── heyimjames/ ← the plugin (name = invocation prefix)
│ ├── .claude-plugin/
│ │ └── plugin.json ← plugin manifest
│ └── skills/ ← canonical source (Claude Code native)
│ ├── camera-and-photos/SKILL.md
│ ├── chat-and-messaging/SKILL.md
│ ├── interaction-primitives/SKILL.md
│ ├── the-final-5-percent/SKILL.md
│ └── macos-app-design/SKILL.md
├── install.sh ← per-tool installer for non-Claude tools
├── build.sh ← regenerates dist/ from canonical source
├── scripts/
│ └── build.py ← Python build logic (stdlib only)
└── dist/ ← auto-generated per-tool variants
├── cursor/.cursor/rules/*.mdc
├── codex/AGENTS.md
├── aider/CONVENTIONS.md
├── windsurf/.windsurfrules
├── continue/.continue/rules/*.md
└── zed/.rules/*.md
Philosophy
These skills aren't checklists. They're opinions, encoded as practical patterns:
- Glanceability is the entire design constraint. A widget gets 0.5 seconds. The Dynamic Island gets less. Design for the half-second.
- One App Intent, many surfaces. Since iOS 17, the same
AppIntentpowers Home widgets, Lock widgets, StandBy, Control Center, Action Button, and Siri. Architect once, surface six places. - Polish everything equally. Settings page = hero page = empty state = error screen. The "dirty bathroom" rule: one neglected corner cheapens the whole.
- Simultaneous motion reads as mechanical; sequential reads as organic. Stagger by 30–80ms.
- The user shouldn't NOTICE polish — they should FEEL it. They can't articulate why your app feels different. They just know.
Reference apps studied in the writing: Halide, Kino, Lapse, Locket, (Not Boring) Camera, VSCO, Apple Photos, iMessage, Telegram, WhatsApp, Snapchat, Instagram, Discord, Things 3, Linear, Family, Granola, Flighty, Moonlitt, Sunlitt, Apple Music, Apple Fitness.
Reference reading: Rauno Freiberg — Invisible Details of Interaction Design, Karri Saarinen's 10 Rules, The Linear Method, Family Values by Benji Taylor, Apple HIG, Donny Wals — Liquid Glass on iOS 26.
Status
🔒 Private repo for now. Currently distributed by direct git clone among James + collaborators.
Public plan (eventually):
- Flip repo to public.
- Submit to Claude Code's plugin marketplace.
- Add a small landing page.
brew tapfor Homebrew install.- Contribution guidelines.
License
MIT — see LICENSE. Use them, fork them, ship apps with them.
Made by James Frewin of October, a design studio · @james_frewin · LinkedIn