Evidence snapshot reviewed Sep 5, 2026GitHub checked Aug 21, 2026
Source-reviewedStandalone SkillAutomation & AgentsCodex Profile

cancel

Stop a stuck or orphaned Ouroboros execution by ID, from an interactive list, or all at once.

At a glance

What it does

Stop a stuck or orphaned Ouroboros execution by ID, from an interactive list, or all at once.

Capabilities
Automation & AgentsAgentsSession ManagementWorkflow Automation

Before you choose it

This Ouroboros skill runs the cancellation CLI against active executions. With no argument, it lists running and paused executions for selection; with an execution ID, it cancels that execution; and with --all, it cancels every running or paused execution. It can also pass a custom cancellation reason.

Best for

Ouroboros users who need to stop a running or paused execution.

Common tasks

  • Cancel a known stuck execution by its execution or session ID.
  • Review active executions and choose one to cancel interactively.
  • Stop all running or paused executions when resetting work.

Permissions and data

Writes cancellation events directly to the configured Ouroboros event store through the CLI.

Permissions
  • Run the ouroboros cancel execution CLI command.
  • Access the configured Ouroboros runtime EventStore.
Data handling
  • Reads active execution state to list eligible running or paused sessions.
  • Writes cancellation events for selected executions.

Limitations

  • Only executions in running or paused status can be cancelled; completed, failed, and already-cancelled sessions are skipped with a warning.
  • It requires an existing configured runtime EventStore; if none exists, an Ouroboros execution must be run first.
  • The supplied evidence does not establish that the skill has been installed or executed in this environment.

What DSHub checked

  • The pinned skill document defines interactive, specific-ID, and --all cancellation modes.
  • The pinned source commit and captured skill document passed the supplied hard checks.
  • The repository license is identified as MIT.

What DSHub did not check

  • Runtime behavior, CLI availability, and EventStore configuration were not verified by this record.

Pinned install

Primary action

This standalone skill does not have a DSH Plugin install action. Use its source documentation for the delivery method.

Visit the source project

Maintainer source

Skill instructions

View at commit 03714ba
Maintainer-authored contentCaptured from skills/cancel/SKILL.md on Sep 5, 2026. The text and repository-relative media are fixed to commit 03714ba44618 with content hash 3e9eede8dda5; provider-hosted badges may update independently. SKILL.md commands are upstream documentation; use the type-correct primary action above and verify it against this pinned source.

name: cancel description: "Cancel stuck or orphaned executions" aliases: [kill, abort]

/ouroboros:cancel

Cancel stuck or orphaned executions by session ID, cancel all running sessions, or interactively pick from active executions.

Usage

/ouroboros:cancel                          # Interactive: list active, pick one
/ouroboros:cancel <execution_id>           # Cancel specific execution
/ouroboros:cancel --all                    # Cancel all running executions

Trigger keywords: "cancel execution", "kill session", "stop running", "abort execution"

How It Works

This skill interacts directly with the event store (not via MCP tool) to emit cancellation events. It uses the CLI command under the hood.

Three modes:

  1. Bare (no args): Lists all active (running/paused) executions in a numbered table and prompts you to pick one to cancel
  2. Explicit (execution_id): Cancels the specified execution immediately
  3. --all flag: Cancels every running or paused execution at once

Instructions

When the user invokes this skill:

  1. Determine which mode to use:

    • If the user provided an execution/session ID: Explicit mode
    • If the user says "cancel all" or "cancel everything": --all mode
    • If no ID given and not "all": Bare mode (interactive listing)
  2. Run the appropriate CLI command using Bash:

    Bare mode (interactive):

    ouroboros cancel execution
    

    This will list active executions and prompt for selection.

    Explicit mode (specific execution):

    ouroboros cancel execution <execution_id>
    

    Cancel all mode:

    ouroboros cancel execution --all
    

    With custom reason:

    ouroboros cancel execution <execution_id> --reason "Stuck for 2 hours"
    
  3. Present results to the user:

    • Show which executions were cancelled
    • If bare mode, show the list and selection prompt
    • If no active executions, inform the user
  4. End with a next-step suggestion:

    • After cancellation: ◆ Cancelled — use ooo status to verify, or ooo run to start fresh
    • No active sessions: ◆ No active executions — use ooo run to start a new one

State Transitions

Only sessions in running or paused status can be cancelled. Sessions that are already completed, failed, or cancelled are skipped with a warning.

Fallback (No Database)

If the configured runtime EventStore does not exist:

No Ouroboros database found at the configured runtime path.
Run an execution first with: /ouroboros:ouroboros-run

Example

User: cancel that stuck execution

> ouroboros cancel execution

Active Executions
┌───┬──────────────────┬──────────────┬─────────┬─────────┬──────────────┐
│ # │ Session ID       │ Execution ID │ Seed ID │ Status  │ Started      │
├───┼──────────────────┼──────────────┼─────────┼─────────┼──────────────┤
│ 1 │ sess-abc-123     │ exec-001     │ seed-42 │ running │ 2024-01-15   │
│ 2 │ sess-def-456     │ exec-002     │ seed-99 │ paused  │ 2024-01-14   │
└───┴──────────────────┴──────────────┴─────────┴─────────┴──────────────┘

Enter number to cancel (1-2), or 'q' to quit: 1
Cancel session sess-abc-123 (running)? [y/N]: y
✓ Cancelled execution: sess-abc-123

◆ Cancelled — use `ooo status` to verify, or `ooo run` to start fresh

RFC #1392 State Breadcrumb Footer

Your final response MUST end with exactly one breadcrumb footer line:

◆ <current state> → next: <recommended action>

Derive <current state> from live session state via ouroboros_session_status when that MCP projection is available; otherwise derive it from this skill's actual outcome. Never use a linear Step N of M footer because Ouroboros is an evolutionary loop. When the next action is genuinely a choice, list 2-3 honest options in the next: clause. The breadcrumb line must be the last line of the response.

Operate deliberately

Install and manage

Prerequisites and target Profile

Target Codex Profile

Delivery Skill Files — https://raw.githubusercontent.com/Q00/ouroboros/03714ba446186423dcb46e25d12bd19c3a2e82f6/skills/cancel/SKILL.md

Compatibility and access

Ouroboros CLI and configured runtime EventStore required Not declared in supplied evidence

Review compatibility evidence

Risk facts

State Change

Cancellation emits events directly to the event store and can cancel all active executions.

Evidence
Evidence and editorial reviewManifest, Bundle patch, distribution and freshness

Immutable evidence

Review status and source activity

Human approved

Approved for publication after reviewing the source-linked content and immutable release record. AI assisted with the draft; the publication decision was human.

Human reviewed Sep 5, 2026, 5:17 PM UTCGitHub facts last checked Sep 5, 2026, 4:31 PM UTC

No material source change has been recorded since this evidence baseline.

Next step

Compare ecosystem artifact types

Subscribe to material changes for cancel