back to home

wshobson / agents

Intelligent automation and multi-agent orchestration for Claude Code

29,087 stars
3,189 forks
2 issues
PythonC#Shell

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing wshobson/agents in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind-ai.vercel.app/repo/wshobson/agents)
Preview:Analyzed by RepoMind

Repository Summary (README)

Preview

Claude Code Plugins: Orchestration and Automation

⚔ Updated for Opus 4.6, Sonnet 4.6 & Haiku 4.5 — Three-tier model strategy for optimal performance

Run in Smithery

šŸŽÆ Agent Skills Enabled — 146 specialized skills extend Claude's capabilities across plugins with progressive disclosure

A comprehensive production-ready system combining 112 specialized AI agents, 16 multi-agent workflow orchestrators, 146 agent skills, and 79 development tools organized into 72 focused, single-purpose plugins for Claude Code.

Overview

This unified repository provides everything needed for intelligent automation and multi-agent orchestration across modern software development:

  • 72 Focused Plugins - Granular, single-purpose plugins optimized for minimal token usage and composability
  • 112 Specialized Agents - Domain experts with deep knowledge across architecture, languages, infrastructure, quality, data/AI, documentation, business operations, and SEO
  • 146 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
  • 79 Development Tools - Optimized utilities including project scaffolding, security scanning, test automation, and infrastructure setup

Key Features

  • Granular Plugin Architecture: 72 focused plugins optimized for minimal token usage
  • Comprehensive Tooling: 79 development tools including test generation, scaffolding, and security scanning
  • 100% Agent Coverage: All plugins include specialized agents
  • Agent Skills: 146 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 16 skills available (~1000 tokens), not the entire marketplace.

Quick Start

Step 1: Add the Marketplace

Add this marketplace to Claude Code:

/plugin marketplace add wshobson/agents

This makes all 72 plugins available for installation, but does not load any agents or tools into your context.

Step 2: Install Plugins

Browse available plugins:

/plugin

Install the plugins you need:

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

PluginAgents
comprehensive-reviewarchitect-review, code-reviewer, security-auditor
javascript-typescriptjavascript-pro, typescript-pro
python-developmentpython-pro, django-pro, fastapi-pro
blockchain-web3blockchain-developer
# āŒ 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:

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

Documentation

Core Guides

Quick Links

What's New

Agent Teams Plugin (NEW)

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

/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

Conductor Plugin — Context-Driven Development

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

/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

Agent Skills (146 skills across 21 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 (8 skills): LangGraph, prompt engineering, RAG, evaluation, embeddings, similarity search, vector tuning, hybrid search

Blockchain & Web3 (4 skills): DeFi protocols, NFT standards, Solidity security, Web3 testing

Project Management:

  • Conductor (3 skills): context-driven development, track management, workflow patterns

And more: Framework migration, observability, payment processing, ML operations, security scanning

→ View complete skills documentation

Three-Tier Model Strategy

Strategic model assignment for optimal performance and cost:

TierModelAgentsUse Case
Tier 1Opus 4.642Critical architecture, security, ALL code review, production coding (language pros, frameworks)
Tier 2Inherit42Complex tasks - user chooses model (AI/ML, backend, frontend/mobile, specialized)
Tier 3Sonnet51Support with intelligence (docs, testing, debugging, network, API docs, DX, legacy, payments)
Tier 4Haiku18Fast operational tasks (SEO, deployment, simple docs, sales, content, search)

Why Opus 4.6 for Critical Agents?

  • 80.8% on SWE-bench (industry-leading)
  • 65% fewer tokens for complex tasks
  • Best for architecture decisions and security audits

Tier 2 Flexibility (inherit): Agents marked inherit use your session's default model, letting you balance cost and capability:

  • Set via claude --model opus or claude --model sonnet when starting a session
  • Falls back to Sonnet 4.6 if no default specified
  • Perfect for frontend/mobile developers who want cost control
  • AI/ML engineers can choose Opus for complex model work

Cost Considerations:

  • Opus 4.6: $5/$25 per million input/output tokens - Premium for critical work
  • Sonnet 4.6: $3/$15 per million tokens - Balanced performance/cost
  • Haiku 4.5: $1/$5 per million tokens - Fast, cost-effective operations
  • Opus's 65% token reduction on complex tasks often offsets higher rate
  • Use inherit tier to control costs for high-volume use cases

Orchestration patterns combine models for efficiency:

Opus (architecture) → Sonnet (development) → Haiku (deployment)

→ View model configuration details

Popular Use Cases

Full-Stack Feature Development

/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

Security Hardening

/security-scanning:security-hardening --level comprehensive

Multi-agent security assessment with SAST, dependency scanning, and code review.

Python Development with Modern Tools

/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

# 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

Plugin Categories

24 categories, 72 plugins:

  • šŸŽØ Development (4) - debugging, backend, frontend, multi-platform
  • šŸ“š Documentation (3) - code docs, API specs, diagrams, C4 architecture
  • šŸ”„ Workflows (5) - git, full-stack, TDD, Conductor (context-driven development), Agent Teams (multi-agent orchestration)
  • āœ… Testing (2) - unit testing, TDD workflows
  • šŸ” Quality (2) - 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

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 112 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          # 72 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
│   └── ... (65 more plugins)
ā”œā”€ā”€ docs/                          # Comprehensive documentation
└── README.md                      # This file

→ View architecture details

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 for detailed guidelines.

Resources

Documentation

This Repository

License

MIT License - see LICENSE file for details.

Star History

Star History Chart