Awesome Subagent Count Last Update Discord

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.

Installation

As Claude Code Plugin (Recommended)

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

Sponsors
Ego Lite is the fastest browser for your AI agents to run browser automation tasks, 3.45x faster than agent-browser (Vercel), always free, no setup, and lets your agents run 100+ browser tasks at the same time in their Spaces.

📚 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

  • Memory Efficiency: Isolated contexts prevent the main conversation from becoming cluttered with task-specific details
  • Enhanced Accuracy: Specialized prompts and configurations lead to better results in specific domains
  • Workflow Consistency: Team-wide subagent sharing ensures uniform approaches to common tasks
  • Security Control: Tool access can be restricted based on subagent type and purpose

Getting Started with Subagents

1. Access the Subagent Manager

/agents

2. Create Your Subagent

  • Choose between project-specific or global subagents
  • Let Claude generate an initial version, then refine it to your needs
  • Provide detailed descriptions of the subagent's purpose and activation triggers
  • Configure tool access (leave empty to inherit all available tools)
  • Customize the system prompt using the built-in editor (press 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

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, Edi