jmagly/ralph-abort
agentic/code/addons/agent-loop/skills/ralph-abort/SKILL.md
Abort a running agent loop and optionally revert changes
$ install --global
skillsauthnpx skillsauth add jmagly/aiwg ralph-abortInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 2, 2026, 6:50 AM180.1s1 file scanned
SKILL.md
- namespace:
- aiwg
- name:
- ralph-abort
- platforms:
- [all]
- description:
- Abort a running agent loop and optionally revert changes
- argumentHint:
- [--keep-changes] [--revert] [--force --interactive --guidance "text"]
- allowedTools:
- Read, Write, Bash
- model:
- sonnet
- category:
- automation
Al Abort
Abort a running or paused agent loop.
Usage
/ralph-abort # Abort, keep changes
/ralph-abort --revert # Abort and revert all changes
/ralph-abort --force # Abort even if no active loop
Parameters
--keep-changes (default)
Stop the loop but keep all file changes made during iterations.
--revert
Revert all changes made during the agent loop using git:
- Identify commits made during loop (prefix:
ralph: iteration) - Reset to commit before loop started
- Warning: This discards work
--force
Abort even if state indicates no active loop (for cleanup).
Your Actions
Standard Abort
- Read
.aiwg/ralph/current-loop.json - Verify there's an active loop
- Mark loop as aborted
- Generate partial completion report
- Confirm to user
Output:
Agent Loop: ABORTED
Task: {task}
Iterations completed: {N}
Duration: {time}
Changes have been kept. To revert:
git reset --hard HEAD~{N}
Partial report: .aiwg/ralph/completion-{timestamp}.md
With --revert
- Read loop state
- Find all
ralph: iterationcommits from this loop - Confirm with user before reverting
- Reset git to pre-loop state
- Clean up state files
Confirmation prompt:
This will revert {N} commits:
- ralph: iteration 1 - initial attempt
- ralph: iteration 2 - fixed auth
- ralph: iteration 3 - in progress
Files to be reverted:
- src/auth.ts
- test/auth.test.ts
Type 'yes' to confirm revert:
After revert:
Agent Loop: ABORTED + REVERTED
Reverted {N} commits.
Working directory restored to pre-loop state.
State cleaned: .aiwg/ralph/current-loop.json archived
Error Handling
No active loop:
No active agent loop to abort.
Use --force to clean up stale state files if needed.
Git not available:
Git not available for --revert option.
Loop aborted, but changes cannot be reverted automatically.
Manual cleanup may be needed.
Dirty working directory (for --revert):
Cannot revert: uncommitted changes exist.
Options:
1. Commit or stash changes first
2. Use /ralph-abort without --revert to keep current state
State Changes
After abort:
current-loop.jsonmarked withstatus: "aborted"active: false- Completion report generated with partial results
- Loop can no longer be resumed
Related
/ralph-status- Check loop status before aborting/ralph-resume- Continue instead of abort
References
- @$AIWG_ROOT/agentic/code/addons/ralph/README.md — Ralph addon overview and loop executor documentation
- @$AIWG_ROOT/agentic/code/addons/aiwg-utils/rules/human-authorization.md — Authorization rules for irreversible actions like revert
- @$AIWG_ROOT/docs/cli-reference.md — CLI reference for ralph-abort and related commands
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/README.md — SDLC framework context
Related Skills
jmagly/radar-status
data-ai
VerifiedTrustedCommunity
Report which research-corpus radar sidecars are overdue for refresh. Computes staleness (days since last refresh vs the cadence window) for every radar, sorted most-overdue-first. Runs via `aiwg corpus radar-status`.
140SKILL.mdUpdated May 28, 2026
jmagly/radar-report
data-ai
VerifiedTrustedCommunity
Aggregate research-corpus radar sidecars into a corpus or per-cluster freshness report — totals, overdue count, per-cluster / per-GRADE / per-trajectory breakdowns, an overdue table, and per-radar rationale snippets. Runs via `aiwg corpus radar-report`.
140SKILL.mdUpdated May 28, 2026
jmagly/radar-init
testing
VerifiedTrustedCommunity
Scaffold radar/freshness sidecars for research-corpus REFs. Pulls title/authors from the citation sidecar and GRADE from the analysis doc, defaults the refresh cadence from GRADE and the cluster from a corpus-local map, and stamps documentation/radar/REF-XXX-radar.md. Runs via `aiwg corpus radar-init`.
140SKILL.mdUpdated May 28, 2026
jmagly/profile-temporal
data-ai
VerifiedTrustedCommunity
Compute an entity's publication trajectory — per-year paper counts, topic drift, hot-streak detection (≥3 consecutive A-grade years), and career phase. Runs via `aiwg corpus profile-temporal`.
140SKILL.mdUpdated May 28, 2026