How do I install the Cursor Runs skill?

Run npx skillmds@latest add hktitan/cursor-runs in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cursor Runs safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cursor Runs?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cursor Runs free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cursor Runs?

HKTITAN (@hktitan) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cursor Runs by hktitan — Agent Skill

Name: Cursor Runs
Author: HKTITAN

File contents

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

---name: cursor-runsdescription: Run lifecycle, streaming, follow-ups, and conversation introspection in the Cursor SDK. Use when consuming agent output, handling progress events, or chaining turns.---# cursor-runsEverything 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]]

Frequently asked questions

Cursor Runs