Cursor runs

Skill HKTITAN/cursor-sdk/skills/cursor-runs

Agent skills for the Cursor TypeScript SDK, the agent CLI, and .cursor/ project config (rules, skills, hooks, mcp). Skill-graph format with [[wikilinks]].

Install

npx -y skills add HKTITAN/cursor-sdk --skill cursor-runs

Assembled 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

Run lifecycle, streaming, follow-ups, and conversation introspection in the Cursor SDK. Use when consuming agent output, handling progress events, or chaining turns.

SKILL.md

2.1 KB, as published. Nobody here has run it

cursor-runs

Everything you do after Agent.create flows through a Run. This skill covers how to issue work, stream events, await results, cancel, and inspect conversation history.

When to use

Consuming streamed SDKMessage events
Implementing follow-up turns on the same agent
Cancelling or reattaching to a long-running cloud run
Parsing tool calls, thinking blocks, or assistant text

Sending work

[[references/send]] — agent.send(message, options) and SendOptions
[[references/send-options]] — per-run model override, MCP override, callbacks, force
[[references/follow-ups]] — multi-turn conversations on one agent

Run object

[[references/run-interface]] — id, status, result, git, model, durationMs
[[references/wait]] — await run.wait() and RunResult
[[references/cancel]] — run.cancel() and cancellation semantics
[[references/status-events]] — onDidChangeStatus listener
[[references/operation-support]] — run.supports(op) and unsupportedReason

Streaming

[[references/stream]] — for await over run.stream()
[[references/sdk-message-types]] — full union: system, user, assistant, thinking, tool_use, status, task, request
[[references/interaction-updates]] — onDelta updates: text, thinking, tool calls, tokens, steps, summaries, shell
[[references/on-step]] — onStep step-level callback

Conversation

[[references/conversation]] — run.conversation() returns ConversationTurn[]
[[references/conversation-shapes]] — agentConversationTurn vs shellConversationTurn, step types

Where to go next

Lifecycle and creation → [[../cursor-sdk/SKILL]]
Cloud-specific run features (PRs, artifacts) → [[../cursor-cloud/SKILL]]
Error classification → [[../cursor-errors/SKILL]]