ralph

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

1|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/danzam98/claude-skills-toolkit --skill ralph-danzam98
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/danzam98/claude-skills-toolkit/tree/main/skills/ralph
Command: npx skills add https://github.com/danzam98/claude-skills-toolkit --skill ralph-danzam98

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converting Product Requirements Documents (PRDs) into Ralph's prd.json format is often manual and error-prone. This skill automates the transformation, enabling a clean, machine-readable representation for the Ralph agent system.

Core Features & Use Cases

  • Transforms a PRD (markdown or text) into a Ralph-compatible prd.json structure, including project, branchName, description, and userStories.
  • Generates a branch name from the PRD title or feature name in kebab-case to align with versioning workflows.
  • Produces a ready-to-run JSON payload with properly structured user stories and acceptance criteria for downstream automation and testing.
  • Validates required fields and provides a clear skeleton for iterative refinement.

Quick Start

Provide a PRD as text and run the skill to generate prd.json in your 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 markdown PRD to JSON for autonomous agent execution?

Converting a markdown PRD to JSON for autonomous agent execution involves parsing the text to generate a Ralph-compatible prd.json structure. The output includes project details, branchName, description, and structured user stories with US-001 style entries for downstream automation.

What is the Ralph prd.json format and how does it structure user stories?

The Ralph prd.json format is a machine-readable structure containing project, branchName, description, and userStories arrays. It organizes user stories using US-001 style entries to ensure the output adheres to conversion rules and is ready for downstream validation and testing.

How do I generate a kebab-case branch name from a PRD title for version control?

Generating a kebab-case branch name from a PRD title for version control is handled automatically during the PRD conversion process. It derives the branch name from the PRD title or feature name to align the prd.json output with versioning workflows.

Can I use plain text PRDs to generate structured JSON for automated testing?

Yes, you can use plain text PRDs to generate structured JSON for automated testing. The conversion accepts both Markdown and plain text inputs, producing a ready-to-run JSON payload with properly structured user stories and acceptance criteria for the Ralph agent system.

What are the limitations of automating PRD to JSON conversion for autonomous agents?

Limitations of automating PRD to JSON conversion include relying on input text clarity to accurately generate user stories and acceptance criteria. The output serves as a validated skeleton that may require iterative refinement to fully meet complex downstream automation requirements.