create-subagent

# 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 Delegate when the track is sizeable and independent, or when its output is verbose and the main context does not need it; launch independent subagents in one message. A handful of tool calls is cheaper inline. Brief each subagent precisely once and commit to the delegation. ### 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...