skills.rest
KwaminaWhyte
KwaminaWhyteCOMMUNITY
Explore all skills by this author →
Website𝕏@KwaminaWhyteGitHub

ralph

Convert Markdown PRDs into a normalized prd.json schema.

4|Updated Dec 26, 2025
Search Tags:#automation#requirements#json#conversion#prd#prds#ralph
One-click install
npx skills add https://github.com/KwaminaWhyte/rivetr --skill ralph-kwaminawhyte
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/KwaminaWhyte/rivetr/tree/main/.claude/skills/ralph
Command: npx skills add https://github.com/KwaminaWhyte/rivetr --skill ralph-kwaminawhyte

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converting structured PRDs into a standardized prd.json format enables Ralph to autonomously plan and execute work from requirements documents without manual rework.

Core Features & Use Cases

  • PRD to prd.json conversion: standardizes inputs for Ralph's workflow by extracting title, goals, acceptance criteria, and user stories.
  • Markdown compatibility: accepts PRDs written in Markdown or plain text and outputs a deterministic prd.json at scripts/ralph/prd.json.
  • Versioning and workflow support: aligns with Ralph branch naming and project structure to ensure reproducible deployments.

Quick Start

Provide a PRD Markdown file to the tool; it will generate scripts/ralph/prd.json ready for Ralph ingestion.

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 in Markdown to a JSON format for autonomous agents?▼

To convert a PRD in Markdown to JSON, provide the Markdown file to the tool to extract titles, goals, and user stories into a normalized prd.json schema. This output enforces a consistent structure for downstream autonomous agent ingestion.

What is the required structure for a prd.json file?▼

The required structure for a prd.json file includes specific keys like project, branchName, description, and userStories. This schema enforces deterministic inputs for autonomous workflow execution and branch naming conventions.

Can I use plain text PRDs or does the conversion require strict Markdown formatting?▼

PRD to prd.json conversion accepts both Markdown and plain text PRD documents. It extracts titles, goals, acceptance criteria, and user stories from varying document structures to produce a consistent JSON schema.

How do I generate a prd.json file ready for Ralph ingestion?▼

To generate a prd.json file ready for Ralph ingestion, provide your PRD Markdown file to the conversion tool. It outputs the standardized JSON directly to scripts/ralph/prd.json, aligning with Ralph branch naming and project structure.

Does the prd.json conversion support versioning and project branch naming conventions?▼

The prd.json conversion supports versioning and workflow by aligning with Ralph branch naming and project structure. This ensures reproducible deployments from the extracted requirements.

What happens if my PRD document has an inconsistent structure or missing user stories?▼

The conversion tool applies to PRD documents of varying length and structure, extracting available titles, goals, and user stories. It normalizes these inputs to enforce the required JSON structure for downstream tooling.

Related Skills

Explore More Product & Management Skills→
richardwurichardwu
2

prd

Generate structured markdown PRDs with user stories and acceptance criteria.

Community
Intermediate
nrminornrminor

ralph

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

Community
Basic
crsieblercrsiebler
1

ralph

Convert markdown or text PRDs into Ralph's prd.json schema.

Community
Intermediate
xchang1121xchang1121
6

performance-summary

Aggregate performance metrics from verify_<op_name>/result.json files across operators.

Community
Intermediate