https://github.com/wshobson/agents
Intelligent automation and multi-agent orchestration for Claude Code
https://github.com/wshobson/agents
agents ai ai-agents anthropic anthropic-claude automation claude claude-code claude-code-cli claude-code-commands claude-code-plugin claude-code-plugins claude-code-subagents claudecode claudecode-config claudecode-subagents orchestration sub-agents subagents workflows
Last synced: 5 days ago
JSON representation
Intelligent automation and multi-agent orchestration for Claude Code
- Host: GitHub
- URL: https://github.com/wshobson/agents
- Owner: wshobson
- License: mit
- Created: 2025-07-24T23:28:14.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-10-13T00:06:09.000Z (23 days ago)
- Last Synced: 2025-10-13T14:18:21.518Z (23 days ago)
- Topics: agents, ai, ai-agents, anthropic, anthropic-claude, automation, claude, claude-code, claude-code-cli, claude-code-commands, claude-code-plugin, claude-code-plugins, claude-code-subagents, claudecode, claudecode-config, claudecode-subagents, orchestration, sub-agents, subagents, workflows
- Homepage: https://sethhobson.com
- Size: 1.19 MB
- Stars: 17,647
- Watchers: 198
- Forks: 1,953
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: security-auditor.md
Awesome Lists containing this project
- awesome-claude - agents - 9.8k⭐ - Production-ready subagents for Claude Code (Claude Code Ecosystem / Agent Collections & Orchestration)
- awesome-AI-driven-development - Claude Code Subagents Collection - A comprehensive collection of specialized AI subagents for Claude Code, designed to enhance development workflows with domain-specific expertise. (Frameworks & Libraries / Copilot Extensions & Alternatives)
- awesome-chatgpt-claude-agents - wshobson/agents - 75 specialized subagents that extend Claude Code's capabilities for specific domains (🔹 Claude Code Subagents / Production-Ready Collections)
- StarryDivineSky - wshobson/agents
- awesome-claude-code - **agents** - ready subagents for Claude Code. (Sub Agents)
- awesome - wshobson/agents - Intelligent automation and multi-agent orchestration for Claude Code (Python)
README
# Claude Code Plugins: Orchestration and Automation
> **⚡ Updated for Sonnet 4.5 & Haiku 4.5** — All agents optimized for latest models with hybrid orchestration
>
> **🎯 Agent Skills Enabled** — 47 specialized skills extend Claude's capabilities across plugins with progressive disclosure
A comprehensive production-ready system combining **85 specialized AI agents**, **15 multi-agent workflow orchestrators**, **47 agent skills**, and **44 development tools** organized into **63 focused, single-purpose plugins** for [Claude Code](https://docs.claude.com/en/docs/claude-code/overview).
## Overview
This unified repository provides everything needed for intelligent automation and multi-agent orchestration across modern software development:
- **63 Focused Plugins** - Granular, single-purpose plugins optimized for minimal token usage and composability
- **85 Specialized Agents** - Domain experts with deep knowledge across architecture, languages, infrastructure, quality, data/AI, documentation, business operations, and SEO
- **47 Agent Skills** - Modular knowledge packages with progressive disclosure for specialized expertise
- **15 Workflow Orchestrators** - Multi-agent coordination systems for complex operations like full-stack development, security hardening, ML pipelines, and incident response
- **44 Development Tools** - Optimized utilities including project scaffolding, security scanning, test automation, and infrastructure setup
### Key Features
- **Granular Plugin Architecture**: 63 focused plugins optimized for minimal token usage
- **Comprehensive Tooling**: 44 development tools including test generation, scaffolding, and security scanning
- **100% Agent Coverage**: All plugins include specialized agents
- **Agent Skills**: 47 specialized skills following for progressive disclosure and token efficiency
- **Clear Organization**: 23 categories with 1-6 plugins each for easy discovery
- **Efficient Design**: Average 3.4 components per plugin (follows Anthropic's 2-8 pattern)
### How It Works
Each plugin is completely isolated with its own agents, commands, and skills:
- **Install only what you need** - Each plugin loads only its specific agents, commands, and skills
- **Minimal token usage** - No unnecessary resources loaded into context
- **Mix and match** - Compose multiple plugins for complex workflows
- **Clear boundaries** - Each plugin has a single, focused purpose
- **Progressive disclosure** - Skills load knowledge only when activated
**Example**: Installing `python-development` loads 3 Python agents, 1 scaffolding tool, and makes 5 skills available (~300 tokens), not the entire marketplace.
## Quick Start
### Step 1: Add the Marketplace
Add this marketplace to Claude Code:
```bash
/plugin marketplace add wshobson/agents
```
This makes all 63 plugins available for installation, but **does not load any agents or tools** into your context.
### Step 2: Install Plugins
Browse available plugins:
```bash
/plugin
```
Install the plugins you need:
```bash
# Essential development plugins
/plugin install python-development # Python with 5 specialized skills
/plugin install javascript-typescript # JS/TS with 4 specialized skills
/plugin install backend-development # Backend APIs with 3 architecture skills
# Infrastructure & operations
/plugin install kubernetes-operations # K8s with 4 deployment skills
/plugin install cloud-infrastructure # AWS/Azure/GCP with 4 cloud skills
# Security & quality
/plugin install security-scanning # SAST with security skill
/plugin install code-review-ai # AI-powered code review
# Full-stack orchestration
/plugin install full-stack-orchestration # Multi-agent workflows
```
Each installed plugin loads **only its specific agents, commands, and skills** into Claude's context.
## Documentation
### Core Guides
- **[Plugin Reference](docs/plugins.md)** - Complete catalog of all 63 plugins
- **[Agent Reference](docs/agents.md)** - All 85 agents organized by category
- **[Agent Skills](docs/agent-skills.md)** - 47 specialized skills with progressive disclosure
- **[Usage Guide](docs/usage.md)** - Commands, workflows, and best practices
- **[Architecture](docs/architecture.md)** - Design principles and patterns
### Quick Links
- [Installation](#quick-start) - Get started in 2 steps
- [Essential Plugins](docs/plugins.md#quick-start---essential-plugins) - Top plugins for immediate productivity
- [Command Reference](docs/usage.md#command-reference-by-category) - All slash commands organized by category
- [Multi-Agent Workflows](docs/usage.md#multi-agent-workflow-examples) - Pre-configured orchestration examples
- [Model Configuration](docs/agents.md#model-configuration) - Haiku/Sonnet hybrid orchestration
## What's New
### Agent Skills (47 skills across 14 plugins)
Specialized knowledge packages following Anthropic's progressive disclosure architecture:
**Language Development:**
- **Python** (5 skills): async patterns, testing, packaging, performance, UV package manager
- **JavaScript/TypeScript** (4 skills): advanced types, Node.js patterns, testing, modern ES6+
**Infrastructure & DevOps:**
- **Kubernetes** (4 skills): manifests, Helm charts, GitOps, security policies
- **Cloud Infrastructure** (4 skills): Terraform, multi-cloud, hybrid networking, cost optimization
- **CI/CD** (4 skills): pipeline design, GitHub Actions, GitLab CI, secrets management
**Development & Architecture:**
- **Backend** (3 skills): API design, architecture patterns, microservices
- **LLM Applications** (4 skills): LangChain, prompt engineering, RAG, evaluation
**Blockchain & Web3** (4 skills): DeFi protocols, NFT standards, Solidity security, Web3 testing
**And more:** Framework migration, observability, payment processing, ML operations, security scanning
[→ View complete skills documentation](docs/agent-skills.md)
### Hybrid Model Orchestration
Strategic model assignment for optimal performance and cost:
- **47 Haiku agents** - Fast execution for deterministic tasks
- **97 Sonnet agents** - Complex reasoning and architecture
Orchestration patterns combine models for efficiency:
```
Sonnet (planning) → Haiku (execution) → Sonnet (review)
```
[→ View model configuration details](docs/agents.md#model-configuration)
## Popular Use Cases
### Full-Stack Feature Development
```bash
/full-stack-orchestration:full-stack-feature "user authentication with OAuth2"
```
Coordinates 7+ agents: backend-architect → database-architect → frontend-developer → test-automator → security-auditor → deployment-engineer → observability-engineer
[→ View all workflow examples](docs/usage.md#multi-agent-workflow-examples)
### Security Hardening
```bash
/security-scanning:security-hardening --level comprehensive
```
Multi-agent security assessment with SAST, dependency scanning, and code review.
### Python Development with Modern Tools
```bash
/python-development:python-scaffold fastapi-microservice
```
Creates production-ready FastAPI project with async patterns, activating skills:
- `async-python-patterns` - AsyncIO and concurrency
- `python-testing-patterns` - pytest and fixtures
- `uv-package-manager` - Fast dependency management
### Kubernetes Deployment
```bash
# Activates k8s skills automatically
"Create production Kubernetes deployment with Helm chart and GitOps"
```
Uses kubernetes-architect agent with 4 specialized skills for production-grade configs.
[→ View complete usage guide](docs/usage.md)
## Plugin Categories
**23 categories, 63 plugins:**
- 🎨 **Development** (4) - debugging, backend, frontend, multi-platform
- 📚 **Documentation** (2) - code docs, API specs, diagrams
- 🔄 **Workflows** (3) - git, full-stack, TDD
- ✅ **Testing** (2) - unit testing, TDD workflows
- 🔍 **Quality** (3) - code review, comprehensive review, performance
- 🤖 **AI & ML** (4) - LLM apps, agent orchestration, context, MLOps
- 📊 **Data** (2) - data engineering, data validation
- 🗄️ **Database** (2) - database design, migrations
- 🚨 **Operations** (4) - incident response, diagnostics, distributed debugging, observability
- ⚡ **Performance** (2) - application performance, database/cloud optimization
- ☁️ **Infrastructure** (5) - deployment, validation, Kubernetes, cloud, CI/CD
- 🔒 **Security** (4) - scanning, compliance, backend/API, frontend/mobile
- 💻 **Languages** (7) - Python, JS/TS, systems, JVM, scripting, functional, embedded
- 🔗 **Blockchain** (1) - smart contracts, DeFi, Web3
- 💰 **Finance** (1) - quantitative trading, risk management
- 💳 **Payments** (1) - Stripe, PayPal, billing
- 🎮 **Gaming** (1) - Unity, Minecraft plugins
- 📢 **Marketing** (4) - SEO content, technical SEO, SEO analysis, content marketing
- 💼 **Business** (3) - analytics, HR/legal, customer/sales
- And more...
[→ View complete plugin catalog](docs/plugins.md)
## Architecture Highlights
### Granular Design
- **Single responsibility** - Each plugin does one thing well
- **Minimal token usage** - Average 3.4 components per plugin
- **Composable** - Mix and match for complex workflows
- **100% coverage** - All 85 agents accessible across plugins
### Progressive Disclosure (Skills)
Three-tier architecture for token efficiency:
1. **Metadata** - Name and activation criteria (always loaded)
2. **Instructions** - Core guidance (loaded when activated)
3. **Resources** - Examples and templates (loaded on demand)
### Repository Structure
```
claude-agents/
├── .claude-plugin/
│ └── marketplace.json # 63 plugins
├── plugins/
│ ├── python-development/
│ │ ├── agents/ # 3 Python experts
│ │ ├── commands/ # Scaffolding tool
│ │ └── skills/ # 5 specialized skills
│ ├── kubernetes-operations/
│ │ ├── agents/ # K8s architect
│ │ ├── commands/ # Deployment tools
│ │ └── skills/ # 4 K8s skills
│ └── ... (61 more plugins)
├── docs/ # Comprehensive documentation
└── README.md # This file
```
[→ View architecture details](docs/architecture.md)
## Contributing
To add new agents, skills, or commands:
1. Identify or create the appropriate plugin directory in `plugins/`
2. Create `.md` files in the appropriate subdirectory:
- `agents/` - For specialized agents
- `commands/` - For tools and workflows
- `skills/` - For modular knowledge packages
3. Follow naming conventions (lowercase, hyphen-separated)
4. Write clear activation criteria and comprehensive content
5. Update the plugin definition in `.claude-plugin/marketplace.json`
See [Architecture Documentation](docs/architecture.md) for detailed guidelines.
## Resources
### Documentation
- [Claude Code Documentation](https://docs.claude.com/en/docs/claude-code/overview)
- [Plugins Guide](https://docs.claude.com/en/docs/claude-code/plugins)
- [Subagents Guide](https://docs.claude.com/en/docs/claude-code/sub-agents)
- [Agent Skills Guide](https://docs.claude.com/en/docs/agents-and-tools/agent-skills/overview)
- [Slash Commands Reference](https://docs.claude.com/en/docs/claude-code/slash-commands)
### This Repository
- [Plugin Reference](docs/plugins.md)
- [Agent Reference](docs/agents.md)
- [Agent Skills Guide](docs/agent-skills.md)
- [Usage Guide](docs/usage.md)
- [Architecture](docs/architecture.md)
## License
MIT License - see [LICENSE](LICENSE) file for details.
## Star History
[](https://www.star-history.com/#wshobson/agents&type=date&legend=top-left)