ralph

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Convert existing PRDs into Ralph's prd.json format so they can be executed by Ralph's autonomous agent, enabling structured planning and automated iteration.

Core Features & Use Cases

  • Initialize a Ralph workspace (ralph/) if missing, copy a prompt template to ralph/prompt.md, and create or update ralph/progress.txt.
  • Convert a Markdown or text PRD into Ralph's prd.json with fields like project, branchName, description, and userStories.
  • Produce a ready-to-run PRD that supports one-story-per-iteration execution and progress tracking.

Quick Start

Tell it to convert a PRD into Ralph format to create ralph/prd.json and start the Ralph workflow.

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 autonomous execution?

To convert a PRD into JSON for autonomous execution, provide your Markdown or text PRD to initialize a Ralph workspace, generating a structured prd.json file containing project details and user stories for the autonomous agent.

What is the prd.json format used for in project management automation?

The prd.json format structures project requirements into fields like project, branchName, description, and userStories, enabling autonomous agents to execute plans iteratively while tracking progress in progress.txt.

Do I need a Markdown PRD to use this conversion process?

You need an existing PRD written in Markdown or text to use this conversion process. The tool reads your standard PRD documentation and transforms it into the structured JSON format required to start the workflow.

How to initialize a Ralph workspace from an existing PRD?

To initialize a Ralph workspace from an existing PRD, run the conversion process which creates a ralph/ directory, copies a prompt template to ralph/prompt.md if missing, and outputs ralph/prd.json and ralph/progress.txt.

Can I track project progress when converting a PRD to JSON?

You can track project progress when converting a PRD to JSON because the process automatically creates or updates a ralph/progress.txt file, logging iteration status as the autonomous agent executes user stories.

What is the best way to structure user stories for automated project execution?

The best way to structure user stories for automated project execution is to format them as a JSON array within prd.json, allowing the autonomous agent to process one story per iteration while logging status updates to progress.txt.