wshobson / agents
Intelligent automation and multi-agent orchestration for Claude Code
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.
Repository Summary (README)
PreviewClaude Code Plugins: Orchestration and Automation
ā” Updated for Opus 4.6, Sonnet 4.6 & Haiku 4.5 ā Three-tier model strategy for optimal performance
šÆ 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:
| 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 |
# ā 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
- Plugin Reference - Complete catalog of all 72 plugins
- Agent Reference - All 112 agents organized by category
- Agent Skills - 146 specialized skills with progressive disclosure
- Usage Guide - Commands, workflows, and best practices
- Architecture - Design principles and patterns
Quick Links
- Installation - Get started in 2 steps
- Essential Plugins - Top plugins for immediate productivity
- Command Reference - All slash commands organized by category
- Multi-Agent Workflows - Pre-configured orchestration examples
- Model Configuration - Haiku/Sonnet hybrid orchestration
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:setupcreates product vision, tech stack, workflow rules, and style guides - Track-Based Development ā
/conductor:new-trackgenerates specifications and phased implementation plans - TDD Workflow ā
/conductor:implementexecutes tasks with verification checkpoints - Semantic Revert ā
/conductor:revertundoes 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:
| Tier | Model | Agents | Use Case |
|---|---|---|---|
| Tier 1 | Opus 4.6 | 42 | Critical architecture, security, ALL code review, production coding (language pros, frameworks) |
| Tier 2 | Inherit | 42 | Complex tasks - user chooses model (AI/ML, backend, frontend/mobile, specialized) |
| Tier 3 | Sonnet | 51 | Support with intelligence (docs, testing, debugging, network, API docs, DX, legacy, payments) |
| Tier 4 | Haiku | 18 | Fast 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 opusorclaude --model sonnetwhen 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
inherittier 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 concurrencypython-testing-patterns- pytest and fixturesuv-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.
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:
- Metadata - Name and activation criteria (always loaded)
- Instructions - Core guidance (loaded when activated)
- 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
Contributing
To add new agents, skills, or commands:
- Identify or create the appropriate plugin directory in
plugins/ - Create
.mdfiles in the appropriate subdirectory:agents/- For specialized agentscommands/- For tools and workflowsskills/- For modular knowledge packages
- Follow naming conventions (lowercase, hyphen-separated)
- Write clear activation criteria and comprehensive content
- 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.