Skip to main content
skill CX Codex

cancel-ralph — Claude Code skill: what it does, how to install

Aborts an active Ralph loop and cleans up its state files. Useful when an agent gets stuck or you need to halt the loop manually.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add cursor/plugins --skill cancel-ralph -a claude-code
Open on GitHub

What cancel-ralph does

The skill inspects .cursor/ralph/scratchpad.md to see if a loop is running. No scratchpad file? The agent replies that no active loop exists and stops immediately.

If the file is present, the skill extracts the step count from the iteration: line. Next, it executes rm -rf .cursor/ralph in the project root. This wipes the state directory and any completion flags in one pass. It finishes by reporting which iteration was interrupted.

Because the skill targets only .cursor/ralph, it will not detect loops configured to store state in any other directory.

What it helps with

  • abort a stuck or runaway Ralph loop
  • wipe the .cursor/ralph state directory
  • check which iteration was running before termination

Example prompts for the agent

  • Cancel the active Ralph loop
  • Stop ralph and clear the scratchpad
  • Abort running ralph loop

How to install cancel-ralph

1Skills CLI (Vercel)

npx skills add cursor/plugins --skill cancel-ralph -a claude-code

2Manually: put the files in place

~/.claude/skills/cancel-ralph/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cancel-ralph/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about cancel-ralph

How do I install cancel-ralph in Claude Code?

Run npx skills add cursor/plugins --skill cancel-ralph -a claude-code in your terminal.

What does cancel-ralph do?

It looks for .cursor/ralph/scratchpad.md, checks the current iteration count, and removes the .cursor/ralph directory via rm -rf.

What happens if there is no running Ralph loop?

The skill checks for .cursor/ralph/scratchpad.md and reports that no active loop was found without modifying any project files.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set45

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor