A community-driven collection Claude Code agents and sub-agents—turn your Claude instance into an unstoppable team of domain experts! This repo catalogs plug-and-play agents, agent frameworks, and orchestration recipes contributed by the community and curated from public sources.
The Claude Code agent ecosystem has exploded with hundreds of specialized sub-agents, frameworks, and orchestration tools. Here's the most comprehensive directory of all available Claude Code agents, repositories, guides, and resources.
Claude Agents are specialized, task-focused AI "teammates" defined via simple Markdown+YAML files. Each agent lives in .claude/agents/ and is scoped with a clear role, tool set, and behaviour prompt. With sub-agent support, Claude Code can now delegate complex projects to expert agents who work in parallel—just like a real engineering team!
| Name | Type | Role / Highlights | Link |
|---|---|---|---|
| Tech Debt Finder & Fixer | Sub-Agent | Scans codebase for debt, refactors, and automates fixes with test validation | [derek-opdee/subagent-example-script] |
| Architecture Reviewer | Sub-Agent | Detects circular deps, generates diagrams, flags anti-patterns | [derek-opdee/subagent-example-script] |
| Test Generator | Sub-Agent | Suggests, writes, and integrates tests for uncovered paths | [derek-opdee/subagent-example-script] |
| Performance Optimizer | Sub-Agent | Analyzes bundle size, boosts DB/index/query speed, optimizes React | [derek-opdee/subagent-example-script] |
| 28-Subagent Power Pack | Repo | Security, compliance, changelogs, SQL tuning & more (ready-to-use agents) | [wshobson/agents] |
| Claude Code Dev Kit | Meta-Repo | Sets up docs, multi-agent templates, hooks & MCP server integration | [peterkrueck/Claude-Code-Development-Kit] |
| Repository | Sub-Agents | Updated | Highlights |
|---|---|---|---|
| 0xfurai/claude-code-subagents | 100+ | Aug 2025 | Massive collection with uniform prompt format, MIT licensed, multi-language support |
| wshobson/agents | 48 | Jul 2025 | Production-ready specialists with orchestration patterns and advanced workflows |
| vijaythecoder/awesome-claude-agents | 26 | Jul 2025 | AI development team with Tech Lead, Analyst, and specialized domain experts |
| davepoon/claude-code-subagents-collection | 36 | Jul 2025 | Comprehensive collection with auto-delegation and best practices guide |
| charles-adedotun/claude-code-sub-agents | Full ecosystem | Jul 2025 | Workflow-stage based system mapping entire dev lifecycle |
| Repository | Purpose | Key Features |
|---|---|---|
| hesreallyhim/awesome-claude-code-agents | Orchestration framework | Clean interface, sophisticated orchestration logic |
| webdevtodayjason/sub-agents | CLI Manager | NPM installable, context-forge integration, bulk management |
| baryhuang/claude-code-by-agents | Desktop app | Multi-agent workspace, @agent mentions, local+remote agents |
| Dicklesworthstone/claude_code_agent_farm | Orchestration | Multiple Claude sessions in parallel, systematic codebase improvement |
| Repository | Sub-Agents | Specialization |
|---|---|---|
| iannuttall/claude-agents | 7 | Code refactoring, content writing, frontend design, PRD writing |
| zhsama/claude-sub-agent | Workflow system | Spec-driven development pipeline with quality gates |
- Anthropic Sub-Agents Docs - Official reference with YAML templates
- Claude Code Best Practices - Anthropic's official workflow guide
- Common Workflows - Task-specific patterns and examples
| Guide | Author | Focus |
|---|---|---|
| Claude Code: Subagent Deep Dive | cuong.io | Parallelism limits, task queuing, performance benchmarks |
| Mastering Claude Code: The Sub-agent Pattern | Enting's Blog | Hidden features, prompt templates, practical benefits |
| How I use Claude Code | Christian B.B. Houmann | CLAUDE.md, commands, extended thinking, project-specific patterns |
| Claude Code's Custom Agent Framework Changes Everything | dev.to | Enterprise applications, security, parallel execution |
| Video | Creator | Duration | Focus |
|---|---|---|---|
| Claude Code NEW Sub Agents in 7 Minutes | Developers Digest | 7 min | Setup walkthrough, research agent demo |
| Master Claude Code Sub‑Agents in 10 Minutes | Various | 10 min | Complete feature overview |
| How to use Claude Code Agents | Various | N/A | PACT framework for refined agents |
| My Claude Code Sub Agents BUILD THEMSELVES | Various | N/A | Self-building agent patterns |
- Planning: Requirements analyst, architect, tech lead, project planner
- Implementation: Backend/frontend developers, API designers, database specialists
- Quality: Code reviewers, testers, security auditors, performance optimizers
- Operations: DevOps engineers, incident responders, deployment specialists
- Documentation: Technical writers, API documenters, changelog generators
- Languages: Python, JavaScript, TypeScript, Go, Rust, Java specialists
- Frameworks: React, Vue, Django, FastAPI, Spring Boot experts
- Cloud: AWS, GCP, Azure architects and troubleshooters
- Data: ML engineers, data scientists, analytics specialists
- Security: Penetration testers, compliance auditors, crypto experts
- Content: Copywriters, blog authors, social media managers
- Sales: Lead generators, email automators, CRM specialists
- Analytics: Business analysts, growth hackers, conversion optimizers
- Support: Customer service, FAQ creators, documentation writers
- subagents.cc - Dedicated Claude agent directory
- Reddit Communities: r/ClaudeAI, r/programming - Active sharing and discussion
- GitHub Topics: #claude-agents, #claude-code, #subagents
- Multi-Agent Orchestration System - 4-agent VSCode terminal setup
- 49 Subagents Running 2.5 Hours - Large-scale orchestration demo
- Tinybird Multi-Agent Analytics - Real-world analytics integration
- Sequential: Agent A → Agent B → Agent C → Result
- Parallel: Multiple agents execute simultaneously, merge results
- Conditional: Dynamic routing based on analysis
- Review & Validation: Primary agent → Review agent → Final result
- Context Preservation: Separate context windows prevent pollution
- Tool Scoping: Limit permissions to necessary tools only
- Batch Processing: Queue tasks efficiently (10 parallel max)
- Smart Delegation: Automatic vs. explicit agent invocation
- wshobson/agents - 248+ stars, production-ready
- iannuttall/claude-agents - 248 stars, community favorite
- 0xfurai/claude-code-subagents - Newest, largest collection
- vijaythecoder/awesome-claude-agents - AI development focus
- Beginners: iannuttall/claude-agents (7 agents, simple setup)
- Production Teams: wshobson/agents (48 agents, enterprise patterns)
- Maximum Coverage: 0xfurai/claude-code-subagents (100+ agents)
- Development Teams: vijaythecoder/awesome-claude-agents (orchestrated workflow)
# 100+ agent mega-collection
git clone https://github.com/0xfurai/claude-code-subagents.git ~/.claude/agents/mega-pack
# Production-ready 48-agent collection
git clone https://github.com/wshobson/agents ~/.claude/agents/wh-production
# AI development team (26 agents)
git clone https://github.com/vijaythecoder/awesome-claude-agents ~/.claude/agents/ai-team
# Comprehensive collection (36 agents)
git clone https://github.com/davepoon/claude-code-subagents-collection ~/.claude/agents/comprehensive# CLI manager for sub-agents
npm install -g claude-sub-agents-manager
# Or clone the manager
git clone https://github.com/webdevtodayjason/sub-agentsQuick-Start Recipes
- Create a ProjectLocal Sub-Agent
mkdir -p .claude/agents
cat > .claude/agents/code-reviewer.md <<'EOF'
---
name: code-reviewer
description: "Use proactively to review new pull requests for style, security, and test coverage."
tools: grep, view, edit, mcp-gemini
---
You are a senior code reviewer. Provide inline comments and suggest fixes...
EOFAny request that includes “review” language will now trigger this agent automatically.
- Clone Community Packs
# Download Derek Dee’s power pack
mkdir -p ~/.claude/agents
curl -sL https://raw.githubusercontent.com/derek-opdee/subagent-example-script/main/sub-agent-tech-debt-finder-fixer.md -o ~/.claude/agents/tech-debt.md
# Download W. Shobson’s 28-agent bundle
git clone https://github.com/wshobson/agents ~/.claude/agents/wh-bundle- Invoke Explicitly
> Use the test-generator sub agent to create Jest tests for the new Cart module
or launch several agents at once:
> Spawn 3 subagents:
> 1. Security audit
> 2. Lint & style check
> 3. Bundle size analysis
Claude will queue and run up to 10 tasks in parallel.
Directory Structuring Tips
- Project agents (.claude/agents/) take priority over user-level agents (~/.claude/agents/).
- Prefix agent files with numbers (like 01_, 02_) to sort their order in the /agents listing.
- Keep system prompts brief; long role descriptions increase token use.
- Limit access to only the necessary tools for each agent to maintain security and efficiency.
Common Pitfalls & Solutions
| Issue | Cause | Solution |
|---|---|---|
| Sub-agent ignores task | Vague description | Use explicit trigger phrases like “use proactively for X” |
| Token blow-ups | Overly long system prompts | Reuse boilerplate; make role descriptions concise |
| No output merge | Each agent authors a full plan | Add a step where the main agent merges all findings |
| Max parallelism at 10 | System-imposed task cap | Batch remaining tasks; more start as others finish |
Mix and match roles, tweak YAML front-matter, and contribute your own agents back to this directory!
- Specialise Roles: “Proactively review PRs for security and lint errors,” “only optimize SQL queries in src/db/.”
- Limit Permissions: List only the tools/commands each agent truly needs for maximum safety.
- Keep Context Lean: Set concise system prompts to control token cost per spawn.
- Provide Dry-Run / Interactive Modes: Where possible, so users stay in control.
This directory represents the complete ecosystem as of August 2025. The Claude Code agent community continues to grow rapidly, with new repositories, tools, and patterns emerging weekly.
- Agent Marketplaces: Community-driven agent sharing platforms
- Cross-Platform Integration: Agents working across different development environments
- Self-Improving Agents: Agents that modify and optimize themselves
- Multi-Model Orchestration: Different Claude models for different agent roles
- Real-Time Collaboration: Multiple users working with shared agent teams
For the latest updates, monitor the GitHub repositories and Reddit communities listed in the Community & Platforms section above.
- Fork this repo, add your
my-unique-agent.mdfiles to the main directory, and open a PR. - Include a short description and a working example in each agent file.
- Want your own agent repo included? Submit a link and summary via PR or issue.
MIT License for this directory. Individual agent files may contain separate copyright/attribution info.
Big thanks to everyone building and open-sourcing specialist Claude agents—your work powers this community!
Want to be featured? Suggest your repo or agent file via PR or issue.
: https://github.com/derek-opdee/subagent-example-script
: https://github.com/wshobson/agents
: https://github.com/peterkrueck/Claude-Code-Development-Kit
“The most powerful Claude agents feel like hiring a team of experts—but you get code reviews, migrations, and tests done in minutes.”
– Community Contributor
Happy hacking! Add, remix, and power up your Claude!