awesome-claude-code-subagents

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Awesome Claude Code Subagents

优秀Claude Code子Agent集合

Skill by ara.so — Claude Code Skills collection.
ara.so开发的Skill — Claude Code Skills集合。

What It Is

是什么

A curated collection of 130+ specialized Claude Code subagents organized into 9 categories. Each subagent is a markdown file that configures Claude with expert knowledge in a specific domain (language, framework, infrastructure, security, etc.). Installing subagents enhances Claude's capabilities for targeted development tasks.
这是一个经过精心整理的集合,包含130+个专业Claude Code子Agent,分为9个类别。每个子Agent都是一个markdown文件,为Claude配置了特定领域(语言、框架、基础设施、安全等)的专业知识。安装子Agent可增强Claude在针对性开发任务中的能力。

Installation Methods

安装方法

Method 1: Individual Agent Installation

方法1:单独安装Agent

Copy specific agent files to your Claude agents directory:
bash
undefined
将特定Agent文件复制到你的Claude agents目录:
bash
undefined

Global installation (available in all projects)

全局安装(所有项目可用)

Project-specific installation

项目专属安装

Method 2: Interactive Installer (Recommended)

方法2:交互式安装器(推荐)

bash
undefined
bash
undefined

Clone and run interactive installer

克隆并运行交互式安装器

git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git cd awesome-claude-code-subagents chmod +x install-agents.sh ./install-agents.sh

The installer provides:
- Browse by category
- Search agents by keyword
- Install/uninstall globally or per-project
- View agent descriptions
git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git cd awesome-claude-code-subagents chmod +x install-agents.sh ./install-agents.sh

该安装器提供以下功能:
- 按类别浏览
- 通过关键词搜索Agent
- 全局或按项目安装/卸载
- 查看Agent描述

Method 3: Standalone Installer (No Clone)

方法3:独立安装器(无需克隆)

bash
undefined
bash
undefined

Download and run installer directly

直接下载并运行安装器

undefined
undefined

Method 4: Meta Agent Installer

方法4:元Agent安装器

Install the agent-installer subagent to manage others through Claude:
bash
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 use natural language:
  • "Show me available Python subagents"
  • "Install the FastAPI developer agent globally"
  • "What infrastructure agents are available?"
安装agent-installer子Agent,通过Claude管理其他Agent:
bash
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
之后可使用自然语言指令:
  • "Show me available Python subagents"
  • "Install the FastAPI developer agent globally"
  • "What infrastructure agents are available?"

Categories and Key Agents

类别与核心Agent

01. Core Development (
categories/01-core-development/
)

01. 核心开发(
categories/01-core-development/

Essential development subagents:
bash
undefined
基础开发子Agent:
bash
undefined

API development

API开发

Full-stack development

全栈开发


**Key agents**: api-designer, backend-developer, frontend-developer, fullstack-developer, microservices-architect, mobile-developer

**核心Agent**:api-designer, backend-developer, frontend-developer, fullstack-developer, microservices-architect, mobile-developer

02. Language Specialists (
categories/02-language-specialists/
)

02. 语言专家(
categories/02-language-specialists/

Language and framework experts:
bash
undefined
语言与框架专家:
bash
undefined

Python specialist

Python专家

TypeScript specialist

TypeScript专家

Framework specialists

框架专家


**Key agents**: python-pro, typescript-pro, golang-pro, rust-engineer, nextjs-developer, react-specialist, django-developer, fastapi-developer, laravel-specialist, spring-boot-engineer

**核心Agent**:python-pro, typescript-pro, golang-pro, rust-engineer, nextjs-developer, react-specialist, django-developer, fastapi-developer, laravel-specialist, spring-boot-engineer

03. Infrastructure (
categories/03-infrastructure/
)

03. 基础设施(
categories/03-infrastructure/

DevOps and cloud specialists:
bash
undefined
DevOps与云服务专家:
bash
undefined

Terraform expert

Terraform专家

Kubernetes specialist

Kubernetes专家


**Key agents**: terraform-engineer, kubernetes-specialist, docker-expert, devops-engineer, cloud-architect, azure-infra-engineer, sre-engineer

**核心Agent**:terraform-engineer, kubernetes-specialist, docker-expert, devops-engineer, cloud-architect, azure-infra-engineer, sre-engineer

04. Quality & Security (
categories/04-quality-security/
)

04. 质量与安全(
categories/04-quality-security/

Testing and security experts:
bash
undefined
测试与安全专家:
bash
undefined

Code reviewer

代码评审员

Security specialist

安全专家


**Key agents**: code-reviewer, security-engineer, penetration-tester, qa-engineer, debugger, compliance-auditor

**核心Agent**:code-reviewer, security-engineer, penetration-tester, qa-engineer, debugger, compliance-auditor

Usage Patterns

使用模式

Pattern 1: Project-Specific Setup

模式1:项目专属配置

Install agents relevant to your tech stack:
bash
undefined
安装与技术栈匹配的Agent:
bash
undefined

Next.js + TypeScript + PostgreSQL project

Next.js + TypeScript + PostgreSQL项目

mkdir -p .claude/agents
mkdir -p .claude/agents

Frontend

前端

Database

数据库

Infrastructure

基础设施

Pattern 2: Global Utilities

模式2:全局工具

Install universal helpers globally:
bash
undefined
安装通用辅助Agent:
bash
undefined

Code quality

代码质量

Documentation

文档

Git workflows

Git工作流

Pattern 3: Batch Category Installation

模式3:批量类别安装

Install entire categories with a script:
bash
undefined
通过脚本安装整个类别:
bash
undefined

Install all language specialists

安装所有语言专家Agent

mkdir -p ~/.claude/agents
for agent in python-pro typescript-pro golang-pro rust-engineer; do curl -o ~/.claude/agents/${agent}.md
${BASE_URL}/${CATEGORY}/${agent}.md done
undefined
mkdir -p ~/.claude/agents
for agent in python-pro typescript-pro golang-pro rust-engineer; do curl -o ~/.claude/agents/${agent}.md
${BASE_URL}/${CATEGORY}/${agent}.md done
undefined

Working with Subagents

子Agent使用指南

Activating a Subagent

激活子Agent

Once installed, reference agents in your prompts:
@python-pro help me optimize this data processing pipeline
@terraform-engineer review this AWS infrastructure code
@code-reviewer analyze this pull request for potential issues
安装完成后,在提示词中引用Agent:
@python-pro help me optimize this data processing pipeline
@terraform-engineer review this AWS infrastructure code
@code-reviewer analyze this pull request for potential issues

Combining Multiple Subagents

组合多个子Agent

@frontend-developer create a React component for the dashboard
@typescript-pro ensure type safety
@accessibility-tester verify WCAG compliance
@frontend-developer create a React component for the dashboard
@typescript-pro ensure type safety
@accessibility-tester verify WCAG compliance

Creating Custom Subagents

创建自定义子Agent

Use existing agents as templates:
bash
undefined
以现有Agent为模板:
bash
undefined

Copy an existing agent

复制现有Agent

cp ~/.claude/agents/python-pro.md ~/.claude/agents/my-custom-agent.md
cp ~/.claude/agents/python-pro.md ~/.claude/agents/my-custom-agent.md

Edit the frontmatter and instructions

编辑前置元数据和指令

vim ~/.claude/agents/my-custom-agent.md

Basic agent structure:

```markdown
---
name: my-custom-agent
description: Custom agent for specific task
---
vim ~/.claude/agents/my-custom-agent.md

基础Agent结构:

```markdown
---
name: my-custom-agent
description: Custom agent for specific task
---

My Custom Agent

My Custom Agent

You are an expert in [domain]. Your role is to [purpose].
You are an expert in [domain]. Your role is to [purpose].

Key Responsibilities

Key Responsibilities

  • Responsibility 1
  • Responsibility 2
  • Responsibility 1
  • Responsibility 2

Expertise

Expertise

  • Area 1
  • Area 2
  • Area 1
  • Area 2

Best Practices

Best Practices

  • Practice 1
  • Practice 2
undefined
  • Practice 1
  • Practice 2
undefined

Configuration

配置

Agent Directory Structure

Agent目录结构

~/.claude/                    # Global agents
  agents/
    python-pro.md
    terraform-engineer.md
    code-reviewer.md

project-root/                 # Project-specific agents
  .claude/
    agents/
      nextjs-developer.md
      sql-pro.md
~/.claude/                    # 全局Agent
  agents/
    python-pro.md
    terraform-engineer.md
    code-reviewer.md

project-root/                 # 项目专属Agent
  .claude/
    agents/
      nextjs-developer.md
      sql-pro.md

Environment Variables

环境变量

Agents may reference environment variables for credentials:
bash
undefined
Agent可能会引用环境变量获取凭证:
bash
undefined

.env or shell profile

.env或shell配置文件

export OPENAI_API_KEY="your-key-here" export ANTHROPIC_API_KEY="your-key-here" export GITHUB_TOKEN="your-token-here"
undefined
export OPENAI_API_KEY="your-key-here" export ANTHROPIC_API_KEY="your-key-here" export GITHUB_TOKEN="your-token-here"
undefined

Troubleshooting

故障排查

Agent Not Found

Agent未找到

Issue: Claude doesn't recognize the agent reference
bash
undefined
问题:Claude无法识别Agent引用
bash
undefined

Verify agent exists

验证Agent是否存在

ls ~/.claude/agents/ ls .claude/agents/
ls ~/.claude/agents/ ls .claude/agents/

Check agent filename matches reference

检查Agent文件名是否与引用匹配

Reference: @python-pro

引用:@python-pro

File should be: python-pro.md (not python_pro.md or pythonpro.md)

文件应为:python-pro.md(而非python_pro.md或pythonpro.md)

undefined
undefined

Agent Not Working as Expected

Agent工作异常

Issue: Agent behavior doesn't match description
  1. Check file integrity:
bash
undefined
问题:Agent行为与描述不符
  1. 检查文件完整性
bash
undefined

Ensure file downloaded completely

确保文件完整下载

wc -l ~/.claude/agents/python-pro.md
wc -l ~/.claude/agents/python-pro.md

Re-download if needed

必要时重新下载

First few lines should be YAML

前几行应为YAML格式

head -10 ~/.claude/agents/python-pro.md

3. **Check for conflicts**:
```bash
head -10 ~/.claude/agents/python-pro.md

3. **检查冲突**:
```bash

Multiple agents with same name can conflict

同名Agent可能产生冲突

find ~/.claude .claude -name "python-pro.md"
undefined
find ~/.claude .claude -name "python-pro.md"
undefined

Installation Script Errors

安装脚本错误

Issue:
install-agents.sh
fails
bash
undefined
问题
install-agents.sh
执行失败
bash
undefined

Make script executable

确保脚本可执行

chmod +x install-agents.sh
chmod +x install-agents.sh

Check dependencies

检查依赖

which curl # Required for downloading agents
which curl # 下载Agent需要该工具

Run with verbose output

开启详细输出运行

bash -x ./install-agents.sh
undefined
bash -x ./install-agents.sh
undefined

Rate Limiting

速率限制

Issue: GitHub API rate limiting when downloading many agents
bash
undefined
问题:下载大量Agent时触发GitHub API速率限制
bash
undefined

Use authenticated requests (higher rate limit)

使用认证请求(更高速率限制)

export GITHUB_TOKEN="your-personal-access-token"
export GITHUB_TOKEN="your-personal-access-token"

Or download repository once and install locally

或先下载仓库再本地安装

git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git cd awesome-claude-code-subagents ./install-agents.sh
undefined
git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git cd awesome-claude-code-subagents ./install-agents.sh
undefined

Advanced Usage

高级用法

Dynamic Agent Loading

动态加载Agent

Load agents programmatically based on project detection:
bash
#!/bin/bash
根据项目类型自动加载Agent:
bash
#!/bin/bash

auto-install-agents.sh

auto-install-agents.sh

Detect project type and install relevant agents

检测项目类型并安装对应Agent

if [ -f "package.json" ]; then

Node.js project

Check for Next.js

if [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; then

Python project

if [ -f "Cargo.toml" ]; then

Rust project

undefined
if [ -f "package.json" ]; then

Node.js项目

检查是否为Next.js项目

if [ -f "requirements.txt" ] || [ -f "pyproject.toml" ]; then

Python项目

if [ -f "Cargo.toml" ]; then

Rust项目

undefined

Agent Updates

Agent更新

Keep agents updated with latest improvements:
bash
#!/bin/bash
保持Agent为最新版本:
bash
#!/bin/bash

update-agents.sh

update-agents.sh

for agent in "$AGENTS_DIR"/*.md; do agent_name=$(basename "$agent")

Find agent in repository structure

This is simplified - actual implementation would need category lookup

curl -o "$agent" "${BASE_URL}/categories/*/${agent_name}" 2>/dev/null ||
echo "Could not update $agent_name" done
undefined
for agent in "$AGENTS_DIR"/*.md; do agent_name=$(basename "$agent")

在仓库结构中查找Agent

此处为简化版,实际实现需查找对应类别

curl -o "$agent" "${BASE_URL}/categories/*/${agent_name}" 2>/dev/null ||
echo "Could not update $agent_name" done
undefined

Multi-Agent Workflows

多Agent工作流

Create workflow templates combining multiple agents:
bash
undefined
创建组合多个Agent的工作流模板:
bash
undefined

.claude/workflows/code-review.md

.claude/workflows/code-review.md


name: comprehensive-code-review agents: [code-reviewer, security-engineer, accessibility-tester]


name: comprehensive-code-review agents: [code-reviewer, security-engineer, accessibility-tester]

Comprehensive Code Review Workflow

全面代码评审工作流

  1. @code-reviewer: Analyze code quality and patterns
  2. @security-engineer: Check for security vulnerabilities
  3. @accessibility-tester: Verify accessibility compliance
  4. Generate consolidated report
undefined
  1. @code-reviewer: Analyze code quality and patterns
  2. @security-engineer: Check for security vulnerabilities
  3. @accessibility-tester: Verify accessibility compliance
  4. Generate consolidated report
undefined

Common Patterns by Use Case

按场景分类的常见模式

Backend API Development

后端API开发

bash
curl -o .claude/agents/api-designer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/api-designer.md
curl -o .claude/agents/fastapi-developer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/fastapi-developer.md
curl -o .claude/agents/sql-pro.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/sql-pro.md
bash
curl -o .claude/agents/api-designer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/api-designer.md
curl -o .claude/agents/fastapi-developer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/fastapi-developer.md
curl -o .claude/agents/sql-pro.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/sql-pro.md

Cloud Infrastructure

云基础设施

bash
curl -o .claude/agents/terraform-engineer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/terraform-engineer.md
curl -o .claude/agents/kubernetes-specialist.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/kubernetes-specialist.md
curl -o .claude/agents/cloud-architect.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/cloud-architect.md
bash
curl -o .claude/agents/terraform-engineer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/terraform-engineer.md
curl -o .claude/agents/kubernetes-specialist.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/kubernetes-specialist.md
curl -o .claude/agents/cloud-architect.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/03-infrastructure/cloud-architect.md

Mobile Development

移动开发

bash
curl -o .claude/agents/mobile-developer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/mobile-developer.md
curl -o .claude/agents/flutter-expert.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/flutter-expert.md
curl -o .claude/agents/swift-expert.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/swift-expert.md
bash
curl -o .claude/agents/mobile-developer.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/01-core-development/mobile-developer.md
curl -o .claude/agents/flutter-expert.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/flutter-expert.md
curl -o .claude/agents/swift-expert.md https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/02-language-specialists/swift-expert.md