ralph-github-start-loop

Automate GitHub PRD story loops from assignment to closing.

69|11|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/richtabor/agent-skills --skill ralph-github-start-loop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph-github-start-loop
Source: https://github.com/richtabor/agent-skills/tree/main/skills/ralph-github-start-loop
Command: npx skills add https://github.com/richtabor/agent-skills --skill ralph-github-start-loop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill automates the end-to-end workflow of selecting, executing, and closing GitHub PRD stories by running autonomous loops against GitHub Issues.

Core Features & Use Cases

  • Autonomous loop over PRDs: identify ready work items, assign them to you, and orchestrate automated implementation.
  • Worktree orchestration: create and manage dedicated git worktrees per PRD to isolate work.
  • Story implementation: pass open stories to an autonomous agent, implement the chosen story, and generate a traceable commit.
  • Progress tracking: close sub-issues when a story is completed and update the parent PRD with progress.
  • PR creation: automatically create a PR for a PRD once all stories are done and the work is verified.
  • Use Case: teams using PRDs to describe features can automate the entire lifecycle from planning to merge.

Quick Start

Run the loop script to begin processing ready PRDs and automatically implement and close their stories.

Frequently Asked Questions about ralph-github-start-loop

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GitHub PRD story implementation and issue closure?

To automate GitHub PRD story implementation, run the autonomous loop script to fetch ready issues, assign them, implement changes via an agent, generate commits, and close sub-issues while updating the parent PRD. It requires PRDs structured as GitHub Issues with sub-issues.

What is the autonomous loop for executing GitHub PRDs?

The autonomous loop for GitHub PRDs is a process that identifies ready work items from GitHub Issues, orchestrates their implementation using dedicated git worktrees, and automatically closes stories upon completion. It manages the lifecycle from planning to merge.

Do I need the gh CLI to automate GitHub issue and PRD workflows?

Yes, you need the gh CLI authenticated to automate GitHub issue and PRD workflows. You also need a Git repository with PRDs stored in .claude/plans/ or prds/, and a working claude setup to generate and commit code changes.

How does git worktree orchestration work for PRD implementation?

Git worktree orchestration for PRD implementation creates and manages a dedicated, isolated git worktree per PRD. This isolates feature work while the autonomous agent implements the story and generates a traceable commit within that specific branch.

Can I automatically create a pull request when all PRD stories are done?

Yes, you can automatically create a pull request when all PRD stories are done. The loop verifies the completed work and automatically creates a PR for the PRD once all sub-issues are closed, streamlining the merge process.

What are the limitations of automating GitHub PRD loops with sub-issues?

A key limitation is that automating GitHub PRD loops requires strict structural prerequisites: PRDs must be described as issues with sub-issues and optional blocking relationships. Without this specific hierarchical issue structure, the autonomous loop cannot identify or process ready work.