Skills

Bug Report

Structured bug report from a description, or analyze code for potential bugs.

Install

npx skills add Donchitos/Claude-Code-Game-Studios --skill bug-report -g -a claude-code -y
Category
Engineering
Updated
17d ago
License
MIT
Context cost
Mediumabout 2,516 tokens
Runs scripts
No, instructions only

What it does

Structured bug report from a description, or analyze code for potential bugs. Reproduction steps, severity.

!bash "${CLAUDE_SKILL_DIR}/../../hooks/yaml-helper.sh" resolve_config --keys automation

Automation mode: Resolve modes.automation (project.local.yaml → project.yaml → default collaborative). Every AskUserQuestion call and every file write follows .claude/docs/automation-modes.md (collaborative asks always · guided major-only · autonomous logs and proceeds; automation_always_ask categories always prompt).

Bug Report

Drafts only. This skill writes reports to production/qa/bugs/. When the cause is in the engine, a plugin or another vendor's code, add a draft for their tracker under Notes and stop there: never file, open or comment on an issue or pull request in their repository. The user submits it.

Phase 1: Parse Arguments

Determine the mode from the argument:

  • No keyword → Description Mode: generate a structured bug report from the provided description
  • analyze [path] → Analyze Mode: read the target file(s) and identify potential bugs
  • verify [BUG-ID] → Verify Mode: confirm a reported fix actually resolved the bug
  • close [BUG-ID] → Close Mode: mark a verified bug as closed with resolution record

If no argument is provided, ask the user for a bug description before proceeding.


Phase 2A: Description Mode

  1. Parse the description for key information: what broke, when, how to reproduce it, and what the expected behavior is.

  2. Search the codebase for related files using Grep/Glob to add context (affected system, likely files).

  3. Draft the bug report:

# Bug Report

## Summary
**Title**: [Concise, descriptive title]
**ID**: BUG-[NNNN]
**Severity**: [S1-Critical / S2-High / S3-Medium / S4-Low]
**Priority**: [P1-Fix this sprint / P2-Fix soon / P3-Backlog / P4-Won't fix]
**Status**: Open
**Reported**: [Date]
**Reporter**: [the reporter's name as the user gives it, else `, `; never an email address or account ID taken from the session]
Read the whole SKILL.md on GitHub

More in Engineering