/ Directory / Playground / Awesome Claude Code Subagents
← All servers ↗ GitHub
● Community VoltAgent ⚡ Instant

Awesome Claude Code Subagents

by VoltAgent · VoltAgent/awesome-claude-code-subagents

100+ specialized Claude Code subagents covering frontend, backend, infra, security, performance, data — call the expert, not the generalist.

VoltAgent's awesome-claude-code-subagents is a library of opinionated subagent configs — each one a domain expert with its own system prompt, tool allowlist, and review checklist. You delegate to a 'security reviewer' or 'performance auditor' as a subagent, get focused output, then have the main agent integrate.

▶ Watch demo 📦 Install 💡 Use Cases

Why use it

Key features

Live Demo

What it looks like in practice

ready

Install

Author repository · Claude Skills documentation

Use Cases

Real-world ways to use Awesome Claude Code Subagents

Delegate a security review to a specialist subagent

👤 Devs shipping features that touch auth/data ⏱ ~20 min intermediate

When to use: Your main agent wrote auth code; you want a second pair of eyes from a focused subagent.

Flow
  1. Spawn
    Use awesome-subagents. Spawn the 'security-reviewer' subagent on src/auth.✓ Copied
    → Subagent reports findings
  2. Triage
    Group findings by severity. Identify which the main agent should fix now vs file as issues.✓ Copied
    → Triaged list

Outcome: Security feedback on every PR without paying a real reviewer's salary.

Pitfalls
  • Subagent finds things the main agent disagrees with — Your call — usually the security-focused output is right; default to caution
Combine with: claude-hud-skill

Run a performance audit subagent over a hot path

👤 Devs profiling slow features ⏱ ~45 min intermediate

When to use: An endpoint is slow and you want focused performance review.

Flow
  1. Scope
    Spawn the 'perf-auditor' subagent on the /orders endpoint. Include the DB schema.✓ Copied
    → Findings: N+1, missing indexes, hot loops
  2. Apply
    Apply the top 3 fixes; benchmark before/after.✓ Copied
    → Latency drop with numbers

Outcome: Real performance gains, not vibes.

Pitfalls
  • Subagent suggests micro-optimizations — Push for impact ranking; ignore noise

Find the right subagent for a niche task

👤 Devs new to the catalog ⏱ ~15 min beginner

When to use: You have a specific task and don't know which subagent to use.

Flow
  1. Search
    List subagents that are good for 'Postgres query optimization'.✓ Copied
    → 2-3 candidates with scope
  2. Try
    Use the top match on /reports/slow_queries.sql.✓ Copied
    → Targeted analysis

Outcome: Right tool for the job; less generic agent reasoning.

Pitfalls
  • Subagent definitions overlap — Pick the most narrowly scoped one

Combinations

Pair with other MCPs for X10 leverage

awesome-claude-subagents + claude-hud-skill

Spawn subagents and watch their progress live

Spawn 3 reviewers; track via HUD.✓ Copied
awesome-claude-subagents + mcp-agent-mail

Subagents coordinate via mail to avoid duplicate work

Subagents post claims to #review thread before starting.✓ Copied

Tools

What this MCP exposes

ToolInputsWhen to callCost
list_subagents domain? Discovery free
spawn_subagent name, scope, task Delegate a focused task tokens for the subagent run

Cost & Limits

What this costs to run

API quota
N/A
Tokens per call
Each subagent run is its own context — costs add up; budget consciously
Monetary
Free
Tip
Use subagents only when the task is truly specialist; don't over-delegate

Security

Permissions, secrets, blast radius

Minimum scopes: Per-subagent — some need shell, some don't
Credential storage: None inherent
Data egress: Depends on subagent's tools
Never grant: Wide tool access to subagents that don't need it

Troubleshooting

Common errors and fixes

Subagent runs forever

Set timeouts; some are over-eager

Subagent ignored scope

Be more explicit in the spawn task; set strict path scope

Alternatives

Awesome Claude Code Subagents vs others

AlternativeWhen to use it insteadTradeoff
Single multi-tool agentTasks are general-purposeLess focused output
wshobson/agentsYou want a different curated setOverlap; pick the philosophy you prefer

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills

Continue exploring

Related tools and workflows

Choose another guide for your workflow, or explore a collection.

Browse all topic collections → · See 29 new official additions →