skills.rest
CElyousfi
CElyousfiCOMMUNITY
Explore all skills by this author →
GitHub

ralph

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
One-click install
npx skills add https://github.com/CElyousfi/PalntsScanner --skill ralph-celyousfi
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
snarktanksnarktank
21.4k

ralph

Convert Markdown PRDs into Ralph-compatible prd.json files.

Community
Intermediate
gannonhgannonh
1

ralph

Convert PRDs into prd.json and execute user stories with Ralph.

Community
Advanced
photonics-dhlphotonics-dhl

hermes-agent

Guide Hermes Agent setup, CLI usage, and gateway integration.

Community
Advanced
vibery-studiovibery-studio
3

spec-writer

Translate vague conversations into structured software specifications with user stories and acceptance criteria.

Official
Advanced