agents

# Claude Code Plugins: Orchestration and Automation

> **⚡ Updated for Opus 4.7, Sonnet 4.6 & Haiku 4.5** — Three-tier model strategy for optimal performance

[![Run in Smithery](https://smithery.ai/badge/skills/wshobson)](https://smithery.ai/skills?ns=wshobson&utm_source=github&utm_medium=badge)

> **🎯 Agent Skills Enabled** — 150 specialized skills extend Claude's capabilities across plugins with progressive disclosure

A comprehensive production-ready system combining **184 specialized AI agents**, **16 multi-agent workflow orchestrators**, **150 agent skills**, and **98 commands** organized into **78 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:

- **78 Focused Plugins** - Granular, single-purpose plugins optimized for minimal token usage and composability
- **184 Specialized Agents** - Domain experts with deep knowledge across architecture, languages, infrastructure, quality, data/AI, documentation, business operations, and SEO
- **150 Agent Skills** - Modular knowledge packages with progressive disclosure for specialized expertise
- **16 Workflow Orchestrators** - Multi-agent coordination systems for complex operations like full-stack development, security hardening, ML pipelines, and incident response
- **98 Commands** - Optimized utilities including project scaffolding, security scanning, test automation, and infrastructure setup

### Key Features

- **Granular Plugin Architecture**: 78 focused plugins optimized for minimal token usage
- **Comprehensive Tooling**: 98 commands including test generation, scaffolding, and security scanning
- **100% Agent Coverage**: All plugins include specialized agents
- **Agent Skills**: 150 specialized skills following for progressive disclosure and token efficiency
- **Clear Organization**: 25 categories with 1-10 plugins each for easy discovery
- **Efficient Design**: Average 3.6 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 16 skills available (~1000 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 78 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 16 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 comprehensive-review       # Multi-perspective code analysis

# 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.

### Plugins vs Agents

You install **plugins**, which bundle agents:

| Plugin                  | Agents                                            |
| ----------------------- | ------------------------------------------------- |
| `comprehensive-review`  | architect-review, code-reviewer, security-auditor |
| `javascript-typescript` | javascript-pro, typescript-pro                    |
| `python-development`    | python-pro, django-pro, fastapi-pro               |
| `blockchain-web3`       | blockchain-developer                              |

```bash
# ❌ Wrong - can't install agents directly
/plugin install typescript-pro

# ✅ Right - install the plugin
/plugin install javascript-typescript@claude-code-workflows
```

### Troubleshooting

**"Plugin not found"** → Use plugin names, not agent names. Add `@claude-code-workflows` suffix.

**Plugins not loading** → Clear cache and reinstall:

```bash
rm -rf ~/.claude/plugins/cache/claude-code-workflows && rm ~/.claude/plugins/installed_plugins.json
```

## Documentation

### Core Guides

- **[Plugin Reference](docs/plugins.md)** - Complete catalog of all 78 plugins
- **[Agent Reference](docs/agents.md)** - All 184 agents organized by category
- **[Agent Skills](docs/agent-skills.md)** - 150 specialized skills with progressive disclosure
- **[Usage Guide](docs/usage.md)** - Commands, workflows, and best practices
- **[Architecture](docs/architecture.md)** - Design principles and patterns
- **[PluginEval](docs/plugin-eval.md)** - Quality evaluation framework (layers, dimensions, scoring)

### 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

### PluginEval — Quality Evaluation Framework (NEW)

A three-layer evaluation framework for measuring and certifying plugin/skill quality:

```bash
/plugin install plugin-eval@claude-code-workflows
```

- **Three Evaluation Layers** — Static analysis (instant), LLM judge (semantic), Monte Carlo simulation (statistical)
- **10 Quality Dimensions** — Triggering accuracy, orchestration fitness, output quality, scope calibration, progressive disclosure, token efficiency, robustness, structural completeness, code template quality, ecosystem coherence
- **Quality Badges** — Platinum (★★★★★), Gold (★★★★), Silver (★★★), Bronze (★★)
- **Anti-Pattern Detection** — OVER_CONSTRAINED, EMPTY_DESCRIPTION, MISSING_TRIGGER, BLOATED_SKILL, ORPHAN_REFERENCE, DEAD_CROSS_REF
- **Statistical Rigor** — Wilson score CI, bootstrap CI, Clopper-Pearson exact CI, Elo ranking
- **CLI + Claude Code** — `uv run plugin-eval score/certify/compare` or `/eval`, `/certify`, `/compare` commands
- **CI Gate** — `--threshold` flag exits non-zero below a minimum score

```bash
# Quick evaluation (static only, instant)
uv run plugin-eval score path/to/skill --depth quick

# Standard evaluation (static + LLM judge)
uv run plugin-eval score path/to/skill --depth standard

# Full certification (all layers + Elo)
uv run plugin-eval certify path/to/skill
```

[→ View PluginEval documentation](docs/plugin-eval.md)

### Agent Teams Plugin

Orchestrate multi-agent teams for parallel workflows using Claude Code's experimental Agent Teams feature:

```bash
/plugin install agent-teams@claude-code-workflows
```

- **7 Team Presets** — `review`, `debug`, `feature`, `fullstack`, `research`, `security`, `migration`
- **Parallel Code Review** — `/team-review src/ --reviewers security,performance,architecture`
- **Hypothesis-Driven Debugging** — `/team-debug "API returns 500" --hypotheses 3`
- **Parallel Feature Development** — `/team-feature "Add OAuth2 auth" --plan-first`
- **Research Teams** — Parallel investigation across codebase and web sources
- **Security Audits** — 4 reviewers covering OWASP, auth, dependencies, and secrets
- **Migration Support** — Coordinated migration with parallel streams and correctness verification

Includes 4 specialized agents, 7 commands, and 6 skills with reference documentation.

[→ View agent-teams documentation](plugins/agent-teams/README.md)

### Conductor Plugin — Context-Driven Development

Transforms Claude Code into a project management tool with a structured **Context → Spec & Plan → Implement** workflow:

```bash
/plugin install conductor@claude-code-workflows
```

- **Interactive Setup** — `/conductor:setup` creates product vision, tech stack, workflow rules, and style guides
- **Track-Based Development** — `/conductor:new-track` generates specifications and phased implementation plans
- **TDD Workflow** — `/conductor:implement` executes tasks with verification checkpoints
- **Semantic Revert** — `/conductor:revert` undoes work by logical unit (track, phase, or task)
- **State Persistence** — Resume setup across sessions with persistent project context
- **3 Skills** — Context-driven development, track management, workflow patterns

[→ View Conductor documentation](plugins/conductor/README.md)

### Agent Skills (150 skills across 37 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