ralph-json-start-loop
Runs the Ralph autonomous loop. Executes stories from prds/*.json using git worktrees.
Profile →npx skills add majiayu000/claude-skill-registry --skill ralph-json-start-loop --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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: ```bash ~/.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: ```json { "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/`, `p
- Usage
- Process
- What It Does
- Dependencies
- Prerequisites
- Notes
What does the ralph-json-start-loop skill do?
Runs the Ralph autonomous loop. Executes stories from prds/*.json using git worktrees.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill ralph-json-start-loop --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.