Cursor subagents
Agent skills for the Cursor TypeScript SDK, the agent CLI, and .cursor/ project config (rules, skills, hooks, mcp). Skill-graph format with [[wikilinks]].
npx -y skills add HKTITAN/cursor-sdk --skill cursor-subagentsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
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.md
1.3 KB, as published. Nobody here has run it
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]] —
SDKTaskMessagein the run stream
Cross-links
- MCP server names → [[../cursor-mcp/references/inline-config]]
- Models → [[../cursor-models/SKILL]]