custom-plugin-swift

📦 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

• 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)

# 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

# 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

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

---

Made with ❤️ for the Claude Code Community