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

# Add to your project root as SKILL.md
curl -o SKILL.md "https://raw.githubusercontent.com/rohunj/claude-build-workflow/main/skills/ralph/SKILL.md"

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": "" } ] } ` ---

Quality Score

B

Good

79/100

Standard Compliance72
Documentation Quality75
Usefulness78
Maintenance Signal80
Community Signal100
Scored Today

GitHub Signals

Stars228
Forks39
Issues0
Updated1mo ago
View on GitHub

Trust & Transparency

No License Detected

Review source code before installing

Verified Open Source

Hosted on GitHub — publicly auditable

Actively Maintained

Last commit 1mo ago

228 stars — Growing Community

39 forks

My Fox Den

Community Rating

Works With

Claude Code