ralph

Convert Product Requirements Documents into Ralph v2 story specifications and queue files.

4|1|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/becerra-alberto/ralphetamine --skill ralph-becerra-alberto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/becerra-alberto/ralphetamine/tree/main/skills
Command: npx skills add https://github.com/becerra-alberto/ralphetamine --skill ralph-becerra-alberto

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the conversion of a Product Requirements Document (PRD) into structured story specifications that the Ralph v2 autonomous development loop can execute, streamlining the path from idea to implementation.

Core Features & Use Cases

  • PRD Analysis: Reads and understands a PRD to identify epics and individual stories.
  • Spec Generation: Creates detailed Markdown spec files for each story, including acceptance criteria and technical context.
  • Queue Creation: Generates a .ralph/stories.txt file to define the execution order and batching for Ralph.
  • Use Case: You have a new feature defined in a PRD. This Skill breaks it down into manageable, executable stories for Ralph, saving significant manual planning time.

Quick Start

Use the ralph skill to convert the PRD file located at tasks/prd-user-auth.md into Ralph story specs.

Frequently Asked Questions about ralph

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

FAQPage Schema
How do I convert a PRD into development stories for automated execution?

You can convert a PRD into Ralph v2 story specifications by triggering the specific PRD conversion commands. The Skill processes the PRD, breaks it down into executable stories with acceptance criteria, and outputs Markdown spec files alongside a `.ralph/stories.txt` queue.

What is a Ralph v2 story specification?

Ralph v2 story specifications are detailed Markdown files that define epics, individual stories, and dependencies extracted from a PRD. They include acceptance criteria and technical context to guide the autonomous development loop.

Can I generate a story queue from a markdown PRD file?

Yes, this Skill generates a `.ralph/stories.txt` queue file from your markdown PRD. It analyzes the document to define the execution order and batching for Ralph, creating a structured queue for the autonomous development loop.

Does the PRD to story generation process support dependency mapping?

Yes, the Skill analyzes PRD content to define dependencies between epics and stories. It uses these dependencies to generate a `.ralph/stories.txt` queue file that accurately defines the execution order and batching for the Ralph v2 loop.

What format are the generated story specs written in?

Story specs are generated as Markdown files. Each file contains detailed acceptance criteria and technical context for an individual story, providing the structured documentation needed for the Ralph v2 autonomous development loop.