skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
richtabor/agent-skills62 installs

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-loop
view source ↗

Is 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

  1. Shows dependency graph, finds next available project
  2. Creates git worktree at ../{repo}-{feature}/
  3. 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
  4. 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

  1. At least one .json PRD file in .claude/plans/, plans/, or prds/
  2. Use plan mode to create a plan, then run /ralph-json-create-issues to convert it

Notes

  • Run multiple Ralphs in parallel on independent projects (separate terminals)
  • Each works in its own worktree, no conflicts

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>