ralph

Convert Markdown PRDs into Ralph Audit prd.json schema with stories.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/sebastianspicker/rae --skill ralph-sebastianspicker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/sebastianspicker/rae/tree/main/packages/loops/ralph/skills/ralph
Command: npx skills add https://github.com/sebastianspicker/rae --skill ralph-sebastianspicker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill converts a Markdown PRD into the Ralph Audit prd.json schema to enable deterministic audit, linting, and fixing workflows for reliable product development.

Core Features & Use Cases

  • Converts a Markdown PRD into a complete prd.json with schema_version, project, defaults, and stories.
  • Each story includes mode, scope, acceptance_criteria, steps, verification, and out_of_scope; and all stories have passes set to false.
  • Supports end-to-end workflow from PRD capture to production-ready audit artifacts, including schema validation via Ralph tests.

Quick Start

Provide your Markdown PRD to the Ralph converter to generate the prd.json artifact in the Ralph template folder.

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 into an audit JSON schema?

To convert a Markdown PRD into an audit JSON schema, provide the Markdown file to the Ralph converter, which generates a prd.json artifact containing schema_version, project, defaults, and stories for deterministic linting workflows.

What is the Ralph prd.json schema used for in product management?

The Ralph prd.json schema is used to enable deterministic audit, linting, and fixing workflows for reliable product development by structuring Markdown PRDs into a validated JSON format with defaults and stories.

How do I generate a prd.json file from Markdown for automated linting?

To generate a prd.json file for automated linting, input your Markdown PRD into the Ralph converter to produce a structured JSON artifact where all stories have passes set to false and include scope, acceptance criteria, and verification steps.

Can I use Ralph to lint Markdown product requirements documents automatically?

Yes, you can lint Markdown product requirements documents automatically by converting them into the Ralph Audit prd.json schema, which applies schema validation and sets up stories for deterministic audit and fixing tasks.

Does the Ralph converter validate Markdown PRDs against a specific JSON schema?

Yes, the Ralph converter validates Markdown PRDs against the Ralph schema, producing a prd.json artifact with a schema_version, project block, defaults, and stories that all have passes set to false for subsequent audit workflows.

What limitations apply when converting Markdown PRDs to the Ralph audit schema?

When converting Markdown PRDs to the Ralph audit schema, all generated stories have passes set to false initially, requiring downstream audit, linting, and fixing tasks to verify acceptance criteria, scope, and verification steps.