ralph

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

Updated Nov 2, 2024
One-click install
npx skills add https://github.com/nrminor/.dotfiles --skill ralph-nrminor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/nrminor/.dotfiles/tree/main/.config/.claude/skills/ralph
Command: npx skills add https://github.com/nrminor/.dotfiles --skill ralph-nrminor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill converts product requirements documents (PRDs) into a Ralph-compatible prd.json payload, enabling automated planning for Ralph autonomous agent workflows.

Core Features & Use Cases

  • PRD to JSON conversion: Transform a structured PRD into the Ralph JSON schema, including project, branchName, description, and userStories.
  • Branch-ready outputs: Produces a ready-to-use prd.json suitable for version control and deployment in Ralph pipelines.
  • Use Case: You have a new PRD outlining a feature; run this skill to generate a Ralph-compatible plan you can immediately hand off to the agent.

Quick Start

Run the Ralph PRD Converter on your PRD file to generate prd.json in the target Ralph directory.

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 a JSON format for Ralph workflows?

This Skill converts product requirements documents into Ralph-compatible prd.json payloads by extracting project name, branch name, description, and user stories from Markdown or raw text PRDs into a deterministic JSON schema ready for autonomous agent deployment.

What PRD formats does this conversion tool accept?

The Skill accepts Markdown-formatted PRDs and raw text documents, parsing them to extract structured fields that map directly into the Ralph JSON schema for downstream automation.

Can I use this to automate PRD-to-JSON conversion in my CI/CD pipeline?

Yes. This Skill generates branch-ready prd.json outputs suitable for version control and Ralph pipeline deployment, enabling automated handoff from PRD creation to autonomous agent workflows without manual restructuring.

What fields does the generated prd.json include?

The converted prd.json contains project, branchName, description, and userStories fields with verifiable types and deterministic structure, matching Ralph's required schema for agent-driven planning.

Do I need to pre-format my PRD before running this conversion?

No special pre-formatting is required. The Skill processes existing Markdown PRDs or raw text directly, extracting and mapping content into Ralph-compatible JSON without requiring manual restructuring beforehand.