ralph

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the conversion of a PRD into Ralph's prd.json format, enabling consistent input for Ralph's autonomous agent workflows.

Core Features & Use Cases

  • PRD to prd.json conversion: transforms project descriptions, user stories, and acceptance criteria into Ralph's JSON schema.
  • Auto-detection and saving: automatically saves the resulting prd.json to the global Ralph projects directory, regardless of input location.
  • PRD format compatibility: supports PRDs written in Markdown or plain text and outputs a ready-to-run prd.json for automation.

Quick Start

Place your PRD as input (for example, prd.md) and run the Ralph PRD Converter. The tool detects the project context and saves prd.json to the global Ralph projects 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 JSON for autonomous project management workflows?

To convert a PRD into JSON, this tool transforms Markdown or plain text project descriptions into Ralph's prd.json format, extracting user stories and acceptance criteria to enable autonomous execution. It outputs a structured JSON object with project, branchName, description, and userStories fields.

What is the prd.json format used for in AI-assistant automation?

The prd.json format provides consistent, machine-readable input for Ralph's autonomous agent workflows. It structures project descriptions, user stories, required acceptance criteria, and per-iteration story boundaries to enable automated project management execution.

Can I use Markdown PRDs to generate a prd.json file?

Yes, you can use Markdown PRDs to generate a prd.json file. The converter supports both Markdown and plain text input formats, automatically detecting the project context and transforming the content into the required JSON schema.

How do I save a generated prd.json to the global Ralph projects directory?

The tool automatically saves the generated prd.json to the global Ralph projects directory. You simply provide your PRD as input and run the converter; it handles the auto-detection and saving process regardless of your input file location.

Does PRD to JSON conversion include acceptance criteria and story boundaries?

Yes, PRD to JSON conversion includes required acceptance criteria and per-iteration story boundaries. The output JSON object contains a userStories array that structures these elements to ensure the autonomous agent can execute the project correctly.

What are the limitations of using automated PRD conversion for project management?

A limitation of automated PRD conversion is its strict schema requirement; the output must conform to Ralph's prd.json format with specific fields like project, branchName, description, and userStories. Input PRDs must clearly define acceptance criteria for successful autonomous execution.