Cursor plugin with a single skill that helps users build on top of the Cursor TypeScript SDK (@cursor/sdk). The skill covers the three invocation patterns (Agent.prompt, Agent.create + agent.send, Agent.resume), the top traps for new integrations, runtime choice (local vs cloud), auth, streaming, MCP, error handling, and ready-to-extend patterns for CI, scheduled jobs, chat, and webhooks.
The skill is short by design — it points at focused reference files only when the user's task clearly falls into one of them.
cursor-sdk: design and integration guidance for building with@cursor/sdk, plus reference files for runtime choice, auth, error handling, streaming, MCP, advanced features, and integration patterns.
Use whenever the user is integrating, installing, or writing code against the Cursor SDK; mentions Agent.create, Agent.prompt, Agent.resume, agent.send, run.stream, CursorAgentError, or @cursor/sdk; wants to run Cursor agents from a script, CI/CD pipeline, GitHub Action, backend service, bot, or webhook; is choosing between local and cloud runtime; is configuring MCP servers for an SDK agent; or is porting REST /v1/agents calls to the SDK.
The skill is the source of truth for the external @cursor/sdk package and is meant to be loaded eagerly rather than answered from memory.
The skill keeps the main SKILL.md short and reads a reference file only when the user's task clearly falls inside it:
| If the user is... | Reference |
|---|---|
| Picking between local and cloud runtime | references/runtime-choice.md |
| Debugging auth (401s, missing key, team vs user keys) | references/auth.md |
Handling errors, retries, rate limits, CursorAgentError, result.status === error |
references/error-handling.md |
| Consuming streams, picking event types, cancelling, or stream vs wait | references/streaming.md |
| Configuring MCP servers (HTTP, stdio, transport, auth injection) | references/mcp.md |
Sub-agents, resume, artifacts, listing/inspecting agents, Agent.messages |
references/advanced.md |
| Building a specific integration (CI review bot, triage, chat, webhook) | references/patterns.md |
MIT