The repo started years ago as just my zsh config (yes, back when I was a Product Manager!) As my Claude Code setup has been getting more dialed in, it made sense to track that the same way.
It's all in there: my global CLAUDE.md, settings.json, a FlowDeck hook, and a manifest of the agent skills I lean on for Swift, SwiftUI, UIKit, and accessibility work. One install.sh symlinks everything and re-installs the skills.
If you're another iOS engineer trying to make Claude actually work for you, take what's useful.
What's included
- zsh/ — .zshrc and .aliases.
- claude/.claude/CLAUDE.md — Global instructions covering Swift style, verification rules, PR/commit conventions, and pointers to every agent skill.
- claude/.claude/settings.json — Theme, enabled plugins, and the FlowDeck PreToolUse hook.
- hooks/flowdeck/flowdeck-guard.sh — Blocks xcodebuild, xcrun simctl, xcrun devicectl, and friends in favor of FlowDeck, the agent-friendly replacement for Apple's CLI tools.
- hooks/prose-guard.py — Stop hook that blocks banned phrasing in agent prose.
- agents/.agents/skills/ — Agent skills I wrote myself, tracked as content because nothing else can restore them.
- skills.manifest — Every external agent skill I use, with the npx install command to re-install it.
Agent skills
- swift-concurrency — async/await, actors, Sendable, Swift 6 strict-concurrency migration.
- swift-testing-expert — Swift Testing (@Test, #expect, traits, parameterization), XCTest migration.
- swiftui-expert-skill — SwiftUI state, layout, animation, Instruments trace analysis.
- ios-accessibility — VoiceOver, Dynamic Type, traits, focus order; iOS-wide audit.
- airbnb-swift-style — Enforces the Airbnb Swift style guide.