ralph-json-start-loop
Runs the Ralph autonomous loop. Executes stories from prds/*.json using git worktrees.
How do I install this agent skill?
npx skills add https://github.com/richtabor/agent-skills --skill ralph-json-start-loopIs this agent skill safe to install?
- Gen Agent Trust Hubfail
This skill implements an autonomous coding loop that bypasses standard security permissions and is vulnerable to indirect prompt injection through project requirement files.
- Socketwarn
1 alert: gptSecurity
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
3/3 files flagged
What does this agent skill do?
Ralph
Run the autonomous loop to execute features from prds/ directory.
Usage
/ralph # Run next available project (respects dependencies)
/ralph 25 # Run with 25 iterations
/ralph auth-flow # Run specific project
Process
Run the loop script in background mode:
~/.claude/skills/ralph/ralph.sh [iterations] [project-name]
Use run_in_background: true to prevent timeout. After starting, tell the user to check progress with tail -f <worktree>/.ralph-progress.txt.
What It Does
- Shows dependency graph, finds next available project
- Creates git worktree at
../{repo}-{feature}/ - For each iteration:
- Picks first story where
passes: false - Implements it, runs quality checks
- Commits:
feat: [id] - [title] - Updates JSON, syncs back to main repo
- Picks first story where
- When all stories pass, outputs
<promise>COMPLETE</promise>
Dependencies
Ralph reads dependsOn from each PRD and enforces ordering:
{
"projectName": "Dashboard",
"dependsOn": ["auth-flow", "user-profile"]
}
Projects with incomplete dependencies are blocked. Ralph picks the first ready project alphabetically.
Prerequisites
- At least one
.jsonPRD file in.claude/plans/,plans/, orprds/ - Use plan mode to create a plan, then run
/ralph-json-create-issuesto convert it
Notes
- Run multiple Ralphs in parallel on independent projects (separate terminals)
- Each works in its own worktree, no conflicts
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/richtabor/agent-skills/ralph-json-start-loop">View ralph-json-start-loop on skillZs</a>