ralph

Name: ralph
Availability: InStock
Author: celyousfi

Converts Markdown files to editable ASTN JSON and vice versa with formatting preserved.

Updated Feb 3, 2026

Search Tags:#automation #workflow #AI agent #CLI #PRD #prd.json #ralph

Ready to run

npx skills add https://github.com/CElyousfi/PalntsScanner --skill ralph-celyousfi

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ralph
Source: https://github.com/CElyousfi/PalntsScanner/tree/main/.windsurf/skills/ralph
Command: npx skills add https://github.com/CElyousfi/PalntsScanner --skill ralph-celyousfi

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? Ralph automates translating product requirements into the Ralph-prd.json format and executes user stories using Ralph.

## Core Features & Use Cases

PRD conversion: transform markdown PRDs into prd.json for Ralph
Run Ralph: execute user stories via ./scripts/ralph.sh with tool options
Iteration isolation: spawns a fresh AI instance each pass to ensure clean state

### Quick Start Place a prd.json in the script directory and run:

./scripts/ralph.sh
./scripts/ralph.sh --tool claude 15

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 prd.json format for an AI agent?▼

Ralph converts markdown PRDs into prd.json format for automated AI agent execution. It reads the generated prd.json file directly from the script directory to process user stories across projects.

How do I run user stories autonomously with an AI agent from a prd.json file?▼

Run user stories by placing prd.json in the script directory and executing ./scripts/ralph.sh. You can specify AI tools by passing arguments like --tool claude to execute targeted iterations.

How does Ralph handle AI agent state isolation between workflow iterations?▼

Ralph handles state isolation by spawning a fresh AI instance for every iteration pass. This prevents context bleed between user stories, maintaining a clean processing environment for each execution cycle.

Can I select a specific AI tool when running autonomous user stories?▼

Yes, you can select a specific AI tool when running Ralph by passing the --tool flag to the script. Use ./scripts/ralph.sh --tool claude 15 to specify Claude and define the iteration count.

What is the best way to automate product requirement execution across multiple projects?▼

Automating product requirement execution across projects involves converting PRDs to prd.json and running the Ralph autonomous agent. The system executes user stories across projects while maintaining branch-archiving behavior.