bug-report

Summarize bug descriptions into structured reports with reproduction steps and severity.

70|42|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/tranhieutt/software_development_department --skill bug-report-tranhieutt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-report
Source: https://github.com/tranhieutt/software_development_department/tree/main/.claude/skills/bug-report
Command: npx skills add https://github.com/tranhieutt/software_development_department --skill bug-report-tranhieutt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns scattered bug descriptions into complete, consistent reports so critical details never get lost before triage. It enforces severity, priority, classification, environment, reproduction, and related-file context for every reported defect. It also provides an analyze mode that reads files, spots potential issues, and pairs each finding with triggers and fixes.

Core Features & Use Cases

  • Structured Bug Reports: Produces canonical reports with summary, classification, reproduction steps, environment, evidence, and related systems for every issue.
  • Analysis Workflow: Scans provided files for null references, race conditions, off-by-one bugs, and other defects, then maps findings to likely triggers and recommendations.
  • Use Case: When a tester sends a fuzzy defect description, use this Skill to parse the request, search the repo for relevant files, and deliver a full report ready for engineers.

Quick Start

Describe the bug with expected versus actual behavior, reproduction steps, severity, and context to receive a full structured report.

Frequently Asked Questions about bug-report

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

FAQPage Schema
How do I convert scattered bug descriptions into structured reports for triage?

To convert scattered bug descriptions into structured reports for triage, input the narrative description with expected versus actual behavior. The tool parses the request and outputs a canonical report documenting summary, reproduction steps, severity, and environment.

Can I scan code files to identify potential defects and map them to likely triggers?

You can scan code files to identify potential defects by using the analysis workflow. It spots issues like null references and race conditions, then maps each finding to likely triggers and provides recommended fixes for the identified code defects.

What information do I need to include to generate a complete bug report?

To generate a complete bug report, you need to include the bug description, expected versus actual behavior, reproduction steps, severity, and context. This ensures critical details like classification and related systems are never lost before triage.

Does the generated bug report enforce severity and environment details for every issue?

The generated bug report enforces severity, priority, classification, environment, reproduction, and related-file context for every reported defect. This standardization ensures critical details are consistently documented for engineering teams.

What is the best way to analyze fuzzy defect descriptions from testers?

The best way to analyze fuzzy defect descriptions from testers is to parse the request and search the repository for relevant files. The tool then delivers a full structured report ready for engineers, complete with evidence and suggested fixes.

What types of bugs can the analysis workflow detect in my codebase?

The analysis workflow can detect several types of bugs in your codebase, including null references, race conditions, and off-by-one bugs. It scans provided files to spot potential defects and pairs each finding with targeted recommendations.