Documentation

What are subagents?

Subagents are reusable capabilities for Claude Code. They extend Claude's abilities with specialized knowledge and workflows for specific tasks.

Think of them as plugins or extensions that teach Claude new skills — from code review patterns to API design, testing strategies to deployment workflows.

Getting started

Install any subagent with a single command:

npx @augmnt-sh/subagents add owner/repo/subagent-name

This downloads the subagent to .claude/agents/ in your project directory.

Once installed, Claude Code will automatically discover and use the subagent when relevant to your task. You can also explicitly reference it in your prompts.

Example usage

After installing a subagent like backend-architect, you can ask Claude to use it:

# Claude will automatically use the backend-architect subagent
# when you ask questions about API design

"Help me design a REST API for user authentication"

The subagent provides specialized context and patterns that help Claude give more accurate, project-aware responses.

Managing subagents

Common commands for working with subagents:

# Install a subagent
npx @augmnt-sh/subagents add owner/repo/name

# List installed subagents
npx @augmnt-sh/subagents list

# Remove a subagent
npx @augmnt-sh/subagents remove owner/repo/name

# Update all subagents
npx @augmnt-sh/subagents update

How rankings work

The leaderboard is sorted by install count. We use anonymous telemetry from CLI installations to track popularity.

No personal information is collected. We only track aggregate download counts to help surface the most useful subagents.

Creating your own subagents

Subagents are markdown files with YAML frontmatter. Here's the format:

---
name: "Your Agent Name"
description: "Brief description of what this agent does"
tools:
  - Read
  - Write
  - Bash
---

# Agent Instructions

Your detailed instructions here...

## Guidelines

- Specific patterns to follow
- Best practices
- Examples of usage

File format specification

The frontmatter supports these fields:

The markdown body contains the actual instructions that will be loaded into Claude Code's context when the subagent is active.

Publishing your subagent

Sharing your subagent is simple — no approval process required:

1. Create your subagent file following the format above
2. Host it on GitHub in one of these locations:
   • .claude/agents/ (recommended)
   • agents/
   • Repository root
3. Share the install command:

   npx @augmnt-sh/subagents add your-username/your-repo/agent-name

Your subagent will automatically appear on the leaderboard as people install it. Rankings are based on install counts.