voltagent-research

Awesome Subagents

A curated collection of AI coding agent definitions for Claude Code, OpenCode, and Cursor.

Forked from VoltAgent/awesome-claude-code-subagents and extended to support multiple AI coding tools.

---

Overview

This repository contains 131+ specialised AI agent definitions organised into 10 categories. The definitions in categories/ use the Claude Code format as the canonical source. The generate.sh script produces equivalent definitions for OpenCode and Cursor.

Cursor also reads .claude/agents/ and ~/.claude/agents/ natively for compatibility, but the generated Cursor definitions in agent-specific/cursor/ add readonly: true support for agents that have no write, edit, or bash tools.

Agent Storage Locations

Tool	Global	Project
Claude Code	~/.claude/agents/	.claude/agents/
OpenCode	~/.config/opencode/agents/	.opencode/agents/
Cursor	~/.cursor/agents/	.cursor/agents/

---

Installation

Claude Code

Claude Code reads the definitions in categories/ directly. No generation step is needed.

Option 1 - Symlink via setup.sh (recommended):

git clone https://github.com/ampedweb/awesome-subagents.git
cd awesome-subagents
./setup.sh global                        # global access across all projects
./setup.sh project /path/to/your-project # project-level only

The script creates a single symlink named awesome-subagents/ inside each tool's agents directory, so agents appear as awesome-subagents/01-core-development/backend-developer, etc.

Option 2 - Copy manually:

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

OpenCode

OpenCode requires generated definitions. Run generate.sh first, then setup.sh.

git clone https://github.com/ampedweb/awesome-subagents.git
cd awesome-subagents
./generate.sh                            # generates agent-specific/opencode/ and agent-specific/cursor/
./setup.sh global                        # symlinks OpenCode into ~/.config/opencode/agents/
./setup.sh project /path/to/your-project # symlinks OpenCode into the project

Cursor

Cursor requires generated definitions for full readonly support. Run generate.sh first, then setup.sh.

git clone https://github.com/ampedweb/awesome-subagents.git
cd awesome-subagents
./generate.sh                            # generates agent-specific/cursor/ (with readonly: true where applicable)
./setup.sh global                        # symlinks Cursor into ~/.cursor/agents/
./setup.sh project /path/to/your-project # symlinks Cursor into the project

Cursor also reads .claude/agents/ natively, so installing for Claude Code covers basic Cursor support. The generated Cursor definitions additionally apply readonly: true to agents that have no write, edit, or bash tools, and map the model field to Cursor-native model IDs (sonnet -> claude-4.6-sonnet, opus -> claude-4.6-opus, haiku -> claude-4.5-haiku).

Scripts Reference

generate.sh - Translates Claude Code definitions into OpenCode and Cursor formats.

Command	Description
./generate.sh	Generate all definitions (default)
./generate.sh clean	Remove all generated files
./generate.sh list	List source agents with details
./generate.sh help	Show help

setup.sh - Creates or removes symlinks between agent directories and tool config. All commands present an interactive checkbox selector to choose which tools (Claude Code, OpenCode, Cursor) to link or unlink.

Command	Description
./setup.sh global	Symlink into global config
./setup.sh project <path>	Symlink into a project's local config
./setup.sh unlink global	Remove global symlinks
./setup.sh unlink project <path>	Remove project symlinks

---

Categories

01. Core Development

Plugin: voltagent-core-dev

Essential development subagents for everyday coding tasks.