skills.rest
seekayel
seekayelCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

groom-project

Convert markdown PRDs into Ralph-compatible prd.json with user stories.

Updated Dec 18, 2025
Search Tags:#automation#branching#PRD#prd.json#ralph#story-splitting#grooming
One-click install
npx skills add https://github.com/seekayel/agent-skills --skill groom-project
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: groom-project
Source: https://github.com/seekayel/agent-skills/tree/main/plugins/ralph-plugin/groom-project
Command: npx skills add https://github.com/seekayel/agent-skills --skill groom-project

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates converting an existing project PRD into Ralph's prd.json format, enabling structured, testable work items for autonomous agents.

Core Features & Use Cases

  • PRD grooming: transform markdown PRDs into Ralph-compatible JSON with standardized fields.
  • Storyboarding: split large PRDs into discrete Ralph user stories following the one-iteration constraint.
  • Branching and versioning: derive a ralph/ branch name from the project and feature name.
  • Validation: ensure Typecheck passes and tests where applicable; provide guidance per Ralph workflow.

Quick Start

Use the groom-project skill to convert a markdown PRD titled "Task Status Feature" into a prd.json in the Ralph workflow (branch ralph/task-status).

Frequently Asked Questions about groom-project

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

FAQPage Schema
How do I convert a markdown PRD into prd.json for Ralph autonomous execution?▼

Converting a markdown PRD into prd.json requires transforming project briefs into Ralph-compatible JSON with standardized fields, ensuring each story represents one iteration with verifiable acceptance criteria and test guidance.

How do I split a large project brief into small testable Ralph user stories?▼

Splitting large PRDs into Ralph user stories involves breaking the document into discrete iterations that enforce the one-iteration constraint, generating verifiable acceptance criteria with Typecheck and Tests guidance for autonomous agent execution.

What is PRD grooming for autonomous agent workflows?▼

PRD grooming for autonomous agent workflows is the process of transforming plain text project briefs into structured JSON that enforces required schemas, enabling autonomous agents to execute testable work items under a dedicated branch.

Does Ralph require a specific branch naming convention for prd.json files?▼

Ralph requires organizing work under a ralph/ branch name derived from the project and feature name, ensuring the generated prd.json is correctly versioned and structured for the autonomous agent workflow.

How to ensure Typecheck passes and tests are included when converting PRDs to Ralph format?▼

Ensuring Typecheck passes and tests are included requires validating the converted prd.json against Ralph's required schema, producing verifiable acceptance criteria with explicit Typecheck and Tests guidance for each user story iteration.

Can I use plain text project briefs as input for Ralph story splitting?▼

Plain text project briefs can be used as input for Ralph story splitting, where the grooming process transforms them into standardized prd.json files with discrete user stories and verifiable acceptance criteria.

Related Skills

Explore More Product & Management Skills→
sixtycat2000-ctrlsixtycat2000-ctrl

ralph

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

Community
Basic
CuriouslyCoryCuriouslyCory

ralph

Convert PRD markdown into Ralph prd.json with user stories and acceptance criteria.

Community
Intermediate
jellydnjellydn
114

ralph

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

Community
Intermediate
grenosgrenos

ralph

Convert Markdown PRDs into Ralph's prd.json format with validated stories.

Community
Advanced