By josepo616
Specialized Swift/SwiftUI agents that enforce the Ravn Way — MVVM + SOA, @Observable, Swift Testing, constructor injection. Agents dynamically load rules from swift-agent-skills at runtime.
Specialized agent that reviews Swift/SwiftUI code against all Ravn conventions — analyzes, reports violations, does NOT auto-fix
Specialized agent that architects complete feature modules (Model, Service, ViewModel, View, Tests) following the Ravn Way
Specialized agent that engineers comprehensive Swift Testing test suites for ViewModels and Services following the Ravn Way
Claude Code agents that perform real work on Swift/SwiftUI codebases following Ravn's architecture.
These agents are the Action Layer — they dynamically load rules from swift-agent-skills at runtime and apply them as composed, automated workflows.
swift-agent-subagents (ACTION LAYER)
Specialized agents that think and develop. Loads skills at runtime for latest rules.
▼ reads at runtime
swift-agent-skills (KNOWLEDGE LAYER)
Source of truth for best practices. 16+ skills as SKILL.md files.
Installed at: .claude/skills/{NN}-{name}/SKILL.md
Skills = source of truth ("here's how to do X correctly") Agents = specialized executors ("do X for me, correctly, the Ravn way")
Agents do not embed static copies of skill rules. Instead, each agent's first step is to read the SKILL.md files from the project's installed swift-agent-skills. This means:
swift-agent-skills automatically updates what agents enforceStep 1 — Register both repos as plugin marketplaces:
/plugin marketplace add [email protected]:Josepo616/swift-agent-skills.git
/plugin marketplace add [email protected]:Josepo616/swift-agent-subagents.git
Note: If you have HTTPS auth configured (e.g., via
gh auth login), you can use the shorthand instead:/plugin marketplace add Josepo616/swift-agent-skills
Step 2 — Install the skills (knowledge layer):
/plugin install swift-agent-skills@swift-agent-skills
Step 3 — Install the agents (action layer):
/plugin install swift-agent-subagents@swift-agent-subagents
If you have the repos cloned locally:
claude --plugin-dir /path/to/swift-agent-skills --plugin-dir /path/to/swift-agent-subagents
Both repos are now available in your project via Claude Code's plugin system.
| Agent | Purpose | Skills Loaded |
|---|---|---|
/feature-architect <name> | Architects a complete feature module (Model, Service, ViewModel, View, Tests) | 01, 04, 05, 06, 07, 09, 10, 13, 15 |
/code-reviewer <path> | Reviews Swift code against all Ravn conventions | ALL (01-16+) |
/test-engineer <path> | Engineers comprehensive Swift Testing test suites | 10, 15, 07 + optional 01, 03, 06, 09 |
| Command | Purpose |
|---|---|
/audit-security [path] | Scan for security anti-patterns |
/audit-performance [path] | Find SwiftUI performance issues |
/audit-accessibility [path] | Check accessibility compliance |
/build-network-layer | Scaffold a complete networking layer |
Every agent enforces these non-negotiable defaults:
| Decision | The Ravn Way |
|---|---|
| Architecture | MVVM + Service-Oriented Architecture |
| ViewModel rule | 1 View : 1 ViewModel (strict) |
| Service design | Protocol contract + concrete implementation |
| Observation | @Observable + @MainActor (iOS 17+) |
| Testing framework | Swift Testing (import Testing) |
| DI approach | Constructor injection via protocols |
| Feature structure | Model / Service / ViewModel / View folders |
| State modeling | Loadable<T> enum (idle/loading/loaded/failed) |
swift-agent-subagents/
├── .claude-plugin/
│ ├── plugin.json # Plugin metadata for distribution
│ └── marketplace.json # Marketplace catalog for /plugin install
├── agents/ # Specialized agents
│ ├── feature-architect.md # /feature-architect <name>
│ ├── code-reviewer.md # /code-reviewer <path>
│ └── test-engineer.md # /test-engineer <path>
├── .claude/
│ └── subagents-project-spec.md # Project specification
├── knowledge/
│ └── skill-reference-map.md # Maps skills to agent dependencies
├── README.md
└── LICENSE
MIT
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub josepo616/swift-agent-subagents --plugin swift-agent-subagentsComprehensive skill pack with 66 specialized skills for full-stack developers: 12 language experts (Python, TypeScript, Go, Rust, C++, Swift, Kotlin, C#, PHP, Java, SQL, JavaScript), 10 backend frameworks, 6 frontend/mobile, plus infrastructure, DevOps, security, and testing. Features progressive disclosure architecture for 50% faster loading.
Comprehensive PR review agents specializing in comments, tests, error handling, type design, code quality, and code simplification
Comprehensive feature development workflow with specialized agents for codebase exploration, architecture design, and quality review
Develop, test, build, and deploy Godot 4.x games with Claude Code. Includes GdUnit4 testing, web/desktop exports, CI/CD pipelines, and deployment to Vercel/GitHub Pages/itch.io.
A growing collection of Claude-compatible academic workflow bundles. Covers scientific figures, manuscript writing and polishing, reviewer assessment, citation retrieval, data availability, paper reading, literature search, response letters, paper-to-PPTX conversion, and evidence-grounded Chinese invention patent drafting. Rules are organized as reusable skill folders with explicit workflows and quality checks.
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.