Featured

Deploy OpenClaw in 60 seconds — 20% off logoDeploy OpenClaw in 60 seconds — 20% off

Launch OpenClaw on Hostinger in about 60 seconds and keep your agent live 24/7. Our referral link gives you 20% off, no coupon code needed.

Launch on Hostinger
Run your Hermes agent on Hostinger, fully managed logoRun your Hermes agent on Hostinger, fully managed

Launch Hermes on Hostinger in one click, fully managed, no VPS knowledge needed. Use code ZACAARON10 for 10% off.

Launch on Hostinger
Crawl and scrape any site into clean data, 10% off logoCrawl and scrape any site into clean data, 10% off

Firecrawl crawls and scrapes any site into clean markdown for your agent. Get 1,000 free credits, and new users get 10% off their first purchase.

Try Firecrawl free
Your own AI agent, running 24/7 with QwikClaw logoYour own AI agent, running 24/7 with QwikClaw

QwikClaw sets up and runs an always-on OpenClaw agent for you. One click, no config files, no server setup.

Deploy now
One API to scrape, enrich, and extract the internet. logoOne API to scrape, enrich, and extract the internet.

Context.dev gives your agents a single API to scrape, enrich, and extract live web data — no proxies, no parsers, no maintenance.

Start building free
SetupClaw: done-for-you OpenClaw for founders & exec teams logoSetupClaw: done-for-you OpenClaw for founders & exec teams

White-glove OpenClaw for founders and exec teams (4–50+ employees): we install, harden, integrate your tools, and maintain it — secured from day one.

Get it set up for you
SEO data APIs for your agent, $1 free credit logoSEO data APIs for your agent, $1 free credit

DataForSEO gives your agent live access to SERP results, keyword data, backlinks, and on-page SEO data through one API. New accounts get a $1 credit, good for up to 20,000 keyword or backlink lookups.

Try DataForSEO free
Reach 47,000+ AI builders

A flat monthly placement in front of developers actively installing AI tools. No lock-in, cancel anytime.

Advertise here
voltagent-qa-sec logo

voltagent-qa-sec

voltagent-subagents

qualityClaude Codeby KrishMatrix

Summary

Testing, security, and code quality experts - code review, penetration testing, QA automation

Install to Claude Code

/plugin install voltagent-qa-sec@voltagent-subagents

Run in Claude Code. Add the marketplace first with /plugin marketplace add KrishMatrix/claude_agent- if you haven't already.

README.md

<a href="https://github.com/VoltAgent/voltagent"> <img width="1500" height="500" alt="Group 32" src="https://github.com/user-attachments/assets/55b97c47-8506-4be0-b18f-f5384d063cbb" /> </a>

<br /> <br/>

<div align="center"> <strong>The awesome collection of Claude Code subagents.</strong> <br /> <br /> </div>

<div align="center">

![Awesome](https://awesome.re) <a href="https://github.com/VoltAgent/voltagent"> <img alt="VoltAgent" src="https://cdn.voltagent.dev/website/logo/logo-2-svg.svg" height="20" /> </a>

![AI Agent Papers](https://github.com/VoltAgent/awesome-ai-agent-papers) !Subagent Count ![Last Update](https://github.com/VoltAgent/awesome-claude-code-subagents) ![Discord](https://s.voltagent.dev/discord) ![GitHub forks](https://github.com/VoltAgent/awesome-claude-code-subagents/network/members)

</div>

Awesome Claude Code Subagents

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

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

<br />

<a href="https://github.com/VoltAgent/voltagent"> <img width="1390" height="296" alt="social" src="https://github.com/user-attachments/assets/5d8822c0-e97b-4183-a71e-a922ab88e1a0" /> </a>

📚 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, 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:

  • Read-only agents (reviewers, auditors): Read, Grep, Glob - analyze without modifying
  • Research agents (analysts, researchers): Read, Grep, Glob, WebFetch, WebSearch - gather information
  • Code writers (developers, engineers): Read, Write, Edit, Bash, Glob, Grep - create and execute
  • Documentation agents (writers, documenters): Read, Write, Edit, Glob, Grep, WebFetch, WebSearch - document with research

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/

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

  • Submit new subagents via PR
  • Improve existing definitions
  • Report issues and bugs

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.

Related plugins

Browse all →