agentsclimarketplace
Sign in

Cursor runs

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

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

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.

SKILL.md

2.1 KB, 431 tokens by cl100k_base, 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]]

What ships with it: 14 files

9.2 KB alongside SKILL.md

references/

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.