Skip to content
Skill

ralph

by rohunj

AI Summary

Automates conversion of product requirement documents (PRDs) into Ralph's prd.json format for autonomous agent execution. Developers managing Ralph-based autonomous systems benefit from streamlined PRD structuring and standardization.

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "ralph" skill in my project.

Please run this command in my terminal:
# Install skill into the correct directory
mkdir -p .claude/skills/ralph && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/ralph/SKILL.md "https://raw.githubusercontent.com/rohunj/claude-build-workflow/main/skills/ralph/SKILL.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Convert PRDs to prd.json format for the Ralph autonomous agent system. Use when you have an existing PRD and need to convert it to Ralph's JSON format. Triggers on: convert this prd, turn this into ralph format, create prd.json from this, ralph json.

Requirements

• Toggle between pending/in-progress/done on task list • Filter list by status • Show status badge on each task • Persist status in database ` Output prd.json: `json { "project": "TaskApp", "branchName": "ralph/task-status", "description": "Task Status Feature - Track task progress with status indicators", "userStories": [ { "id": "US-001", "title": "Add status field to tasks table", "description": "As a developer, I need to store task status in the database.", "acceptanceCriteria": [ "Add status column: 'pending' | 'in_progress' | 'done' (default 'pending')", "Generate and run migration successfully", "Typecheck passes" ], "priority": 1, "passes": false, "notes": "" }, { "id": "US-002", "title": "Display status badge on task cards", "description": "As a user, I want to see task status at a glance.", "acceptanceCriteria": [ "Each task card shows colored status badge", "Badge colors: gray=pending, blue=in_progress, green=done", "Typecheck passes", "Verify in browser using dev-browser skill" ], "priority": 2, "passes": false, "notes": "" }, { "id": "US-003", "title": "Add status toggle to task list rows", "description": "As a user, I want to change task status directly from the list.", "acceptanceCriteria": [ "Each row has status dropdown or toggle", "Changing status saves immediately", "UI updates without page refresh", "Typecheck passes", "Verify in browser using dev-browser skill" ], "priority": 3, "passes": false, "notes": "" }, { "id": "US-004", "title": "Filter tasks by status", "description": "As a user, I want to filter the list to see only certain statuses.", "acceptanceCriteria": [ "Filter dropdown: All | Pending | In Progress | Done", "Filter persists in URL params", "Typecheck passes", "Verify in browser using dev-browser skill" ], "priority": 4, "passes": false, "notes": "" } ] } ` ---

Ralph PRD Converter

Converts existing PRDs to the prd.json format that Ralph uses for autonomous execution. ---

The Job

Take a PRD (markdown file or text) and convert it to prd.json in your ralph directory. ---

Output Format

`json { "project": "[Project Name]", "branchName": "ralph/[feature-name-kebab-case]", "description": "[Feature description from PRD title/intro]", "userStories": [ { "id": "US-001", "title": "[Story title]", "description": "As a [user], I want [feature] so that [benefit]", "acceptanceCriteria": [ "Criterion 1", "Criterion 2", "Typecheck passes" ], "priority": 1, "passes": false, "notes": "" } ] } ` ---

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 2mo ago
Active
Adoption100+ stars on GitHub
228 ★ · Growing
DocsREADME + description
Well-documented

GitHub Signals

Stars228
Forks39
Issues0
Updated2mo ago
View on GitHub
No License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code