Guide · Open source
How to use awesome-claude-code-subagents with Claude Code
Updated · written with AI from the project's own documentation and checked against our catalogue data
awesome-claude-code-subagents is an open-source repository of Markdown files, each defining a specialist subagent for Claude Code, Anthropic's coding assistant. It is aimed at developers who already use Claude Code and want helpers tuned for specific jobs such as API design, a programming language or DevOps. This guide shows how to install the repository's agents, either as plugins or as files, and how to choose which ones to keep.
Claude Code SubagentsVoltAgent/awesome-claude-code-subagents · ★ 26.3k · MIT Install options & downloads Quick start
- 1Confirm Claude Code is set up. The only listed prerequisite is Claude Code. Make sure you can run it before adding any agents.
- 2Pick your categories. Browse the category list in the README and decide which specialists you need, such as language or DevOps agents.
- 3Add the marketplace. Run the claude plugin marketplace add command with the repository name.
- 4Install a plugin. Run claude plugin install with the plugin name for your chosen category, for example voltagent-lang.
- 5Or copy files manually. Clone the repository and copy the agent files you want into ~/.claude/agents/ or .claude/agents/.
- 6Test a subagent. Give Claude Code a task that matches an agent's specialty and check the output before relying on it.
What the repository contains
The repository is a curated set of Markdown files. Each file defines one subagent that is tuned for a particular job, such as API design, a programming language, or DevOps work.
The README describes the collection as more than 100 specialised subagents organised into categories. Examples include api-designer in Core Development, typescript-pro in Language Specialists, and a set of Infrastructure and DevOps agents in the voltagent-infra plugin.
- 01. Core Development (plugin voltagent-core-dev), for everyday coding tasks such as backend-developer and frontend-developer
- 02. Language Specialists (plugin voltagent-lang), for language and framework experts such as golang-pro and django-developer
- Infrastructure and DevOps (plugin voltagent-infra)
- Meta orchestration agents (plugin voltagent-meta)
Install with the Claude Code plugin marketplace
This is the method the README marks as recommended. First add the repository as a plugin marketplace, then install the plugin category you need. Replace the placeholder with a plugin name from the categories list.
The README notes that the voltagent-meta orchestration agents work best when other categories are installed as well.
claude plugin marketplace add VoltAgent/awesome-claude-code-subagents
claude plugin install <plugin-name>
claude plugin install voltagent-lang
claude plugin install voltagent-infraInstall agents manually by copying files
Clone the repository, then copy the agent files you want into a Claude Code agents folder. Use the user-level folder to make an agent available everywhere, or the project folder to limit it to one project. After copying, you can edit each file to fit your project.
Picking only a few agents keeps the set small and easier to manage.
- Global access: ~/.claude/agents/
- Project-specific use: .claude/agents/
git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd awesome-claude-code-subagentsUse the interactive installer
If you cloned the repository, run the included script. It lets you browse categories, select agents, and install or uninstall them in one tool.
If you do not want to clone, the README shows a standalone version that downloads the script directly. It requires curl.
- Clone and run: git clone, then cd into the folder, then run the script
- Standalone: download install-agents.sh, make it executable, and run it
./install-agents.sh
curl -sO https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/install-agents.sh
chmod +x install-agents.sh
./install-agents.shInstall an agent by asking Claude Code
The README also offers an agent-installer file. Download it into your agents folder, then ask Claude Code in plain language to list categories or install a specific agent.
- Example request: Use the agent-installer to show me available categories
- Example request: Find PHP agents and install php-pro globally
curl -s https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/09-meta-orchestration/agent-installer.md -o ~/.claude/agents/agent-installer.mdCheck quality before relying on an agent
The README does not describe testing or formal quality review of each agent. Treat the files as a starting point. Read the agent definition, adjust its instructions for your codebase, and test it on low-risk work before using it on critical production code.
The repository's own contribution rules say pull requests must be genuinely useful to Claude Code users and stay vendor-neutral. That is a contribution policy, not a verification process.
What people use it for
- A backend developer installing api-designer and backend-developer to help plan and build REST or GraphQL endpoints
- A team using language specialists such as typescript-pro or golang-pro as a starting point for their own agent definitions
- A DevOps engineer installing the voltagent-infra plugin for infrastructure tasks
- A developer copying only two or three agent files into a single project's .claude/agents/ folder
Frequently asked questions
Is awesome-claude-code-subagents free to use?
The repository is released under the MIT licence, as stated in its listing. Check the LICENSE file in the repository for the full terms before redistributing.
What do I need to install awesome-claude-code-subagents?
The listed prerequisite is Claude Code. The standalone installer also requires curl, and the clone-based installer requires git to fetch the repository.
How do I install a single agent instead of the whole collection?
Copy only the agent file you want into ~/.claude/agents/ or .claude/agents/, or install just one plugin category with claude plugin install. The README says you can pick only a few agents rather than installing everything.
Where do Claude Code subagents go after I copy them?
Put them in ~/.claude/agents/ for global access across projects, or in .claude/agents/ inside a project for project-specific use.
Are the agents tested or verified for production use?
The README does not describe testing or quality review of each agent. Review and test any agent yourself before using it on critical work.
What are the alternatives to awesome-claude-code-subagents?
The README lists wshobson/agents and iannuttall/claude-agents as comparable projects. Compare their agent coverage and install methods against your needs before choosing.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
This collection suits developers who already use Claude Code and want specialist helpers for particular languages, frameworks or DevOps tasks, especially if they plan to install only a few agents. It is less suitable if you do not use Claude Code, or if you need agents whose quality has been tested for critical production work, since the README does not describe that kind of review.
Install options & downloads