stop-run

Files (2)

• SKILL.md
• skill.manifest.json

SKILL.md (first lines)

# Cancel Skill

Intelligent cancellation that detects and cancels the active superskills mode.

**The cancel skill is the standard way to complete and exit any superskills mode.**
When the stop hook detects work is complete, it instructs the LLM to invoke
this skill for proper state cleanup. If cancel fails or is interrupted,
retry with `--force` flag, or wait for the 2-hour staleness timeout as
a last resort.

## What It Does

Automatically detects which mode is active and cancels it:
- **Autopilot**: Stops workflow, preserves progress for resume
- **Ralph**: Stops persistence loop, clears linked ultrawork if applicable
- **Ultrawork**: Stops parallel execution (standalone or linked)
- **Ecomode**: Stops token-efficient parallel execution (standalone or linked to ralph)
- **UltraQA**: Stops QA cycling workflow
- **Swarm**: Stops coordinated agent swarm, releases claimed tasks
- **Ultrapilot**: Stops parallel autopilot workers
- **Pipeline**: Stops sequential agent pipeline
- **Team**: Sends shutdown_request to all teammates, waits for responses, calls TeamDelete, clears linked ralph if present
- **Team+Ralph (linked)**: Cancels team first (graceful shutdown), then clears ralph state. Cancelling ralph when linked also cancels team first.

## Usage

```
/superskills:cancel
```

Or say: "cancelomc", "stopomc"

## Auto-Detection

`/superskills:cancel` follows the session-aware state contract:
- By default the command inspects the current session via `state_list_active` and `state_get_status`, navigating `.superskills/state/sessions/{sessionId}/…` to discover which mode is active.
- When a session id is provided or already known, that session-scoped path is authoritative. Legacy files in `.superskills/state/*.json` are consulted only as a compatibility fallback if the session id is missing or empty.
- Swarm is a shared SQLite/marker mode (`.superskills/state/swarm.db` / `.superskills/state/swarm-active.marker`) and is not session-scoped.
- The default cleanup flow calls `state_clear` with the session id to remove only the matching session files; modes stay bound to their originating session.

Active modes are still cancelled in dependency order:
1. Autopilot (includes linked ralph/ultraqa/ecomode cleanup)
2. Ralph (cleans its linked ultrawork or ecomode)
3. Ultrawork (standalone)
4. Ecomode (standalone)
5. UltraQA (standalone)
6. Swarm (standalone)
7. Ultrapilot (standalone)
8. Pipeline (standalone)
9. Team (Codex team runtime)
10. Plan Consensus (standalone)

## Force Clear All

Use `--force` or `--all` when you need to erase every session plus legacy artifacts, e.g., to reset the workspace entirely.

```
/superskills:cancel --force
```

```
/superskills:cancel --all
```

Steps under the hood:
1. `state_list_active` enumerates `.superskills/state/sessions/{sessionId}/…` to find every known session.
2. `state_clear` runs once per session to drop that session’s files.
3. A global `state_clear` without `session_id` removes legacy files under `.superskills/state/*.json`, `.superskills/state/swarm*.db`, and compatibility artifacts (see list).
4. Team artifacts (`~/.superskills-codex/team/teams/*/`, `~/.superskills-codex/team/tasks/*/`, `.superskills/state/team-state.json`) are best-effort cleared as part of the legacy fallback.

Every `state_clear` command honors the `session_id` argument, so even force mode still uses the session-aware paths first before deleting legacy files.

Legacy compatibility list (removed only under `--force`/`--all`):
- `.superskills/state/autopilot-state.json`
- `.superskills/state/ralph-state.json`
- `.superskills/state/ralph-plan-state.json`
- `.superskills/state/ralph-verification.json`
- `.superskills/state/ultrawork-state.json`
- `.superskills/state/ecomode-state.json`
- `.superskills/state/ultraqa-state.json`
- `.superskills/state/swarm.db`
- `.superskills/state/swarm.db-wal`
- `.superskills/state/swarm.db-shm`
- `.superskills/state/swarm-active.marker`
- `.superskills/state/swarm-tasks.db`
- `.superskills/state/ultrapilot-state.json`
- `.superskills/state/ultrapilot-ownership.json`
- `.superskills/state/pipeline-state.json`
- `.superskills/state/plan-consensus.json`
- `.superskills/state/ralplan-state.json`
- `.superskills/state/boulder.json`
- `.superskills/state/hud-state.json`
- `.superskills/state/subagent-tracking.json`
- `.superskills/state/subagent-tracker.lock`
- `.superskills/state/rate-limit-daemon.pid`
- `.superskills/state/rate-limit-daemon.log`
- `.superskills/state/checkpoints/` (directory)
- `.superskills/state/sessions/` (empty directory cleanup after clearing sessions)

## Implementation Steps

When you invoke this skill:

### 1. Parse Arguments

```bash
# Check for --force or --all flags
FORCE_MODE=false
if [[ "$*" == *"--force"* ]] || [[ "$*" == *"--all"* ]]; then
  FORCE_MODE=true
fi
```

### 2. Detect Active Modes

The skill now relies on the session-aware state contract rather than hard-coded file paths:
1. Call `state_list_active` to enumerate `.superskills/state/sessions/{sessionId}/…` and discover every active session.
2. For each session id, call `state_get_status` to learn which mode is running (`autopilot`, `ralph`, `ultrawork`, etc.) and whether dependent modes exist.
3. If a `session_id` was supplied to `/superskills:cancel`, skip legacy fallback entirely and operate solely within that session path; otherwise, consult legacy files in `.superskills/state/*.json` only if the state tools report no active session. Swarm remains a shared SQLite/marker mode outside session scoping.

From shaun0927/codex-superskills, MIT.

More from shaun0927/codex-superskills