.claude/skills/ralph-archive/SKILL.md
Archive the current Ralph prd.json and progress.txt before starting a new feature. Use when you need to archive a completed or abandoned Ralph run. Triggers on: archive ralph, archive prd, ralph archive, clear ralph, reset ralph.
npx skillsauth add ruska-ai/orchestra ralph:archiveInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Archives the current .ralph/prd.json and .ralph/progress.txt into .ralph/archive/[feat|bug]-<issue#>/ so a new Ralph run can start clean.
.ralph/prd.json exists — if not, inform the user there is nothing to archive and stop.ralph/prd.json to extract the branch name from branchNamefeat/810-feature-name → feat-810, bug/796-save-error → bug-796.ralph/archive/[feat|bug]-<issue#>/.ralph/prd.json to the archive directory.ralph/progress.txt to the archive directory (if it exists).ralph/ root[feat|bug]-<issue#> derived from branchName in prd.json (e.g., feat/810-feature-name → feat-810)feat-810-2/)Given .ralph/prd.json contains:
{
"branchName": "feat/810-collapsible-tool-inputs",
"description": "Collapsible Tool Inputs Feature"
}
Running this skill produces:
.ralph/archive/feat-810/prd.json
.ralph/archive/feat-810/progress.txt
# 1. Read branchName from prd.json
BRANCH=$(jq -r '.branchName' .ralph/prd.json)
ARCHIVE_DIR=".ralph/archive/$(echo $BRANCH | sed 's|/\([0-9]*\).*|-\1|')"
# 2. Handle collision
if [ -d "$ARCHIVE_DIR" ]; then
SUFFIX=2
while [ -d "${ARCHIVE_DIR}-${SUFFIX}" ]; do
SUFFIX=$((SUFFIX + 1))
done
ARCHIVE_DIR="${ARCHIVE_DIR}-${SUFFIX}"
fi
# 3. Create, copy, and clean
mkdir -p "$ARCHIVE_DIR"
cp .ralph/prd.json "$ARCHIVE_DIR/"
[ -f .ralph/progress.txt ] && cp .ralph/progress.txt "$ARCHIVE_DIR/"
rm -f .ralph/prd.json .ralph/progress.txt
.ralph/prd.json exists before archiving[feat|bug]-<issue#> naming from branchNameprd.json and progress.txt are copied then originals removed.ralph/ root (prd.json, progress.txt)tools
Apply coordinated changes across multiple files efficiently using parallel Edit tool calls. Use when making systematic changes like renaming variables, updating imports, applying pattern changes, or refactoring across files. Triggers on: rename across files, update all imports, change pattern in multiple files, refactor across codebase, batch edit files.
testing
Record browser workflows as video and convert to high-quality GIFs using agent-browser and ffmpeg. Use when users ask to record workflow, create gif, record demo, browser recording, workflow gif, or screen recording.
development
Run and verify frontend tests for the React/Vite application.
development
Run and verify backend tests for the FastAPI/Python application.