01
It starts by itself
new PRD file added. Runs in Claude Code routine.
- ↻ new PRD file added
event: new PRD markdown in the ralph directory
snarktank · 876 installsRalph skill
Runs by itself, every time a new plan is added.
Every plan becomes small, ordered tasks.
Install the Ralph skill and make it a habit: follow https://gethabit.dev/skills/snarktank/ralph.md
- 1Copy
- 2Paste into Claude Code, Codex or Cursor
- 3It runs by itself
876 installs22K starsMIT licenceSource on GitHub ↗
Ralph
by snarktank · 876 installs
The skill
Turns a plan document into small steps an agent can run.
Only when you ask.
Ship faster
Every plan becomes small, ordered tasks. Less rework and fewer stuck runs.
↻ Runs by itselfevery time a new plan is added
How the habit works.
You don't have to.
When does it start? How does it check its work? What does it remember?
One run, step by step.
Then it stops.
Stops after one PRD per run, with at most one retry.
- 01
Archive old run
If prd.json exists with a different branchName and progress.txt has content, copy both into archive/YYYY-MM-DD-feature-name/ and reset progress.txt.
- 02
Split stories
Cut the PRD into stories small enough for one Ralph iteration.
- 03
Order by dependency
Put schema first, then backend, then UI, then summary views.
- 04
Write criteria
Give each story checkable criteria, add Typecheck passes, and add the dev-browser skill check for UI stories.
- 05
Save prd.json
Write prd.json with sequential ids, priorities and empty notes.
- 06
Run the checklist
Confirm no story depends on a later one and no criterion is vague.
What it may do.
Nothing more.
It writes only in its own folder and asks you before anything goes out.
- Writes only inprd.json, progress.txt, archive/**
- Talks tono outside service
- Sendsnothing
- Your OKNothing goes out, so it needs no OK.
Is it for you?
Use it when it fits.
Read both lists. If the left one sounds like you, the Ralph skill helps.
Use it when
- ✓ You have a PRD to run with Ralph
- ✓ You need prd.json from a markdown spec
- ✓ You start a new Ralph feature
Skip it when
- – You have no PRD yet
- – You do not use Ralph
Ralph skill, answered.
Why must stories be small?
Ralph starts a fresh Amp instance per iteration with no memory, so a big story can run out of context.
Does the skill run Ralph?
No. It only converts the PRD; the ralph.sh script runs the stories.
How do I install the Ralph skill?
Copy the prompt at the top into your agent. It installs the skill from snarktank/ralph and sets up the habit. Or run npx skills add snarktank/ralph --skill ralph.
Is the Ralph skill free?
Yes. It is published under MIT. Habit is free too.
Ralph. Now as a habit.
Install the Ralph skill and make it a habit: follow https://gethabit.dev/skills/snarktank/ralph.md
All snarktank skills →More planning skills →
Works in
- Claude Code
- Codex
- Cursor
- ChatGPT
- Claude app
Made by snarktank, published under MIT. Habit links to the original and never changes it. Is this your skill?