AgentStack
Sign in Publish
MCP servers Skills Toolkits Why AgentStack Sell Docs
Sign in
SKILL verified MIT Self-run

Cursor Runs

skill-hktitan-cursor-sdk-cursor-runs · by HKTITAN

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

↗ Website ↗ Repository
— No reviews yet
0 installs
0 views
— view→install

Install

$ agentstack add skill-hktitan-cursor-sdk-cursor-runs

✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.

Security review

✓ Passed

No issues found. Passed automated security review. · v0.1.0 How review works →

  • ✓ Prompt-injection patterns
  • ✓ Secret / credential exfiltration
  • ✓ Dangerous shell & filesystem operations
  • ✓ Untrusted network calls
  • ✓ Known-malicious package signatures

What it can access

  • ✓ Network access No
  • ✓ Filesystem access No
  • ✓ Shell / process execution No
  • ✓ Environment & secrets No
  • ✓ Dynamic code execution No

From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.

Are you the author of Cursor Runs? Claim this listing to set pricing, connect Stripe payouts, and keep 70% of every sale.
Sign up to claim

About

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]]

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

Install and usage instructions live in the source repository linked above.

Reviews

No reviews yet — be the first.

Write a review

Versions

  • v0.1.0 Imported from the upstream source.

More in Agent Skills