bug-report

Creates structured bug reports with reproduction steps, severity assessment, and verification workflows.

13|Updated Jul 30, 2026
One-click install
npx skills add https://github.com/frabcd/codex-ai-game-studio --skill bug-report-frabcd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-report
Source: https://github.com/frabcd/codex-ai-game-studio/tree/main/plugins/ai-game-studio/skills/bug-report
Command: npx skills add https://github.com/frabcd/codex-ai-game-studio --skill bug-report-frabcd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing consistent, actionable bug reports is tedious and often results in missing reproduction steps, unclear severity, or lost context. This Skill standardizes the entire bug lifecycle—from initial report through verification and closure—so every defect is documented with full technical context. ## Core Features & Use Cases - Structured Report Generation: Turns a plain-language bug description into a complete report with severity, priority, environment, reproduction steps, and likely affected files found via codebase search. - Code Analysis Mode: Scans target files to identify potential bugs such as null references, off-by-one errors, race conditions, and resource leaks, generating a report for each finding. - Verify and Close Workflow: Re-runs reproduction steps and related tests to confirm fixes, then writes closure records with resolution details and regression test references. - Use Case: A QA tester describes a crash when opening the inventory screen. The Skill searches the codebase, drafts a BUG-0042 report with reproduction steps and suspected files, saves it to production/qa/bugs/, and later verifies the fix before closing it. ## Quick Start Use the bug-report skill to create a structured bug report for the crash that happens when opening the inventory screen after loading a saved game.

Frequently Asked Questions about bug-report

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

FAQPage Schema
How do I write a good bug report with reproduction steps?

Provide a plain description of what broke, when, and the expected behavior. The Skill parses it, searches the codebase for affected files, and drafts a report with severity, environment, exact reproduction steps, and expected versus actual results.

How to find potential bugs in code automatically?

Use analyze mode with a target file path. The Skill reads the code and flags null references, off-by-one errors, race conditions, unhandled edge cases, resource leaks, and incorrect state transitions, generating a bug report for each finding.

Can I verify a bug fix before closing the ticket?

Yes, verify mode re-runs the reproduction steps, checks whether the root cause code path still exists, runs related tests, and greps for regressions. It returns VERIFIED FIXED, STILL PRESENT, or CANNOT VERIFY before any status change.

Where are bug reports saved and in what format?

Reports are saved as Markdown files in production/qa/bugs/ with names like BUG-0042.md. Each file contains summary, classification, environment, reproduction steps, technical context, evidence, and closure records.

What happens if a bug fix does not verify?

If verification returns STILL PRESENT, the bug is reopened with status set back to Open, and the Skill suggests running the hotfix workflow. A bug cannot be closed until it reaches Verified Fixed status.