cursor-subagents
Define delegated subagents on a Cursor SDK agent via the `agents` field — `AgentDefinition`, MCP scoping, and model inheritance. Use when decomposing work across specialist personas.
Source facts
- Repository
- HKTITAN/cursor-sdk
- Last source activity
- May 3, 2026 at 08:23
- Detected SKILL.md language
- English
- Stars
- 2
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
7 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- cursor-subagents
- description
- Define delegated subagents on a Cursor SDK agent via the `agents` field — `AgentDefinition`, MCP scoping, and model inheritance. Use when decomposing work across specialist personas.
- metadata
- {"internal":false,"source":"https://cursor.com/docs/sdk/typescript"}
# cursor-subagents
The Cursor SDK has first-class subagents: declare them on `AgentOptions.agents` and the parent agent decides when to spawn them. This is **not** a manual orchestration layer — the parent's planner picks subagents based on their `description`.
## When to use
- Splitting a workload into specialist personas (planner, coder, reviewer)
- Scoping a subagent to a subset of MCP servers
- Running subagents on a different model from the parent
## Configuration
- [[references/agents-field]] — `AgentOptions.agents: Record<string, AgentDefinition>`
- [[references/agent-definition]] — `description`, `prompt`, `model`, `mcpServers`
- [[references/mcp-scoping]] — restricting tool access per subagent
- [[references/model-inheritance]] — `"inherit"` vs explicit override
- [[references/persistence]] — re-pass on `Agent.resume`
## Observation
- [[references/task-events]] — `SDKTaskMessage` in the run stream
## Cross-links
- MCP server names → [[../cursor-mcp/references/inline-config]]
- Models → [[../cursor-models/SKILL]]
View on GitHub