coco-research/coco/create-subagent
- community
Checking that the SKILL.md file is still in the repository.
Create custom subagents for specialized AI tasks. Use when the user wants to create a new type of subagent, set up task-specific agents, configure code reviewers, debuggers, or domain-specific assistants with custom prompts.
Install
npx vskill@latest install coco-research/coco/create-subagentSKILL.md
Creating Custom Subagents
This skill guides you through creating custom subagents for Cursor. Subagents are specialized AI assistants that run in isolated contexts with custom system prompts.
When to Use Subagents
Subagents help you:
- Preserve context by isolating exploration from your main conversation
- Specialize behavior with focused system prompts for specific domains
- Reuse configurations across projects with user-level subagents
Inferring from Context
If you have previous conversation context, infer the subagent's purpose and behavior from what was discussed. Create the subagent based on specialized tasks or workflows that emerged in the conversation.
Subagent Locations
| Location | Scope | Priority | |
|---|---|---|---|
.cursor/agents/ | Current project | Higher | |
~/.cursor/agents/ | All your projects | Lower |
When multiple subagents share the same name, the higher-priority location wins.
Project subagents (.cursor/agents/): Ideal for codebase-specific agents. Check into version control to share with your team.
User subagents (~/.cursor/agents/): Personal agents available across all your projects.
Subagent File Format
Create a .md file with YAML frontmatter and a markdown body (the system prompt):
Required Fields
| Field | Description | |
|---|---|---|
name | Unique identifier (lowercase letters and hyphens only) | |
description | When to delegate to this subagent (be specific!) |
Writing Effective Descriptions
The description is critical - the AI uses it to decide when to delegate.
Include "use proactively" to encourage automatic delegation.
Example Subagents
Code Reviewer
Debugger
Data Scientist
Subagent Creation Workflow
Step 1: Decide the Scope
- Project-level (
.cursor/agents/): For codebase-specific agents shared with team - User-level (
~/.cursor/agents/): For personal agents across all projects
Step 2: Create the File
Step 3: Define Configuration
Write the frontmatter with the required fields (name and description).
Step 4: Write the System Prompt
The body becomes the system prompt. Be specific about:
- What the agent should do when invoked
- The workflow or process to follow
- Output format and structure
- Any constraints or guidelines
Step 5: Test the Agent
Ask the AI to use your new agent:
Best Practices
- Design focused subagents: Each should excel at one specific task
- Write detailed descriptions: Include trigger terms so the AI knows when to delegate
- Check into version control: Share project subagents with your team
- Use proactive language: Include "use proactively" in descriptions
Troubleshooting
Subagent Not Found
- Ensure file is in
.cursor/agents/or~/.cursor/agents/ - Check file has
.mdextension - Verify YAML frontmatter syntax is valid
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingadapters/cursor/skills/create-subagent/SKILL.md
Popularity
- Repository stars
- 427
- Repository forks
- 12
- 7-day trend score
- 35
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/coco-research/coco/create-subagent)