convert-prd-to-json

Convert markdown or text PRDs into structured prd.json user stories.

Updated Jan 17, 2026
One-click install
npx skills add https://github.com/teaglebuilt/aiconfig --skill convert-prd-to-json
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convert-prd-to-json
Source: https://github.com/teaglebuilt/aiconfig/tree/main/.claude/skills/generate-prd-to-json
Command: npx skills add https://github.com/teaglebuilt/aiconfig --skill convert-prd-to-json

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the conversion of Product Requirements Documents (PRDs) into a structured JSON format required by the Ralph autonomous agent system, streamlining the process of translating human-readable requirements into machine-executable tasks.

Core Features & Use Cases

  • PRD to JSON Conversion: Transforms markdown or text-based PRDs into prd.json format.
  • User Story Structuring: Organizes requirements into distinct user stories with titles, descriptions, and verifiable acceptance criteria.
  • Dependency Management: Enforces story ordering based on dependencies and ensures stories are sized for single-iteration completion.
  • Use Case: You have a detailed PRD for a new feature. Use this Skill to convert it into the prd.json format, ensuring each user story is actionable and correctly prioritized for an autonomous agent.

Quick Start

Use the convert-prd-to-json skill to turn this PRD into prd.json format.

Frequently Asked Questions about convert-prd-to-json

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

FAQPage Schema
How do I convert a PRD into JSON for autonomous agents?

To convert a PRD into JSON for autonomous agents, you can use a tool that parses markdown or text documents and structures them into user stories with titles, descriptions, acceptance criteria, and priorities. This creates a machine-executable JSON format designed for systems like Ralph.

What is the JSON format required for autonomous agent systems like Ralph?

The JSON format for autonomous agent systems like Ralph is a structured file containing user stories. Each story includes a title, description, acceptance criteria, and priority, with enforced story size constraints and dependency ordering for efficient single-iteration execution.

How do I structure user stories from a markdown PRD?

Structuring user stories from a markdown PRD involves parsing the text and organizing requirements into distinct stories. The process enforces story size constraints and orders dependencies, ensuring each story is actionable and correctly prioritized for autonomous execution.

Can I use a text-based PRD for autonomous agent task conversion?

Yes, text-based PRDs can be used for autonomous agent task conversion. The conversion process accepts both markdown and text formats, breaking the content down into structured user stories with defined acceptance criteria and priorities.

What is the best way to enforce dependency ordering when converting requirements to JSON?

The best way to enforce dependency ordering when converting requirements to JSON is to use an automated conversion process that parses the PRD and sequences the user stories based on their dependencies. This ensures stories are sized for single-iteration completion by autonomous agents.

Why does autonomous agent execution require sized story constraints in JSON?

Autonomous agent execution requires sized story constraints in JSON to ensure each user story can be completed within a single iteration. Enforcing these size limits and dependency ordering streamlines the translation of human-readable requirements into machine-executable tasks.