skills.rest
kileroppo
kileroppoCOMMUNITY
Explore all skills by this author →
GitHub

ralph

Convert markdown or text PRDs into Ralph-compatible prd.json files.

Updated Aug 27, 2026
Search Tags:#acceptance criteria#user stories#prd#branch naming#prd.json#ralph#autonomous planning
One-click install
npx skills add https://github.com/kileroppo/AI-Coding-Guidance-Skills --skill ralph-kileroppo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/kileroppo/AI-Coding-Guidance-Skills/tree/main/skills/ralph
Command: npx skills add https://github.com/kileroppo/AI-Coding-Guidance-Skills --skill ralph-kileroppo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the manual, error-prone work of translating a product requirements document (PRD) into the specific prd.json structure required by the Ralph autonomous agent system.

Core Features & Use Cases

  • PRD-to-prd.json conversion: Transforms PRD content (markdown or plain text) into Ralph’s prd.json schema for autonomous execution.
  • Story sizing enforcement: Splits or structures user stories so each story is completable within a single Ralph iteration (one context window).
  • Dependency-first ordering and verifiable acceptance criteria: Orders stories by dependency (schema → backend → UI → aggregates) and generates checkable acceptance criteria, including mandatory Typecheck passes and optional test/browser verification guidance.

Quick Start

Use the ralph skill to convert your PRD into prd.json for the Ralph autonomous agent, then save the output into your 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 into a prd.json file for autonomous execution?▼

To convert a markdown PRD into a prd.json file, use this skill to transform plain text or markdown product requirements into a Ralph-compatible schema with project metadata, branch naming, and a sequenced userStories array.

How are user stories sized and ordered when generating a prd.json from a PRD?▼

User stories are sized to be completable within a single Ralph iteration context window and ordered by dependency, sequencing features from schema to backend, then UI, and finally aggregates for autonomous execution.

What acceptance criteria are generated for user stories in prd.json?▼

Generated acceptance criteria are verifiable and include mandatory Typecheck passes, optional test or browser verification guidance, with initial passes set to false and empty notes for autonomous agent tracking.

Does the prd.json conversion include branch naming conventions?▼

Yes, prd.json conversion includes branch naming by deriving a kebab-case ralph/branchName from your PRD, ensuring your autonomous execution branches follow a standardized naming convention.

Can I use plain text PRDs or do I need markdown formatting for prd.json conversion?▼

You can use both plain text and markdown PRDs for prd.json conversion, as the skill processes either format to extract project metadata and generate the structured userStories array required by the Ralph autonomous agent.

Related Skills

Explore More Product & Management Skills→
mseokmseok
5

ralph

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

Community
Intermediate
nrminornrminor

ralph

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

Community
Basic
jellydnjellydn
114

ralph

Convert Markdown or text PRDs into Ralph's prd.json format.

Community
Intermediate
buiphucminhtambuiphucminhtam
47

product-manager

Translate product ideas and business goals into BRDs, user stories, and acceptance criteria.

Community
Advanced