New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Ralph

by TheCraigHewitt in TheCraigHewitt/skills

Autonomous PRD implementation loop — turns GitHub issues into shipped code using TDD, code review gates, and Docker sandbox isolation.

MITAuto-check passedProduct & Project Management

Install Ralph

skills CLI
$ npx skills add TheCraigHewitt/skills --skill ralph -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install TheCraigHewitt/skills ralph --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/TheCraigHewitt/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/coding/ralph .claude/skills/ralph && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ralph
GitHub stars
157
Token cost
~1k tokens
SKILL.md length
424 words
Files
5
Skills in repo
65
Repo updated
First seen
Licence
MIT

At a glance

Autonomous PRD implementation loop — turns GitHub issues into shipped code using TDD, code review gates, and Docker sandbox isolation.

  • Works in 6 steps: Parse arguments: first is the PRD issue… → If no issue number is provided, ask for it → Verify ralph/ directory exists at the… → …
  • Tasks that involve PRD writing
  • SKILL.md covers The Pipeline, Setup, Usage and Instructions, plus 3 more sections
  • Runs Shell scripts from its folder; calls npx

What it does

Ralph is an agent skill from TheCraigHewitt/skills. Autonomous PRD implementation loop — turns GitHub issues into shipped code using TDD, code review gates, and Docker sandbox isolation. The execution engine for the grill-me → write-a-prd → prd-to-issues → ralph pipeline.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `afk-ralph.sh`, `prompt.md` and `ralph-once.sh`).

It sits in Product & Project Management, covering PRD writing, Requirements gathering and Test-driven development. It works with GitHub and Docker. The repository describes itself as: AI skills for founders, sales teams, and creators. 47 skills across CEO, Sales, YouTube, and General categories. Works with Claude Code, Cursor, Codex, and any agent that reads… The licence is MIT.

When your agent uses it

  • Tasks that involve PRD writing
  • Tasks that involve Requirements gathering
  • Tasks that involve Test-driven development

Example prompts

  • “/ralph”

Requirements

  • Node.js
  • A Bash shell
  • Docker

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Parse arguments: first is the PRD issue number (required), second is mode (once or afk, default once), third is max iterations for afk…
  2. If no issue number is provided, ask for it
  3. Verify ralph/ directory exists at the project root. If not, guide the user through setup (copy scripts from .agents/skills/ralph/)
  4. For once mode (default)
  5. For afk mode
  6. Report the result when complete

What it can do on your machine

Read from SKILL.md and the folder at commit fdbf39b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • claude.ai
    • cli.github.com
    • docker.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ralph loads about 1k tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 424 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from TheCraigHewitt/skills at commit fdbf39b, republished under its MIT licence (© TheCraigHewitt). 424 words, ~1,024 tokens.

Download SKILL.mdSave it as .claude/skills/ralph/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
ralph
description
Autonomous PRD implementation loop — turns GitHub issues into shipped code using TDD, code review gates, and Docker sandbox isolation. The execution engine for the grill-me → write-a-prd → prd-to-issues → ralph pipeline.

RALPH — Autonomous PRD Implementation

RALPH (Repeated Autonomous Loop for PRD Handling) implements a PRD stored as GitHub issues — autonomously, with TDD, and a code review gate after every iteration.

The Pipeline

This skill is the execution engine for a 4-step coding workflow:

StepCommandWhat It Does
1/grill-meStress-test your idea with relentless questions before building
2/write-a-prdTurn the idea into an engineering spec (PRD) as a GitHub issue
3/prd-to-issuesBreak the PRD into vertical-slice sub-issues with dependencies
4/ralphImplement each sub-issue autonomously with TDD + code review

Steps 1-3 use skills from Matt Pocock. Install them:

bash
npx skills@latest add mattpocock/skills -s grill-me
npx skills@latest add mattpocock/skills -s write-a-prd
npx skills@latest add mattpocock/skills -s prd-to-issues

Setup

After installing this skill, copy the RALPH scripts to your project root:

bash
mkdir -p ralph
cp .agents/skills/ralph/afk-ralph.sh ralph/
cp .agents/skills/ralph/ralph-once.sh ralph/
cp .agents/skills/ralph/prompt.md ralph/
cp .agents/skills/ralph/review-prompt.md ralph/
chmod +x ralph/*.sh
Requirements

Usage

/ralph <issue-number> — Human-in-the-loop (start here)
bash
./ralph/ralph-once.sh 42

Implements one sub-issue from PRD #42, then stops for your review. Run again for the next one. Recommended for your first few iterations.

/ralph <issue-number> afk [max-iterations] — Autonomous
bash
./ralph/afk-ralph.sh 42 20

Runs up to 20 iterations inside a Docker sandbox. Each iteration: implement one sub-issue, run tests, commit, code review, close issue. When all sub-issues are done, pushes the branch and opens a PR.

Instructions

When the user invokes this skill:

  1. Parse arguments: first is the PRD issue number (required), second is mode (once or afk, default once), third is max iterations for afk mode (default 20)
  2. If no issue number is provided, ask for it
  3. Verify ralph/ directory exists at the project root. If not, guide the user through setup (copy scripts from .agents/skills/ralph/)
  4. For once mode (default):
    bash
    ./ralph/ralph-once.sh <issue-number>
  5. For afk mode:
    bash
    ./ralph/afk-ralph.sh <issue-number> <max-iterations>
  6. Report the result when complete
Show full SKILL.md (148 more words)Show less

How It Works

  1. Scripts fetch the PRD issue and all sub-issues via gh CLI
  2. Sub-issues are found by searching for Parent PRD #<number> in their body
  3. Each iteration: Claude picks one open, unblocked sub-issue and implements it using TDD
  4. Tests must pass before every commit (auto-detected from project config)
  5. After committing, a code review gate checks for bugs, logic errors, security issues, and architecture violations
  6. Claude closes the sub-issue on GitHub with a comment linking the commit
  7. Loop continues until all sub-issues are closed

Sub-Issue Format

Sub-issues created by /prd-to-issues follow this format:

markdown
## Parent PRD
#42

## What to build
Description of the work...

## Acceptance criteria
- [ ] Criterion 1
- [ ] Criterion 2

## Blocked by
- #43

Tips

  • Start with /ralph (once mode). Validate the first iteration before going AFK.
  • Keep sub-issues small. One logical change per sub-issue prevents context rot.
  • Use /grill-me first. The more you think before coding, the better RALPH performs.
  • Use blocked-by. Declare dependencies so RALPH works in the right order.

© TheCraigHewitt, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files in coding/ralph of TheCraigHewitt/skills.

  • SKILL.md
  • afk-ralph.sh
  • prompt.md
  • ralph-once.sh
  • review-prompt.md

Open the folder on GitHubat commit fdbf39b

Compare with similar skills

Ralph next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ralph compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ralph this skillTheCraigHewitt/skills157—~1kAutomated safety check: PassMIT
Ouroboros PM InterviewQ00/ouroboros6.2k—~5.7kAutomated safety check: PassMIT
Creating Issuesopsmill/infrahub533—~1.2kAutomated safety check: PassApache-2.0
Setup Matt Pocock Skillsywwynm/EverythingDone1449 repos~1.7kAutomated safety check: PassGPL-3.0
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
User Alignment and Agent-Ready PRDstryproduck/produck-skills510—~5.3kAutomated safety check: PassApache-2.0

Similar skills

  • Ouroboros PM Interview

    Q00/ouroboros

    Runs a guided product-manager interview that classifies each question automatically and produces a Product Requirements Document.

    6.2k GitHub stars~5.7k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed

  • Creating Issues

    opsmill/infrahub

    Turns a single feature idea, improvement, or bug into ONE well-structured GitHub issue.

    533 GitHub stars~1.2k tokensUpdated today
    Product & Project ManagementAuto-check passed

  • Setup Matt Pocock Skills

    ywwynm/EverythingDone

    Sets up an Agent skills block in AGENTS.md/CLAUDE.md and docs/agents/ so the engineering skills know this repo's issue tracker (GitHub or local markdown), triage label vocabulary, and domain doc…

    144 GitHub starsUsed in 9 repos~1.7k tokens
    Agent WorkflowsAuto-check passed

  • CCPM Project Management

    automazeio/ccpm

    Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed

  • User Alignment and Agent-Ready PRDs

    tryproduck/produck-skills

    Turns a vague feature request into a written spec with scope, phases, acceptance criteria and do-not-do limits that a coding agent can follow without guessing.

    510 GitHub stars~5.3k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed

  • Feature Forge

    Jeffallan/claude-skills

    Runs a structured requirements interview to produce a feature specification with EARS requirements, acceptance criteria and an implementation checklist.

    12k GitHub stars~1.1k tokensUpdated 6 days ago
    Product & Project ManagementAuto-check passed

More from TheCraigHewitt/skills

All 65 skills in this repo

  • Carousels

    TheCraigHewitt/skills

    Turns a piece of Craig's content (an email, a YouTube script, an essay, or pasted text) into a polished image carousel publishable to both LinkedIn and Instagram from one set of 1080x1350 slides.

    157 GitHub stars~2.3k tokensUpdated 4 mo ago
    Auto-check passed

  • Audience Research

    TheCraigHewitt/skills

    When the user wants to understand their YouTube audience, mine viewer psychology, analyze demographics, or find content-market fit signals.

    157 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check passed

  • Brain Dump

    TheCraigHewitt/skills

    Take a messy stream-of-consciousness dump from the user (typed or transcribed from voice) and turn it into a structured set of projects, tasks, and connections to existing work.

    157 GitHub stars~1.3k tokensUpdated 4 mo ago
    Auto-check passed

  • Channel Audit

    TheCraigHewitt/skills

    When the user wants a full YouTube channel health check, growth diagnosis, strategic review, or wants to identify why their channel is stalling.

    157 GitHub stars~2.4k tokensUpdated 4 mo ago
    Auto-check passed

  • Channel Strategy

    TheCraigHewitt/skills

    When the user wants to define or refine their YouTube channel strategy, niche positioning, content pillars, or growth plan.

    157 GitHub stars~2.2k tokensUpdated 4 mo ago
    Auto-check passed

  • Cold Call

    TheCraigHewitt/skills

    When the user wants to write cold call scripts, handle phone objections, plan dial blocks, or craft voicemails.

    157 GitHub stars~5k tokensUpdated 4 mo ago
    Auto-check passed

Works with

Categories

Questions about Ralph

What does Ralph do?

Autonomous PRD implementation loop — turns GitHub issues into shipped code using TDD, code review gates, and Docker sandbox isolation. Ralph is an agent skill from TheCraigHewitt/skills. Autonomous PRD implementation loop — turns GitHub issues into shipped code using TDD, code review gates, and Docker sandbox isolation.

When should I use Ralph?

Ralph fits situations like: tasks that involve PRD writing; tasks that involve Requirements gathering; tasks that involve Test-driven development.

How do I install Ralph in Claude Code?

Run `npx skills add TheCraigHewitt/skills --skill ralph -a claude-code`. Or copy the skill folder (coding/ralph in TheCraigHewitt/skills) into .claude/skills/ralph in your project. Claude Code loads it when a task matches its description.

How do I install Ralph in Codex?

Run `npx skills add TheCraigHewitt/skills --skill ralph -a codex`. Or copy the skill folder (coding/ralph in TheCraigHewitt/skills) into .agents/skills/ralph in your project. Codex loads it when a task matches its description.

Can I use Ralph in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add TheCraigHewitt/skills --skill ralph -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ralph, .gemini/skills/ralph, .github/skills/ralph and .opencode/skills/ralph in your project.

What does Ralph need to run?

Going by SKILL.md and its folder, Ralph needs a shell for the scripts in its folder and the command-line tools its instructions call (npx). Our summary lists: Node.js; A Bash shell; Docker.

Does Ralph access the network?

SKILL.md names 4 domains. As links in the text: github.com, claude.ai, cli.github.com and docker.com. This is read from the text; nothing was executed.

Is Ralph safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ralph use?

Ralph is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ralph use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Ralph?

Skills that share tags, products or a category with Ralph: Ouroboros PM Interview (Q00/ouroboros, 6.2k stars), Creating Issues (opsmill/infrahub, 533 stars), Setup Matt Pocock Skills (ywwynm/EverythingDone, 144 stars) and CCPM Project Management (automazeio/ccpm, 8.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ralph?

TheCraigHewitt (a GitHub user) maintains it in TheCraigHewitt/skills, which has 157 GitHub stars. The repository holds 65 skills in this directory. The repository was last updated on May 22, 2026.

Source: TheCraigHewitt/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.