📦 Install Now · 🤖 Explore Agents · 📖 Documentation · ⭐ Star this repo

---

What is this?

Swift Development Assistant is a Claude Code plugin with 8 agents and 12 skills for mastering Swift, iOS, macOS, and Apple ecosystem development.

---

📑 Table of Contents

Click to expand

• Quick Start
• Features
• Agents
• Skills
• Commands
• Documentation
• Contributing
• License

---

🚀 Quick Start

Prerequisites

• Claude Code CLI v2.0.27+
• Active Claude subscription
• Swift 5.9+ / Xcode 15+

Installation (Choose One)

Option 1: From Marketplace (Recommended)

# Step 1️⃣ Add the marketplace
/plugin marketplace add pluginagentmarketplace/custom-plugin-swift

# Step 2️⃣ Install the plugin
/plugin install swift-development-assistant

# Step 3️⃣ Restart Claude Code
# Close and reopen your terminal/IDE

Option 2: Local Installation

# Clone the repository
git clone https://github.com/pluginagentmarketplace/custom-plugin-swift.git
cd custom-plugin-swift

# Load locally
/plugin load .

# Restart Claude Code

✅ Verify Installation

After restart, you should see these agents:

swift-development-assistant:01-swift-fundamentals
swift-development-assistant:02-swift-ios
swift-development-assistant:03-swift-swiftui
swift-development-assistant:04-swift-data
swift-development-assistant:05-swift-macos
swift-development-assistant:06-swift-testing
swift-development-assistant:07-swift-performance
swift-development-assistant:08-swift-advanced

---

✨ Features

Feature	Description
🤖 8 Agents	Specialized AI agents for Swift/iOS/macOS
🛠️ 12 Skills	Complete Golden Format with real templates
⌨️ 4 Commands	Swift-specific slash commands
🔄 SASMP v1.3.0	Full protocol compliance
📱 iOS/macOS	Full Apple ecosystem support

---

🤖 Agents

8 Specialized Swift Agents

#	Agent	Purpose
1	swift-fundamentals	Swift basics, optionals, protocols, extensions
2	swift-ios	iOS app development, UIKit, lifecycle
3	swift-swiftui	SwiftUI framework, declarative UI
4	swift-data	Data management, Core Data, persistence
5	swift-macos	macOS development, AppKit, sandboxing
6	swift-testing	XCTest, TDD, mocking, coverage
7	swift-performance	Optimization, profiling, memory
8	swift-advanced	Metaprogramming, macros, generics

---

🛠️ Skills

Available Skills (12 Golden Format)

Skill	Description	Invoke
swift-fundamentals	Language basics, optionals, protocols	Skill("swift-fundamentals")
swift-ios-basics	iOS development fundamentals	Skill("swift-ios-basics")
swift-swiftui	SwiftUI framework mastery	Skill("swift-swiftui")
swift-uikit	UIKit framework patterns	Skill("swift-uikit")
swift-networking	URLSession, async networking	Skill("swift-networking")
swift-core-data	Core Data persistence	Skill("swift-core-data")
swift-combine	Reactive programming	Skill("swift-combine")
swift-concurrency	async/await, actors	Skill("swift-concurrency")
swift-spm	Swift Package Manager	Skill("swift-spm")
swift-architecture	MVVM, Clean Architecture	Skill("swift-architecture")
swift-testing	XCTest, TDD patterns	Skill("swift-testing")
swift-macos	macOS development	Skill("swift-macos")

---

⌨️ Commands

Command	Description
/swift-check	Analyze project for issues and best practices
/swift-new	Create new project or component
/swift-build	Build for iOS/macOS with various options
/swift-test	Run tests with coverage reporting

---

📚 Documentation

Document	Description
CHANGELOG.md	Version history
CONTRIBUTING.md	How to contribute
LICENSE	License information

---

📁 Project Structure

Click to expand

custom-plugin-swift/
├── 📁 .claude-plugin/
│   └── plugin.json
├── 📁 agents/                    # 8 Swift agents
│   ├── 01-swift-fundamentals.md
│   ├── 02-swift-ios.md
│   ├── 03-swift-swiftui.md
│   ├── 04-swift-data.md
│   ├── 05-swift-macos.md
│   ├── 06-swift-testing.md
│   ├── 07-swift-performance.md
│   └── 08-swift-advanced.md
├── 📁 skills/                    # 12 Golden Format skills
│   ├── swift-fundamentals/
│   ├── swift-ios-basics/
│   ├── swift-swiftui/
│   ├── swift-uikit/
│   ├── swift-networking/
│   ├── swift-core-data/
│   ├── swift-combine/
│   ├── swift-concurrency/
│   ├── swift-spm/
│   ├── swift-architecture/
│   ├── swift-testing/
│   └── swift-macos/
├── 📁 commands/                  # 4 commands
│   ├── swift-check.md
│   ├── swift-new.md
│   ├── swift-build.md
│   └── swift-test.md
├── 📁 hooks/
│   └── hooks.json
├── 📄 README.md
├── 📄 CHANGELOG.md
└── 📄 LICENSE

---

📱 Platform Support

Platform	Minimum Version
iOS	15.0+
macOS	12.0+
watchOS	8.0+
tvOS	15.0+

---

📅 Metadata

Field	Value
Version	2.0.0
Last Updated	2025-12-29
Status	Production Ready
SASMP	v1.3.0
Agents	8
Skills	12
Commands	4

---

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide.

1. Fork the repository
2. Create your feature branch
3. Follow the Golden Format for new skills
4. Submit a pull request

---

⚠️ Security

Important: This repository contains third-party code and dependencies.

• ✅ Always review code before using in production
• ✅ Check dependencies for known vulnerabilities
• ✅ Follow security best practices
• ✅ Report security issues privately via Issues

---

📝 License

Copyright © 2025 Dr. Umit Kacar & Muhsin Elcicek

Custom License - See LICENSE for details.

---

👥 Contributors

Dr. Umit Kacar Senior AI Researcher & Engineer

Muhsin Elcicek Senior Software Architect

---

Made with ❤️ for the Claude Code Community