Agent skill · software engineering · snarktank
ralph
Convert PRDs to prd.json format for the Ralph autonomous agent system. Use when you have an existing PRD and need to convert it to Ralph's JSON format. Triggers on: convert this prd, turn this into ralph format, create prd.json from this, ralph json.
Why this skill is useful
Adds a script that automates the conversion of PRDs to a specific JSON format for the Ralph system, which is not commonly available in public documentation.
What it needs
Requires ralph installed locally. About 4k tokens when loaded. Last updated 2026-02-02. 21,397 stars on the source repository.
What this skill does
Ralph PRD Converter Converts existing PRDs to the prd.json format that Ralph uses for autonomous execution. --- The Job Take a PRD (markdown file or text) and convert it to prd.json in your ralph directory. --- Output Format --- Story Size: The Number One Rule Each story must be completable in ONE Ralph iteration (one context window). Ralph spawns a fresh Amp instance per iteration with no memory of previous work. If a story is too big, the LLM runs out of context before finishing and produces broken code. Right-sized stories: Add a database column and migration Add a UI component to an existing page Update a server action with new logic Add a filter dropdown to a list Too big (split these): "Build the entire dashboard" - Split into: schema, queries, UI components, filters "Add authentication" - Split into: schema, middleware, login UI, session handling "Refactor the API" - Split into one story per endpoint or pattern Rule of thumb: If you cannot describe the change in 2-3 sentences, it is too big. --- Story Ordering: Dependencies First Stories execute in priority order. Earlier stories must not depend on later ones. Correct order: 1. Schema/database changes (migrations) 2. Server actions / backend logic 3. UI components that use the backend 4. Dashboard/summary views that aggregate data Wrong order: 1. UI component (depends on schema that does not exist yet) 2. Schema change --- Acceptance Criteria: Must Be Verifiable Each criterion must be something Ralph can CHECK, not something vague. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills snarktank/ralph--182ca8