ralph-loop-workflow — Claude Code skill: autonomous coding
This skill runs an agent through a coding loop that turns a broad goal into tasks, changes code, and checks the result. Use it for work that needs repeated agent-led iterations.
npx skills add andrelandgraf/fullstackrecipes --skill ralph-loop-workflow -a claude-codeWhat ralph-loop-workflow does
Start the workflow with /ralph. The agent keeps its own task list, chooses a priority, makes a change, writes tests, and checks the build and app in a browser. Once checks pass, it updates user-facing docs and commits the work before moving on.
Before the first task, the skill checks whether relevant CLIs are installed, linked to the project, and authenticated. A failed check stops the run and prompts the agent to give you fix commands. It also stops when you have not provided a broad outcome to pursue. Prepare the agent configuration, code-health checks, and tests first. Browser checks use http://localhost:3000, and the development server should stay up with bun run dev.
The workflow depends on project context, tools, and checks: these can include AGENTS.md, MCP servers, and installed skills. Tests run against an isolated database branch. A missing CLI or login blocks the loop before it starts, so the preflight has to pass first.
What it helps with
- turn a broad development goal into agent-managed tasks
- check CLI setup and authentication before a run
- test and verify changes as the agent works
- update docs and commit completed tasks
Example prompts for the agent
/ralph— add account creation and sign-in to the app, then verify the flow./ralph— build project search and check it with tests./ralph— prepare the app for deployment and test it in the browser.
How to install ralph-loop-workflow
1Skills CLI (Vercel)
npx skills add andrelandgraf/fullstackrecipes --skill ralph-loop-workflow -a claude-code2Manually: put the files in place
~/.claude/skills/ralph-loop-workflow/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ralph-loop-workflow/
1Skills CLI (Vercel)
npx skills add andrelandgraf/fullstackrecipes --skill ralph-loop-workflow -a codex2Manually: put the files in place
.agents/skills/ralph-loop-workflow/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add andrelandgraf/fullstackrecipes --skill ralph-loop-workflow -a cursor2Manually: put the files in place
.cursor/skills/ralph-loop-workflow/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install andrelandgraf/fullstackrecipes ralph-loop-workflow2Manually: put the files in place
.github/skills/ralph-loop-workflow/SKILL.md1Skills CLI (Vercel)
npx skills add andrelandgraf/fullstackrecipes --skill ralph-loop-workflow -a gemini-cli2Platform CLI
gemini skills install https://github.com/andrelandgraf/fullstackrecipes --path skills/ralph-loop-workflowManually: put the files in place
.devin/skills/ralph-loop-workflow/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add andrelandgraf/fullstackrecipes --skill ralph-loop-workflow -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ralph-loop-workflow
How do I install ralph-loop-workflow in Claude Code?
Run npx skills add andrelandgraf/fullstackrecipes --skill ralph-loop-workflow -a claude-code. The skill file is at ~/.claude/skills/ralph-loop-workflow/SKILL.md.
What does ralph-loop-workflow do?
It runs an agent through a repeatable coding process: the agent plans tasks, implements changes, and checks its work. After passing verification, it updates docs and commits.
What should I set up before starting the loop?
Prepare agent configuration, code checks, and tests, then give the agent a broad outcome to pursue. The project also needs its tools and a running dev server via bun run dev.
