Skill profile
cursor-sdk
Integration guidance for building on the Cursor TypeScript SDK (@cursor/sdk) — invocation patterns, runtime choice, auth, streaming, MCP, and error handling.
What it actually does
- Covers the three `@cursor/sdk` invocation patterns (`Agent.prompt`, `Agent.create` + `agent.send`, `Agent.resume`), runtime choice (local vs. cloud), auth, streaming, MCP configuration, and error handling.
- Keeps its main SKILL.md short and reads a reference file only when the task clearly falls into one — runtime choice, auth, error handling, streaming, MCP, advanced features, or integration patterns.
When to use it — and when not to
Use it when
- Integrating, installing, or writing code against the Cursor SDK — CI review bots, triage automation, chat integrations, or webhooks that run Cursor agents.
Not for
- You're not building against `@cursor/sdk` — it's a reference skill for that specific package.
Agent compatibility
- Cursor
Confirmed means the skill’s own source or vendor states it works with that agent. Portable means it only reaches that agent through the shared SKILL.md format and a directory convention — real, but a weaker claim. An agent with no entry here isn’t known to be unsupported; it simply isn’t documented either way, so nothing is claimed. Full model on Agent Skills Compatibility.
Requirements and operational surface
Depends on
- The `@cursor/sdk` package, for the integration code being built
Related skills
- orchestrateorchestrate is built directly on this SDK — this skill is the source of truth for its auth model.
Evidence and provenance
Maintained by Cursor (official). Primary source: cursor/plugins — cursor-sdk, last checked against this page’s claims on . This page summarizes and analyzes that source — it isn’t a copy of its SKILL.md or README, and installation happens at the source, not here.