awesome-claude-code-subagents README

The project's README from github.com/VoltAgent/awesome-claude-code-subagents. As one markdown file: README.md.

Group 32

The awesome collection of 161+ Claude Code subagents across 10 categories.

Awesome Subagent Count Last Update Discord Official MCP Servers

Awesome Claude Code Subagents

This repository serves as the definitive collection of Claude Code subagents, specialized AI assistants designed for specific development tasks.

A note on contributions: We don't accept PRs whose primary purpose is to promote a product, company, or personal project. Subagents must be genuinely useful to Claude Code users and stay vendor-neutral in their content. If you'd like to get your project in front of this community, you can sponsor the repo instead — that's the supported way to surface your work here.

Sponsors

Crawlbase Crawlbase is web data infrastructure trusted by 70,000+ developers. Its Crawling API, MCP server, and integrations give AI agents live access to any webpage — with JavaScript rendering, proxy rotation, and anti-bot protection.
SerpApi SerpApi is a Web Search API for your AI apps. Available in Markdown and JSON for any integration.

Become a Sponsor

Installation

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-meta orchestration agents work best when other categories installed.

Option 1: Manual Installation

  1. Clone this repository
  2. Copy desired agent files to:
    • ~/.claude/agents/ for global access
    • .claude/agents/ for project-specific use
  3. Customize based on your project requirements

Option 2: Interactive Installer

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

Option 3: Standalone Installer (no clone required)

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.

Option 4: Agent Installer (use Claude Code to install agents)

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


👉 You can feature your product here and reach developers using AI coding agents like Claude Code, Codex, Gemini, and more.

Become a Sponsor

📚 Categories

01. Core Development

Plugin: voltagent-core-dev

Essential development subagents for everyday coding tasks.

02. Language Specialists

Plugin: voltagent-lang

Language-specific experts with deep framework knowledge.

03. Infrastructure

Plugin: voltagent-infra

DevOps, cloud, and deployment specialists.

04. Quality & Security

Plugin: voltagent-qa-sec

Testing, security, and code quality experts.

05. Data & AI

Plugin: voltagent-data-ai

Data engineering, ML, and AI specialists.

06. Developer Experience

Plugin: voltagent-dev-exp

Tooling and developer productivity experts.

07. Specialized Domains

Plugin: voltagent-domains

Domain-specific technology experts.

08. Business & Product

Plugin: voltagent-biz

Product management and business analysis.

09. Meta & Orchestration

Plugin: voltagent-meta

Agent coordination and meta-programming.

10. Research & Analysis

Plugin: voltagent-research

Research, search, and analysis specialists.

🤖 Understanding Subagents

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.

What Makes Subagents Special?

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.

Core Advantages

Getting Started with Subagents

1. Access the Subagent Manager

/agents

2. Create Your Subagent

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

Subagent Storage Locations

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.

📖 Subagent Structure

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

Tool Assignment Philosophy

Smart Model Routing

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.

Tool Assignment Philosophy

Each subagent's tools field specifies Claude Code built-in tools, optimized for their role:

Each agent has minimal necessary permissions. You can extend agents by adding MCP servers or external tools to the tools field.

🧰 Tools

subagent-catalog

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/

AI Design + Build Ecosystem Tools


You ship products with AI, but every launch still dies quietly because nobody posts about it. EveryFeed plugs your AI assistant into a social workspace that drafts, schedules, and publishes across 35+ channels — no agency, no marketing hire.

everyfeed

launchkit

mobilekit

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Contributor ♥️ Thanks

Contributors

📄 License

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.

awesome-claude-code-subagents (VoltAgent/awesome-claude-code-subagents)

ai-agent-framework
Searching Database…

What is this?A curated collection of 158+ specialized subagents for Claude Code: ready-made AI assistants, each tuned to one development task, organized into 10 categories from core development to data and AI.
So it's not an app — what do I actually get when I install it?Agent definition files, not an app: drop them in ~/.claude/agents/ for global access in every project, or in .claude/agents/ to scope them to one repo, then customize them to your needs.
How do I install the agents?As a Claude Code plugin (recommended), by copying files manually, via the interactive installer that browses categories and installs with one command, through the curl-based standalone installer (no clone needed), or with the agent-installer inside Claude Code itself.
Do I need anything besides Claude Code itself?No — Claude Code is the only real requirement. The one exception is the standalone installer, which additionally needs curl.
Any gotchas before I start installing agents?The voltagent-meta orchestration agents only work well once the other categories are installed — so pick up the specialists you need before relying on them.
Which stacks do the language-specialist agents cover?About 30 of them: TypeScript, Python, Go, Rust, Java, Swift, Kotlin, PHP, C#, C++ and Elixir experts, plus framework-specific ones for Next.js, Django, Rails, Spring Boot, FastAPI, Flutter and React Native.
Is the collection still being updated?Yes — the repo is active and not archived; the README now counts 158+ agents across 10 categories, up from the 100+ in its GitHub description.
Creator
VoltAgent
Size
0.9 MB
Stars
26.6K
Updated
CommitNov 02
Age
1y
Commits · 90 Days