swift-skills

Swift Agent Skills

Currency-checked agent skills for shipping SwiftUI apps — a SwiftUI-first lifecycle, craft specialists, and Apple-framework experts. SwiftUI-first, not UIKit. Built for Claude Code; installs into any Agent Skills–compatible agent.

By Moritz Tucher · GitHub · LinkedIn

63 skills · 4 agents · 4 hooks · 3 iOS reference guides

What this is

A working, opinionated ~/.claude/ setup focused on shipping production SwiftUI apps with Claude Code. It's SwiftUI-first throughout — views are SwiftUI, state is @Observable, navigation is NavigationStack; UIKit/AppKit appear only where you genuinely must bridge (a few system pickers, AppKit for macOS targets). It encodes a light, UI-first workflow across five phases — Setup → Plan → Build → Verify → Ship — alongside specialist skills for SwiftUI craft, design audits, onboarding, and simulator automation. Plan with a living brief, build the flow before the logic, ship.

It's built around the mistakes Claude makes on iOS by default — and corrects them. It won't nest a NavigationStack inside another NavigationStack and break your back button. It reaches for @Observable instead of @Published / ObservableObject, because it's 2026. It won't ship a tappable control without an .accessibilityLabel. The taste is baked into the skills, not bolted on after.

It's the configuration I use day-to-day. The skills compose into one pipeline (/ios-init → /ios-brief → build features UI-first → /ios-review → /ios-commit → /pr-to-develop), but each one stands on its own. Not sure what to run next? Type /ios — the orchestrator detects where your project is and routes you to the right step. Drop into any iOS project and they pick up the local CLAUDE.md for context.

What this isn't

• Not a UIKit toolkit — it's SwiftUI-first; UIKit only shows up where you must bridge (the occasional system picker or sheet)
• Not a fork of every public Claude Code skill — it's curated, not comprehensive
• Not a framework — it's a config snapshot you copy into ~/.claude/
• Not a substitute for thinking about your architecture — the skills surface decisions, you still make them
• Not affiliated with Anthropic — Claude Code is Anthropic's product; this repo provides community-contributed configuration

Installation

Fastest path — install the skills + agents as a Claude Code plugin:

/plugin marketplace add moritztucher/swift-agent-skills
/plugin install swift-skills@swift-agent-skills

These skills follow the open Agent Skills format (a SKILL.md per skill + references/), so they also install into any other skills-compatible agent — Cursor, Codex, Gemini CLI, Kiro, and others — via the community CLI:

npx skills add moritztucher/swift-agent-skills

The Claude plugin path gives you the 63 skills and 4 agents, namespaced under the plugin. For the full setup — skills, agents, the framework reference guides (loaded via @import), the hooks, and the example settings — one command drops the pieces into ~/.claude/, backing up anything already there:

npx swift-agent-skills

It never overwrites an existing CLAUDE.md, settings.json, or statusline-command.sh; run with --dry-run to preview, or --yes to skip the prompt. Prefer to do it by hand? The equivalent manual steps:

# 1. Clone into a working directory
git clone https://github.com/moritztucher/swift-agent-skills.git
cd swift-agent-skills

# 2. Back up anything you already have
[ -d ~/.claude/skills ] && mv ~/.claude/skills ~/.claude/skills.backup
[ -d ~/.claude/agents ] && mv ~/.claude/agents ~/.claude/agents.backup
[ -d ~/.claude/docs ] && mv ~/.claude/docs ~/.claude/docs.backup
[ -d ~/.claude/hooks ] && mv ~/.claude/hooks ~/.claude/hooks.backup

# 3. Drop the pieces in
mkdir -p ~/.claude
cp -R skills ~/.claude/
cp -R agents ~/.claude/
cp -R docs ~/.claude/
cp -R hooks ~/.claude/
chmod +x ~/.claude/hooks/*.sh

# 4. Optional: copy the global CLAUDE.md (won't overwrite existing without `-i`)
cp -i CLAUDE.md ~/.claude/CLAUDE.md

# 5. Optional: copy settings.json (review first — it enables specific plugins and hooks)
cp -i settings/settings.json.example ~/.claude/settings.json
cp -i statusline-command.sh ~/.claude/statusline-command.sh
chmod +x ~/.claude/statusline-command.sh

Skill context budget (Claude Code)

Claude Code lists every skill's name + description in context, but caps the listing at ~1% of the context window (skillListingBudgetFraction, default 0.01) — with 63 skills that budget overflows, and descriptions of less-used skills get silently dropped (names stay). Rather than raising the budget and paying ~10k tokens in every session, settings.json.example ships a curated skillOverrides block: