iOS Agent Skills

9 expert-level iOS development skills for AI coding agents

From SwiftUI to security — one install, full coverage.

Most iOS agent skills give you one topic in one file. This collection gives you 9 interconnected skills with 36 deep-dive reference files — the equivalent of a senior iOS engineer's knowledge base, structured for AI agents.

Total: 9 skills, 45 files, ~23,500 lines of production-tested patterns and guidance.

# Install all skills (recommended)
git clone https://github.com/koshkinvv/ios-agent-skills.git
cd ios-agent-skills && ./install.sh

# Or install manually
git clone https://github.com/koshkinvv/ios-agent-skills.git ~/.claude/skills/ios-agent-skills

After installation, skills activate automatically when you work on iOS code. Ask Claude Code to build a SwiftUI view, architect a feature module, write tests, or optimize performance — the relevant skill kicks in.

# Only install what you need
cp -r skills/ios-swiftui ~/.claude/skills/
cp -r skills/ios-testing ~/.claude/skills/

See the Compatibility section below.

Each skill follows a consistent structure:

skills/ios-swiftui/
├── SKILL.md              # Core rules, decision tables, quick patterns
└── references/
    ├── layout.md         # Deep dive: stacks, grids, scroll views
    ├── state.md          # Deep dive: @State, @Observable, @Environment
    ├── navigation.md     # Deep dive: NavigationStack, sheets, deep linking
    ├── animation.md      # Deep dive: springs, transitions, keyframes
    └── patterns.md       # Deep dive: ViewModifier, lifecycle, UIKit interop

SKILL.md is loaded when the skill triggers. It contains:

• Core Rules — 10-15 non-negotiable best practices
• Decision Tables — "what to use when" guides
• Quick Patterns — copy-paste production code
• Anti-Patterns — common mistakes with fixes
• Reference Routing — which reference file to read for each task

Reference files provide deep, topic-specific guidance with extensive code examples. The agent reads them on demand based on the routing table.

Every skill includes decision tables that eliminate guesswork:

State Management — What to Use When (from ios-swiftui)

| Scenario                          | iOS 17+                  | Pre-iOS 17        |
|-----------------------------------|--------------------------|-------------------|
| Simple value owned by view        | @State                   | @State            |
| Reference-type model owned by view| @State + @Observable     | @StateObject      |
| Reference-type model passed in    | just pass it             | @ObservedObject   |
| Shared model via environment      | @Environment + custom key| @EnvironmentObject|

From ios-architecture:

| Project Size                    | Recommended              |
|---------------------------------|--------------------------|
| Small (1 dev, <10 screens)      | MVVM + @Observable       |
| Medium (2-4 devs, 10-30 screens)| MVVM + Clean layers      |
| Large (5+ devs, 30+ screens)    | Clean + SPM modules / TCA|

Every skill documents what NOT to do and why:

From ios-concurrency:

BAD:  Task { @MainActor in self.data = await fetch() }
GOOD: @MainActor func updateUI() { ... }  // isolate at declaration, not call site

These skills use the standard SKILL.md format (YAML frontmatter + markdown) established by Anthropic.

An AGENTS.md file is included in the repo root for agents that read it automatically (Codex, Gemini CLI).

These skills target iOS 17+ with modern APIs (@Observable, Swift Testing, SwiftData, async/await). To customize:

• Support older iOS versions: Adjust decision tables to prefer pre-iOS 17 patterns
• Use specific architecture: Keep only the skills relevant to your stack
• Add project conventions: Extend SKILL.md files with your team's naming conventions, folder structure, or code style

See docs/customization.md for detailed guidance.

Contributions are welcome! See CONTRIBUTING.md for guidelines.

Areas where help is especially appreciated:

• Adding visionOS, watchOS, or macOS-specific patterns
• Updating for new iOS/Xcode releases
• Adding more code examples to reference files
• Translations of documentation

MIT — use freely in personal and commercial projects.

Built with patterns and best practices from:

• Apple Developer Documentation
• Swift Evolution Proposals
• Point-Free (TCA patterns)
• Hacking with Swift (SwiftUI patterns)
• The iOS developer community