Agent skill

Bugs To Stories

by rohunj in rohunj/claude-build-workflow

Convert bug reports into prd.json user stories for autonomous fixing.

No licenceAuto-check passedProduct & Project Management

Install Bugs To Stories

skills CLI
$ npx skills add rohunj/claude-build-workflow --skill bugs-to-stories -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rohunj/claude-build-workflow bugs-to-stories --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rohunj/claude-build-workflow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/bugs-to-stories .claude/skills/bugs-to-stories && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
bugs-to-stories
GitHub stars
231
Token cost
~1.4k tokens
SKILL.md length
316 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
None found

At a glance

Convert bug reports into prd.json user stories for autonomous fixing.

  • Works in 6 steps: Read Bug Report → Check Existing prd.json → Decide Integration Strategy → …
  • : convert bugs to stories
  • SKILL.md covers The Job, Conversion Rules, Process and Example Conversion, plus 1 more section
  • Calls jq

What it does

Bugs To Stories is an agent skill from rohunj/claude-build-workflow. Convert bug reports into prd.json user stories for autonomous fixing. Use after running test-and-break skill. Triggers on: convert bugs to stories, fix these bugs, add bugs to prd, create fix stories.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering PRD writing, QA and bug reports and User stories. The repository describes itself as: Automated workflow for building apps with Claude Code. Describe what you want, answer questions, let it build autonomously.

When your agent uses it

  • : convert bugs to stories
  • Add bugs to prd
  • Create fix stories

Example prompts

  • “/bugs-to-stories”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Read Bug Report
  2. Check Existing prd.json
  3. Decide Integration Strategy
  4. Generate Stories
  5. Update prd.json
  6. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit 91f884e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Bugs To Stories loads about 1.4k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 316 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~54
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 316 words (~1,418 tokens).

“Takes bug reports from the test-and-break skill and converts them into properly formatted user stories that can be added to prd.json for Ralph to fix autonomously.”

— opening of SKILL.md by rohunj
name
bugs-to-stories

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/bugs-to-stories of rohunj/claude-build-workflow.

Open the folder on GitHubat commit 91f884e

Compare with similar skills

Bugs To Stories next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Bugs To Stories compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bugs To Stories this skillrohunj/claude-build-workflow231—~1.4kAutomated safety check: PassNone
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT
Ralph Tui Create JSONsubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
To Prdywwynm/EverythingDone14411 repos~777Automated safety check: PassGPL-3.0
Use Case Writerphucnt-bazone-vietnam/use-case-writer143—~4.1kAutomated safety check: PassMIT

Similar skills

  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed
  • Ralph Tui Create JSON

    subsy/ralph-tui

    Convert PRDs to prd.json format for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • To Prd

    ywwynm/EverythingDone

    Turn the current conversation context into a PRD and publish it to the project issue tracker.

    144 GitHub starsUsed in 11 repos~777 tokens
    Product & Project ManagementAuto-check passed
  • Use Case Writer

    phucnt-bazone-vietnam/use-case-writer

    Generate Use Case specifications in English Markdown following the IT BA standard 13-field template (Karl Wiegers / IIBA).

    143 GitHub stars~4.1k tokensUpdated 4 mo ago
    Product & Project ManagementAuto-check passed
  • Project Planner

    adrianpuiu/claude-skills-marketplace

    Comprehensive project planning and documentation generator for software projects.

    100 GitHub starsUsed in 1 repo~6k tokens
    Product & Project ManagementAuto-check passed

More from rohunj/claude-build-workflow

  • Ralph

    rohunj/claude-build-workflow

    Convert PRDs to prd.json format for the Ralph autonomous agent system.

    231 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Compound Engineering

    rohunj/claude-build-workflow

    Compound Engineering workflow for AI-assisted development. An agent skill from rohunj/claude-build-workflow.

    231 GitHub stars~2.1k tokensUpdated 8 mo ago
    Auto-check passed
  • Edge Cases

    rohunj/claude-build-workflow

    Analyze a PRD for edge cases, failure modes, and scenarios that might be missed.

    231 GitHub stars~1.5k tokensUpdated 8 mo ago
    Auto-check passed
  • Story Quality

    rohunj/claude-build-workflow

    Review user stories for quality, proper sizing, sequencing, and acceptance criteria.

    231 GitHub stars~1.7k tokensUpdated 8 mo ago
    Auto-check passed
  • Test And Break

    rohunj/claude-build-workflow

    Autonomous testing skill that opens a deployed app, goes through user flows, tries to break things, and writes detailed bug reports.

    231 GitHub stars~1.6k tokensUpdated 8 mo ago
    Auto-check passed

Questions about Bugs To Stories

What does Bugs To Stories do?

Convert bug reports into prd.json user stories for autonomous fixing. Bugs To Stories is an agent skill from rohunj/claude-build-workflow.json user stories for autonomous fixing.

When should I use Bugs To Stories?

Bugs To Stories fits situations like: : convert bugs to stories; add bugs to prd; create fix stories.

How do I install Bugs To Stories in Claude Code?

Run `npx skills add rohunj/claude-build-workflow --skill bugs-to-stories -a claude-code`. Or copy the skill folder (skills/bugs-to-stories in rohunj/claude-build-workflow) into .claude/skills/bugs-to-stories in your project. Claude Code loads it when a task matches its description.

How do I install Bugs To Stories in Codex?

Run `npx skills add rohunj/claude-build-workflow --skill bugs-to-stories -a codex`. Or copy the skill folder (skills/bugs-to-stories in rohunj/claude-build-workflow) into .agents/skills/bugs-to-stories in your project. Codex loads it when a task matches its description.

Can I use Bugs To Stories in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rohunj/claude-build-workflow --skill bugs-to-stories -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bugs-to-stories, .gemini/skills/bugs-to-stories, .github/skills/bugs-to-stories and .opencode/skills/bugs-to-stories in your project.

What does Bugs To Stories need to run?

Going by SKILL.md and its folder, Bugs To Stories needs the command-line tools its instructions call (jq).

Does Bugs To Stories access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Bugs To Stories safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Bugs To Stories use?

No licence was found for Bugs To Stories or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Bugs To Stories use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Bugs To Stories?

Skills that share tags, products or a category with Bugs To Stories: Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Ralph Tui Create Beads Rust (subsy/ralph-tui, 2.5k stars), Ralph Tui Create JSON (subsy/ralph-tui, 2.5k stars) and To Prd (ywwynm/EverythingDone, 144 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bugs To Stories?

rohunj (a GitHub user) maintains it in rohunj/claude-build-workflow, which has 231 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on January 18, 2026.

Source: rohunj/claude-build-workflow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.