Agent skill · software engineering · aradotso
ralph-autonomous-agent-loop
ralph-autonomous-agent-loop — an agent skill for coding agents.
Why this skill is useful
Adds executable scripts and a structured workflow for autonomous coding using AI tools, which significantly extends the agent's capabilities.
What it needs
Requires @anthropic-ai/claude-code, amp, jq installed locally. About 7k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
bash From your project root mkdir -p scripts/ralph Copy the shell loop cp /path/to/ralph/ralph.sh scripts/ralph/ Copy prompt template for your tool: cp /path/to/ralph/prompt.md scripts/ralph/prompt.md # For Amp OR cp /path/to/ralph/CLAUDE.md scripts/ralph/CLAUDE.md # For Claude Code chmod +x scripts/ralph/ralph.sh bash cp -r skills/prd ~/.config/amp/skills/ cp -r skills/ralph ~/.config/amp/skills/ bash /plugin marketplace add snarktank/ralph /plugin install ralph-skills@ralph-marketplace Load the prd skill and create a PRD for [your feature description] Load the ralph skill and convert tasks/prd-my-feature.md to prd.json bash Default: Amp, 10 iterations ./scripts/ralph/ralph.sh With explicit iteration count ./scripts/ralph/ralph.sh 20 Using Claude Code ./scripts/ralph/ralph.sh --tool claude Using Claude Code with custom iteration count ./scripts/ralph/ralph.sh --tool claude 15 Using Amp explicitly ./scripts/ralph/ralph.sh --tool amp 10 json { "branchName": "feature/user-dashboard", "projectContext": "A Next.js SaaS app using Prisma, tRPC, and Tailwind.", "userStories": [ { "id": "story-1", "title": "Add avatar column to users table", "priority": 1, "passes": false, "description": "Add an optional avatarUrl string column to the User model via Prisma migration.", "acceptanceCriteria": [ "Migration file created and applied", "User model updated in schema.prisma", "TypeScript types regenerated", "Existing tests still pass" ] }, { "id": "story-2", "title": "Display avatar in profile header", "priority": 2, "passes": false, "description": "Show the user's avatar image in the top-right profile header component.", "acceptanceCriteria": [ "Avatar renders when avatarUrl is set", "Fallback initials shown when avatarUrl is null", "Verify in browser using dev-browser skill" ] } ] } bash Which stories are done vs pending? cat prd.json jq '.userStories[] {id, title, passes}' What has Ralph learned so far? cat progress.txt Recent commits from Ralph iterations git log --oneline -10 …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/ralph-autonomous-agent-loop