skills.rest
rohunj
rohunjCOMMUNITY
Explore all skills by this author →
Website𝕏@rohunjauharGitHub

bugs-to-stories

Convert bug reports into user stories and update prd.json.

232|38|Updated Jan 18, 2026
Search Tags:#automation#workflow#prd#stories#bug-tracking#bug#ralph
One-click install
npx skills add https://github.com/rohunj/claude-build-workflow --skill bugs-to-stories
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bugs-to-stories
Source: https://github.com/rohunj/claude-build-workflow/tree/main/skills/bugs-to-stories
Command: npx skills add https://github.com/rohunj/claude-build-workflow --skill bugs-to-stories

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts raw bug reports into structured, reproducible user stories that can be added to prd.json for automated fixes with Ralph.

Core Features & Use Cases

  • Converts each bug entry from bug-report-*.md into a standardized story object with fields like id, title, description, acceptance criteria, priority, and notes.
  • Updates or creates prd.json to include the new stories and maintain proper project context and branch naming for the Ralph workflow.
  • Handles prioritization mapping and guidance on proceeding with automation, including how to choose between appending to an existing prd.json or creating a dedicated bug-fix PRD.

Quick Start

Use the tool to feed bug reports into automated stories and integrate them into prd.json for Ralph to execute.

Frequently Asked Questions about bugs-to-stories

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

FAQPage Schema
How do I convert bug reports into user stories for automated fixes?▼

This Skill converts raw bug reports into structured user stories by reading files matching the bug-report-*.md pattern and mapping each entry into a story with id, title, description, acceptance criteria, priority, and notes.

What is the best way to generate acceptance criteria from bug reports?▼

Generating acceptance criteria from bug reports involves parsing raw markdown bug descriptions and mapping them into standardized story objects with defined criteria, priorities, and contextual notes for inclusion in your project requirements.

How does integrating bug-fix stories into prd.json work?▼

Integrating bug-fix stories into prd.json works by either appending the newly generated story objects to an existing prd.json file or creating a new dedicated bug-fix prd.json to maintain proper project context and branch naming for Ralph workflows.

Can I use formatted markdown bug reports to update my PRD workflow?▼

Yes, you can use formatted markdown bug reports to update your PRD workflow. The tool processes tasks/bug-report-*.md files, extracts the bug details, and automatically updates your prd.json with properly formatted stories.

Do I need an existing prd.json file to process bug tracking automation?▼

You do not need an existing prd.json file to process bug tracking automation. The tool provides guidance on creating a new dedicated bug-fix prd.json if one does not exist, or appending stories to your current file.

Related Skills

Explore More Software Engineering Skills→
jMertajMerta
130

bug-triage

Convert ambiguous bug reports into reproducible repros, root-cause explanations, and minimal fixes.

Community
Advanced
gannonhgannonh
1

ralph

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

Community
Advanced
ArabelaTsoArabelaTso
142

issue-report-generator

Generate structured Markdown issue reports from failing test cases.

Community
Intermediate
jellydnjellydn
114

ralph

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

Community
Intermediate