ralph

Convert Markdown or text PRDs into Ralph-compatible prd.json files.

3|Updated Aug 18, 2025
One-click install
npx skills add https://github.com/rileyseaburg/codetether --skill ralph-rileyseaburg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/rileyseaburg/codetether/tree/main/opencode/.opencode/skill/ralph
Command: npx skills add https://github.com/rileyseaburg/codetether --skill ralph-rileyseaburg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts existing PRDs to Ralph-compatible prd.json format to enable autonomous agents to execute product requirements within Ralph's system.

Core Features & Use Cases

  • Converts Markdown or text PRDs into a Ralph-compatible prd.json structure with project, branchName, and userStories.
  • Generates a prd.json containing a structured set of user stories (US-001, US-002, etc.) and a recommended branching strategy.
  • Provides guidance on PRD-to-iteration splitting to support one-story-per-iteration execution.

Quick Start

Use the Ralph PRD Converter to transform a provided PRD into 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 for automated execution?

To convert a markdown PRD to a structured JSON format, this Skill parses your existing text-based requirements and generates a Ralph-compatible prd.json file. The output includes structured project metadata, a standardized branchName, and formatted userStories.

What is the best way to split a product requirements document into single-iteration user stories?

Splitting a product requirements document into single-iteration user stories is handled by generating structured user stories (US-001, US-002) within the prd.json. It enforces a one-story-per-iteration execution model and provides guidance on PRD-to-iteration splitting.

Can I use a plain text PRD with automated agents without reformatting it myself?

Yes, you can use a plain text PRD with automated agents. This Skill accepts both Markdown and text PRDs, automatically structuring the content into a prd.json file with project metadata and user stories ready for Ralph agents.

Does converting a PRD to prd.json include branch naming and test verification guidelines?

Converting a PRD to prd.json does include a standardized branchName and test verification guidelines. The generated JSON structure contains project, branchName, description, and userStories fields, alongside typecheck and test verification guidance.

Why does my automated agent execution require a specific PRD JSON structure?

Automated agent execution requires a specific PRD JSON structure to reliably parse and execute product requirements. This format ensures agents receive structured userStories, clear project metadata, and a standardized branchName for consistent automated processing.

When do I need to generate a prd.json file from my product requirements?

You need to generate a prd.json file from your product requirements when you want to enable autonomous Ralph agents to execute your project. It transforms static Markdown or text PRDs into an automated, structured execution format.