skills.rest
mirandagabrieldev
mirandagabrieldevCOMMUNITY
Explore all skills by this author →
GitHub

bugs-to-stories

Convert bug reports from tasks/bug-report-*.md into prd.json user story objects.

Updated Aug 23, 2026
Search Tags:#automation#prioritization#bugs#bug-fix#bug-tracking#story-generation#prd.json
One-click install
npx skills add https://github.com/mirandagabrieldev/claude-build-template --skill bugs-to-stories-mirandagabrieldev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bugs-to-stories
Source: https://github.com/mirandagabrieldev/claude-build-template/tree/main/skills/bugs-to-stories
Command: npx skills add https://github.com/mirandagabrieldev/claude-build-template --skill bugs-to-stories-mirandagabrieldev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converting scattered bug reports into structured user stories that can be added to prd.json for automated fixing, reducing manual triage and handoffs.

Core Features & Use Cases

  • Converts bug entries from test-and-break reports (BUG-XXX) into standardized stories with id, title, description, acceptance criteria, and priority.
  • Applies a clear mapping from bug data to story fields and calculates priority by severity, preserving project context.
  • Updates or creates prd.json to enable Ralph to autonomously fix issues in order of urgency.

Quick Start

Convert the latest bug reports from tasks/bug-report-*.md into prd.json stories and update the bug-fix backlog.

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 fixing?▼

To convert bug reports into user stories, this Skill reads tasks/bug-report-*.md files, applies mapping rules to transform BUG-XXX entries into FIX-XXX story objects, and updates prd.json with structured id, title, description, acceptance criteria, and priority fields for autonomous resolution.

What is the best way to prioritize bug fixes from test-and-break reports?▼

Prioritizing bug fixes from test-and-break reports is handled by calculating severity-based priority scores during story generation, ensuring the updated prd.json backlog sequences autonomous fixes by urgency rather than manual triage.

Can I generate prd.json stories directly from markdown bug tracking files?▼

Yes, you can generate prd.json stories directly from markdown bug tracking files by reading bug-report-*.md entries, mapping the BUG-XXX data to standardized FIX-XXX story objects, and writing the structured JSON output with acceptance criteria and priority into prd.json.

Do I need an existing prd.json file to map bug reports into story objects?▼

You do not need an existing prd.json file to map bug reports, because this Skill can both update an existing prd.json state and create a new one, integrating the generated FIX-XXX stories while preserving project context and mapping rules.

What bug tracking data is required to generate stories with proper acceptance criteria?▼

Generating stories with proper acceptance criteria requires bug tracking data from tasks/bug-report-*.md files, utilizing title, notes, and severity fields to map BUG-XXX entries into structured FIX-XXX objects with descriptions and priority for the prd.json backlog.

Related Skills

Explore More Software Engineering Skills→
rohunjrohunj
232

bugs-to-stories

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

Community
Advanced
ximingximing

ralph

Convert Product Requirement Documents into structured prd.json for Ralph.

Community
Intermediate
gaiastudio-aigaiastudio-ai
2

gaia-triage-findings

Identify untriaged findings in story files and generate backlog stories with complete frontmatter.

Official
Advanced
liuzhengdongfortestliuzhengdongfortest
1.1k

cs-issue-report

Transform user observations into structured issue reports with standard directory layout.

Community
Intermediate