skills.rest
hasparus
hasparusCOMMUNITY
Explore all skills by this author →
Website𝕏@hasparusGitHub

ralph

Convert markdown PRDs into Ralph's prd.json format.

Updated Jan 12, 2026
Search Tags:#automation#markdown#json#conversion#prd#ralph
One-click install
npx skills add https://github.com/hasparus/claude-skills-dotfiles --skill ralph-hasparus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/hasparus/claude-skills-dotfiles/tree/main/ralph
Command: npx skills add https://github.com/hasparus/claude-skills-dotfiles --skill ralph-hasparus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts existing PRDs into the prd.json format used by Ralph for autonomous execution, enabling seamless handoff from design documents to executable agent instructions.

Core Features & Use Cases

  • PRD parsing and validation to extract title, intro, and key sections from a markdown PRD.
  • Generates a Ralph-compatible prd.json with fields: project, branchName, description, and userStories, ready for integration into the agent workflow.
  • Produces a ready-to-run branch name and descriptive description that reflect the PRD content and intended feature scope.
  • Use Case: Given a PRD titled "Add login with OAuth", convert to a prd.json and prepare a Ralph branch like ralph/add-login-oauth with associated user stories.

Quick Start

Provide a PRD markdown file or pasted text and run the skill to generate a prd.json in the 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 execution?▼

To convert a markdown PRD to JSON, provide the markdown text or file to generate a structured prd.json containing project, branchName, description, and userStories entries suitable for autonomous agent execution.

What is the prd.json format needed for creating Ralph branches and user stories?▼

The prd.json format is a structured JSON schema containing project, branchName, description, and userStories entries, designed to translate markdown PRD content into executable agent instructions for branch creation and metadata generation.

Can I use existing markdown PRD files to generate a structured JSON schema automatically?▼

Yes, existing markdown PRD files can be automatically parsed and validated to extract titles, intros, and key sections, converting them into a typecheckable JSON output with branch names and user stories.

How do I generate a branch name from a PRD for autonomous agent workflows?▼

Generating a branch name from a PRD involves parsing the document's title and feature scope to produce a ready-to-run branch name, such as ralph/add-login-oauth, reflecting the intended PRD content.

Does PRD conversion to JSON require any external dependencies or components?▼

PRD conversion to JSON requires no external dependencies or components, operating independently to perform input parsing, JSON schema generation, and typecheckable output production from the provided markdown text.

What sections are extracted when parsing a markdown PRD for JSON conversion?▼

Parsing a markdown PRD for JSON conversion extracts the document's title, introduction, and key sections to populate the project, branchName, description, and userStories fields in the final JSON output.

Related Skills

Explore More Software Engineering Skills→
MeechYourGoalsMeechYourGoals
2

ralph

Convert PRD markdown files into Ralph's prd.json format.

Community
Intermediate
CElyousfiCElyousfi

ralph

Converts Markdown files to editable ASTN JSON and vice versa with formatting preserved.

Community
Advanced
AlejandroFiginiAlejandroFigini

ralph

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

Community
Intermediate
anis-marrouchianis-marrouchi
4

prd-to-json

Convert PRD Markdown into a structured JSON schema for Ralf execution.

Community
Intermediate