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.