skills.rest
polsegu
polseguCOMMUNITY
Explore all skills by this author →
Website𝕏@Polsegu11GitHub

bug-report

Create structured bug reports from natural-language descriptions and project files.

Updated Apr 10, 2026
Search Tags:#qa#verify#code-analysis#triage#reproduction-steps#bug#bug-report
One-click install
npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill bug-report-polsegu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bug-report
Source: https://github.com/polsegu/Claude-Code-Game-Dev/tree/main/.claude/skills/bug-report
Command: npx skills add https://github.com/polsegu/Claude-Code-Game-Dev --skill bug-report-polsegu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Unstructured or vague bug descriptions slow down triage, cause flaky fixes, and leave QA without clear reproduction steps or context. This Skill converts informal reports or code observations into complete, reproducible bug reports with severity, priority, environment, and likely affected files to accelerate debugging and resolution.

Core Features & Use Cases

  • Structured Bug Reports: Produces a full bug report template including summary, reproduction steps, environment, severity, likely root cause, and related files.
  • Analyze Code for Bugs: Reads specified files to identify null references, off-by-one errors, race conditions, and other likely defects and drafts reports with recommended fixes.
  • Verify & Close Workflows: Verifies fixes by re-checking code paths and running available tests, and appends closure records when verified.
  • Use Case: During a playtest, convert a player's description of a crash into a reproducible bug report, locate the likely source files, verify a patch, and close the bug once tests pass.

Quick Start

Create a structured bug report from the description 'Player falls through floor when jumping' and propose reproduction steps.

Frequently Asked Questions about bug-report

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

FAQPage Schema
How do I convert a natural language bug description into a structured bug report?▼

To convert a natural language bug description into a structured bug report, the skill parses your text to draft reproduction steps, severity and priority assessments, likely affected files, and verification checks. It transforms vague observations into complete, reproducible QA markdown bug reports.

Can I analyze project files to identify defects and generate bug reports?▼

Yes, you can analyze project files to identify defects and generate bug reports. The skill reads specified files using Grep and Glob to detect null references, off-by-one errors, and race conditions, then drafts reports with recommended fixes and likely root causes.

What is the best way to create reproduction steps for a game development crash?▼

The best way to create reproduction steps for a game development crash is to provide the skill with the player's description. It applies to game development repositories to draft clear reproduction steps, locate likely source files, and propose verification checks for the bug.

Does this bug triage tool run related tests during the verification workflow?▼

Yes, this bug triage tool runs related tests during the verification workflow. It verifies fixes by re-checking code paths and running available tests, then optionally writes or updates production and QA markdown bug files with closure records when verified.

How do I assess severity and priority for a newly reported bug?▼

To assess severity and priority for a newly reported bug, the skill evaluates the natural-language description or code analysis results. It generates a full bug report template that includes structured severity and priority assessments alongside environment details and likely root causes.

Related Skills

Explore More Software Engineering Skills→
LangConfigLangConfig
55

code-review

Review code across organization, security, performance, and maintainability criteria.

Official
Intermediate
jaisonerickjaisonerick

fix-bugs

Reproduce QA-reported failures with failing tests and apply minimal code fixes.

Community
Advanced
lexicalninjalexicalninja
2

bug-detector

Detect bugs, logic errors, and edge cases across codebases with structured reports.

Community
Advanced
clawpod-appclawpod-app
46

bug-report

Generate structured bug reports with reproduction steps and severity assessments.

Community
Intermediate