A community-driven registry for the Claude Code ecosystem. Not affiliated with Anthropic.
Are you the author? Sign in to claim
130+ specialized subagent markdown files installable into ~/.claude/agents/
This repository serves as the definitive collection of Claude Code subagents, specialized AI assitants designed for specific development tasks.
claude plugin marketplace add VoltAgent/awesome-claude-code-subagents
claude plugin install <plugin-name>
Examples:
claude plugin install voltagent-lang # Language specialists
claude plugin install voltagent-infra # Infrastructure & DevOps
See Categories below for all available plugins.
Note: The
voltagent-metaorchestration agents work best when other categories installed.
~/.claude/agents/ for global access.claude/agents/ for project-specific usegit clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd awesome-claude-code-subagents
./install-agents.sh
This interactive script lets you browse categories, select agents, and install/uninstall them with a single command.
curl -sO https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/install-agents.sh
chmod +x install-agents.sh
./install-agents.sh
Downloads agents directly from GitHub without cloning the repository. Requires curl.
curl -s https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/09-meta-orchestration/agent-installer.md -o ~/.claude/agents/agent-installer.md
Then in Claude Code: "Use the agent-installer to show me available categories" or "Find PHP agents and install php-pro globally".
Tools, platforms, and services for building
If you're building AI agents in TypeScript, VoltAgent gives you tool use, memory, and multi-agent coordination out of the box.
👉 You can feature your product here and reach developers using AI coding agents like Claude Code, Codex, Gemini, and more. |
Plugin: voltagent-core-dev
Essential development subagents for everyday coding tasks.
Plugin: voltagent-lang
Language-specific experts with deep framework knowledge.
Plugin: voltagent-infra
DevOps, cloud, and deployment specialists.
Plugin: voltagent-qa-sec
Testing, security, and code quality experts.
Plugin: voltagent-data-ai
Data engineering, ML, and AI specialists.
Plugin: voltagent-dev-exp
Tooling and developer productivity experts.
Plugin: voltagent-domains
Domain-specific technology experts.
Plugin: voltagent-biz
Product management and business analysis.
Plugin: voltagent-meta
Agent coordination and meta-programming.
Plugin: voltagent-research
Research, search, and analysis specialists.
Subagents are specialized AI assistants that enhance Claude Code's capabilities by providing task-specific expertise. They act as dedicated helpers that Claude Code can call upon when encountering particular types of work.
Independent Context Windows
Every subagent operates within its own isolated context space, preventing cross-contamination between different tasks and maintaining clarity in the primary conversation thread.
Domain-Specific Intelligence
Subagents come equipped with carefully crafted instructions tailored to their area of expertise, resulting in superior performance on specialized tasks.
Shared Across Projects
After creating a subagent, you can utilize it throughout various projects and distribute it among team members to ensure consistent development practices.
Granular Tool Permissions
You can configure each subagent with specific tool access rights, enabling fine-grained control over which capabilities are available for different task types.
1. Access the Subagent Manager
/agents
2. Create Your Subagent
e)3. Deploy and Utilize Your subagent becomes immediately available. Claude Code will automatically engage it when suitable, or you can explicitly request its help:
> Have the code-reviewer subagent analyze my latest commits
| Type | Path | Availability | Precedence |
|---|---|---|---|
| Project Subagents | .claude/agents/ | Current project only | Higher |
| Global Subagents | ~/.claude/agents/ | All projects | Lower |
Note: When naming conflicts occur, project-specific subagents override global ones.
Each subagent follows a standardized template:
---
name: subagent-name
description: When this agent should be invoked
tools: Read, Write, Edit, Bash, Glob, Grep
model: sonnet
---
You are a [role description and expertise areas]...
[Agent-specific checklists, patterns, and guidelines]...
## Communication Protocol
Inter-agent communication specifications...
## Development Workflow
Structured implementation phases...
Each subagent includes a model field that automatically routes it to the right Claude model — balancing quality and cost:
| Model | When It's Used | Examples |
|---|---|---|
opus | Deep reasoning — architecture reviews, security audits, financial logic | security-auditor, architect-reviewer, fintech-engineer |
sonnet | Everyday coding — writing, debugging, refactoring | python-pro, backend-developer, devops-engineer |
haiku | Quick tasks — docs, search, dependency checks | documentation-engineer, seo-specialist, build-engineer |
You can override any agent's model by editing the model field in its frontmatter. Set model: inherit to use whatever model your main conversation is using.
Each subagent's tools field specifies Claude Code built-in tools, optimized for their role:
Read, Grep, Glob - analyze without modifyingRead, Grep, Glob, WebFetch, WebSearch - gather informationRead, Write, Edit, Bash, Glob, Grep - create and executeRead, Write, Edit, Glob, Grep, WebFetch, WebSearch - document with researchEach agent has minimal necessary permissions. You can extend agents by adding MCP servers or external tools to the tools field.
Claude Code skill for browsing and fetching subagents from this catalog.
| Command | Description |
|---|---|
/subagent-catalog:search <query> | Find agents by name, description, or category |
/subagent-catalog:fetch <name> | Get full agent definition |
/subagent-catalog:list | Browse all categories |
/subagent-catalog:invalidate | Refresh cache |
Installation:
cp -r tools/subagent-catalog ~/.claude/commands/
We welcome contributions! See CONTRIBUTING.md for guidelines.
MIT License - see LICENSE
This repository is a curated collection of subagent definitions contributed by both the maintainers and the community. All subagents are provided "as is" without warranty. We do not audit or guarantee the security or correctness of any subagent. Review before use, the maintainers accept no liability for any issues arising from their use.
If you find an issue with a listed subagent or want your contribution removed, please open an issue and we'll address it promptly.
Open-source AI code assistant for VS Code and JetBrains — autocomplete, chat, and agents
Garry Tan's Claude Code setup with 23 tools serving as CEO, Designer, Eng Manager, and QA
Kanban-based orchestration for 10+ coding agents with isolated git worktrees per agent
Battle-tested Claude Code workflows — self-correcting memory, parallel worktrees, 8 hook types, 5 agents
Community Package
@VoltAgent on GitHub