ralph

Convert Product Requirement Documents into Ralph's prd.json format.

1|Updated Mar 3, 2025
One-click install
npx skills add https://github.com/pyraxo/dotfiles --skill ralph-pyraxo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/pyraxo/dotfiles/tree/main/projects/ralph/.claude/skills/ralph
Command: npx skills add https://github.com/pyraxo/dotfiles --skill ralph-pyraxo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of converting Product Requirement Documents (PRDs) into the prd.json format required by the Ralph autonomous agent system, ensuring that features are broken down into manageable, single-iteration tasks.

Core Features & Use Cases

  • PRD to JSON Conversion: Transforms markdown or text-based PRDs into Ralph's structured JSON format.
  • Story Sizing & Prioritization: Enforces rules for creating right-sized user stories and ordering them based on dependencies.
  • Acceptance Criteria Definition: Guides the creation of verifiable acceptance criteria, including specific checks for typechecking and browser verification.
  • Use Case: A product manager has a detailed PRD for a new feature. They use this Skill to convert it into a prd.json file, which is then fed to the Ralph agent to begin development, ensuring each step is actionable and testable.

Quick Start

Convert this PRD into Ralph's prd.json format.

Frequently Asked Questions about ralph

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a PRD into JSON for autonomous agents?

Converting a PRD into autonomous agent JSON involves transforming markdown requirements into a structured prd.json format that enforces story sizing and dependency ordering for the Ralph agent system.

How do I split large features into single-iteration user stories from a PRD?

Splitting large features from a PRD into single-iteration user stories requires enforcing rules for story size and dependency-based ordering, ensuring each generated task remains manageable and actionable for development.

What is the best way to define verifiable acceptance criteria for autonomous agent tasks?

Defining verifiable acceptance criteria for autonomous agent tasks involves specifying concrete checks during PRD conversion, including mandatory typechecking and browser verification to ensure each story is fully testable.

Can I use markdown PRDs to generate structured JSON for the Ralph autonomous agent system?

Yes, you can use markdown PRDs to generate structured JSON for the Ralph autonomous agent system by processing the text through a conversion skill that outputs the required prd.json format with dependency-based ordering.

Why does my autonomous agent fail to process large features from a PRD?

Autonomous agents fail to process large features from a PRD because the features exceed single-iteration limits; they must be split into smaller, right-sized user stories with verifiable acceptance criteria before conversion.