ralph

Convert markdown or plain text PRDs into Ralph's prd.json format.

17|1|Updated Nov 17, 2024
One-click install
npx skills add https://github.com/ruska-ai/orchestra --skill ralph-ruska-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/ruska-ai/orchestra/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/ruska-ai/orchestra --skill ralph-ruska-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the translation of product requirements into Ralph's prd.json format, enabling consistent PRD-to-action mapping for Ralph-based autonomous agents.

Core Features & Use Cases

  • PRD to prd.json conversion: Converts markdown PRDs or plain text into Ralph-compatible JSON with project, branchName, description, and userStories.
  • Guided output structure: Produces a ready-to-commit prd.json following Ralph's conversion rules and story sizing guidance.
  • Use Case: When you have a PRD and need to generate a Ralph-ready plan with US-001 US-002 entries and acceptance criteria.

Quick Start

Provide the PRD text; the skill outputs a prd.json ready for Ralph.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I convert a markdown PRD to a structured JSON format?

To convert a markdown PRD to structured JSON, the skill translates markdown or plain text product requirements into a Ralph-ready prd.json containing branch names, descriptions, and user stories with acceptance criteria.

What is the best way to generate user stories with acceptance criteria from a PRD?

Generating user stories with acceptance criteria from a PRD is done by processing text through Ralph's conversion rules, which outputs structured US-001 and US-002 entries within a standard prd.json file.

Does the PRD to prd.json conversion require any external dependencies?

No, the PRD to prd.json conversion requires no external dependencies beyond the Ralph workflow, operating standalone to produce standard JSON and text output suitable for version control.

Can I use plain text PRDs for autonomous workflow story generation?

Yes, you can use plain text PRDs for autonomous workflow story generation because the skill accepts both markdown and plain text inputs, applying Ralph's story sizing guidance to generate ready-to-commit JSON.

What output structure should I expect when turning product requirements into a JSON plan?

When turning product requirements into a JSON plan, the output structure is a guided prd.json file featuring project details, branchName, description, and a userStories array with mapped acceptance criteria.