Skill profile · Inspected
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/sdkinvocation 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/sdkpackage, 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.
More from cursor/plugins
Other skills from the same source.
- orchestrateFans a large task out across parallel Cursor cloud agents via the Cursor SDK — planners publish tasks, workers hand off, a script reconciles the tree from disk and git.
- cli-for-agentDesign and review guidance for building CLIs meant to be driven by coding agents — non-interactive flags, layered --help, stdin/pipelines, fast errors, idempotency, --dry-run.
- continual-learningAutomatically and incrementally keeps AGENTS.md up to date, mining new session transcripts on a cadence and updating matching bullets in place rather than rewriting the file.
- agent-compatibilityScores how well a repo holds up under agent workflows — startup, validation, and docs reliability — by pairing a published CLI scan with three focused review agents.
- create-pluginMeta-workflow for scaffolding a marketplace-ready Cursor plugin — manifest, skills, rules, agents, and commands together — plus a pre-submission quality check.
Evidence and provenance
Maintained by Cursor (official). Primary source: cursor/plugins, 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.
Topic: Development.