skills.rest
battyejp
battyejpCOMMUNITY
Explore all skills by this author →
GitHub

ralph

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

Updated Jan 14, 2026
Search Tags:#automation#branch management#PRD#conversion#story generation#prd.json#Ralph
One-click install
npx skills add https://github.com/battyejp/amp-ralph-api --skill ralph-battyejp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/battyejp/amp-ralph-api/tree/main/skills/ralph
Command: npx skills add https://github.com/battyejp/amp-ralph-api --skill ralph-battyejp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Ralph PRD Converter automates turning a product requirements document (PRD) into a Ralph-compatible prd.json, enabling autonomous execution of feature work without manual translation.

Core Features & Use Cases

  • Converts a PRD (markdown text or file) into Ralph's prd.json with branchName, description, and userStories.
  • Enforces one-story-per-iteration sizing and generates verifiable acceptance criteria.
  • Use case: Given a PRD, generate a prd.json ready for Ralph to execute in successive iterations.

Quick Start

Use the ralph skill to convert a PRD file at tasks/prd-<feature>.md into prd.json.

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 for autonomous execution?▼

To convert a markdown PRD into a prd.json, the skill transforms your text into a Ralph-ready plan with branchName, description, and userStories. It outputs a compliant JSON structure with sequential US-001 style IDs and verifiable acceptance criteria.

What format should acceptance criteria follow when generating user stories from a PRD?▼

Acceptance criteria generated from a PRD must be verifiable and explicitly include the condition 'Code builds and tests pass'. The PRD converter enforces this alongside sequential US-001 style IDs for each generated user story.

Can I use plain text PRDs to generate a branch management plan with user stories?▼

Yes, you can use plain text PRDs to generate a branch management plan. The converter accepts both markdown and plain text, transforming the content into a prd.json with a proper branchName and structured user stories.

How do you structure user stories in prd.json for iterative feature development?▼

User stories in prd.json are structured for iterative feature development by enforcing one-story-per-iteration sizing. The converter generates sequential US-001 style IDs to ensure each story is ready for successive autonomous execution.

What is the best way to prepare a PRD file for Ralph autonomous execution?▼

The best way to prepare a PRD for Ralph autonomous execution is placing your markdown file at tasks/prd-<feature>.md. The skill processes this input to automatically generate a Ralph-ready prd.json with all required branch and story attributes.

Does the PRD converter require specific dependencies to output prd.json?▼

No specific dependencies are required to output prd.json, as the skill operates independently. It directly processes your existing markdown or plain text PRD to produce the compliant JSON format for Ralph.

Related Skills

Explore More Product & Management Skills→
mseokmseok
5

ralph

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

Community
Intermediate
MeroZemoryMeroZemory
28

ralph-init

Structure product requirements into user stories with acceptance criteria and priority ordering.

Community
Intermediate
AnveioAnveio
1

task-pull-request

Automate GitHub pull request creation, reviews, feedback, and merges via gh CLI.

Community
Intermediate
nrminornrminor

ralph

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

Community
Basic