# 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.

- Skill: `hktitan/cursor-subagents` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add hktitan/cursor-subagents`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hktitan/cursor-subagents/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: HKTITAN (https://skillmd.com/u/hktitan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hktitan/cursor-subagents

---


# 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]]