---
name: Ralph Specum Cancel
slug: ralph-specum-cancel
category: Automation
description: Ralph Specum Cancel stops a spec execution and can remove spec state or files when explicitly requested. Use it to resolve the target spec, clear execution state, and confirm before deleting directories.
github: "https://github.com/tzachbon/smart-ralph/tree/main/plugins/ralph-specum-codex/skills/ralph-specum-cancel"
language: Shell
stars: 527
forks: 47
install: "npx degit https://github.com/tzachbon/smart-ralph/tree/main/plugins/ralph-specum-codex/skills/ralph-specum-cancel ~/.claude/skills/ralph-specum-cancel"
installs_to: ~/.claude/skills/ralph-specum-cancel
source_path: plugins/ralph-specum-codex/skills/ralph-specum-cancel/SKILL.md
collection_size: 19
category_size: 1523
collection_url: "https://dirskills.com/collections/tzachbon/smart-ralph"
added: 2026-08-26T05:12:04.415Z
last_synced: 2026-08-26T05:12:04.415Z
canonical_url: "https://dirskills.com/skills/ralph-specum-cancel"
---

# Ralph Specum Cancel

Ralph Specum Cancel stops a spec execution and can remove spec state or files when explicitly requested. Use it to resolve the target spec, clear execution state, and confirm before deleting directories.

**Install:**

```bash
npx degit https://github.com/tzachbon/smart-ralph/tree/main/plugins/ralph-specum-codex/skills/ralph-specum-cancel ~/.claude/skills/ralph-specum-cancel
```

## README

# Ralph Specum Cancel

Use this to stop execution and optionally remove a spec.

## Contract

- Resolve the target by explicit path, exact name, or `.current-spec`
- Always clear execution state when the user wants to stop execution
- Confirm before deleting a spec directory
- Do not guess on ambiguous names

## Action

1. Resolve the target spec. If none exists, report that there is nothing to cancel.
2. Read `.ralph-state.json` when present and summarize the current phase and progress.
3. Safe cancel is the default. Delete `.ralph-state.json` only and keep the spec files unless the user asked for full removal.
4. If the user wants full removal, confirm first, then delete the spec directory and clear `.current-spec` when it points to that spec.
5. If the removed spec belongs to the active epic, keep epic files intact unless the user explicitly asked to remove epic planning too.
6. Report exactly what was removed.