create-json-prd

Convert PRD markdown files into structured JSON for Ralph AI.

5|Updated Oct 22, 2025
One-click install
npx skills add https://github.com/marchatton/agent-skills --skill create-json-prd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-json-prd
Source: https://github.com/marchatton/agent-skills/tree/main/.agents/skills/02-shape/create-json-prd
Command: npx skills add https://github.com/marchatton/agent-skills --skill create-json-prd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the conversion of Product Requirements Documents (PRDs) written in Markdown into a structured JSON format that can be processed deterministically by the Ralph AI.

Core Features & Use Cases

  • Markdown to JSON Conversion: Ingests PRD markdown files and outputs a precisely structured JSON file.
  • Deterministic Output: Ensures PRDs are machine-readable and consistent for AI processing.
  • Use Case: A product manager writes a new feature specification in prd.md. This Skill converts it into prd.json, which Ralph can then use to generate user stories, plan development tasks, and define quality gates.

Quick Start

Use the create-json-prd skill to convert the file 'prd.md' into a JSON PRD.

Frequently Asked Questions about create-json-prd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert a markdown PRD to JSON format for AI processing?

To convert a markdown PRD to JSON, this Skill ingests your markdown file and extracts project overview, goals, success metrics, stack, routes, data model, rules, quality gates, and user stories into a structured, deterministic JSON output.

What is a JSON PRD and when do I need structured product requirements?

A JSON PRD is a machine-readable, structured representation of product requirements. You need it when a deterministic AI like Ralph must parse your markdown specifications to generate user stories, plan development tasks, and define quality gates.

Can I generate a JSON PRD from a markdown file with non-standard naming conventions?

Yes, you can generate a JSON PRD from markdown files with various naming conventions. The Skill supports flexible input naming and optional shaping inputs to extract all necessary details into a structured JSON output.

What happens if my markdown PRD is missing required details for JSON generation?

When your markdown PRD is underspecified, the Skill handles missing inputs by invoking an auxiliary skill to ask clarifying questions, ensuring the final JSON output contains all necessary project details and specifications.

Does the JSON PRD generation process include success metrics and data models?

Yes, the JSON PRD generation process includes success metrics, data models, routes, stack information, non-goals, rules, quality gates, and user stories extracted directly from your existing markdown product requirements document.

What's the best way to automate product documentation conversion for Ralph AI?

The best way to automate product documentation conversion for Ralph AI is using this Skill to transform markdown PRD files into a precisely structured JSON format, ensuring consistent and deterministic machine-readable output for downstream AI processing.