Updated: 2026-03-25
bug-reporting
Basic Information
Full Skill Guide
When
- Defects are found and must be communicated for fast fix and retest.
- Team has recurring misunderstandings about issue severity or reproduction.
- Management needs clear defect status and impact visibility.
What
- Produce actionable bug reports with clear reproduction and impact.
- Improve fix turnaround by reducing back-and-forth clarification.
- Enable reliable prioritization by severity and business risk.
How
- Capture environment, precondition, and minimal reproduction steps.
- Document expected vs. actual behavior with objective evidence.
- Assess severity, scope impact, and user/business consequence.
- Attach logs/screenshots/api payloads for quick diagnosis.
- Propose verification points after fix.
- Track lifecycle and closure evidence.
Reference
Positive Example (Input -> Output)
Input:
- Checkout failure under expired-token refresh path
Output:
- Repro steps, request id, failing response payload
- Severity rationale (payment interruption)
- Retest checklist for fix validation
Negative Example (Input -> Output)
Input:
- "Payment has bug"
Output (problem):
- No environment, no reproducible steps, no expected result
- Developer cannot verify root cause efficiently
Limits
- Do not submit bugs without reproducible evidence.
- Do not overstate severity without impact rationale.
- Do not mix multiple unrelated issues in one ticket.
- Do not close issue without retest proof.
- Do not hide intermittent behavior; mark and track it explicitly.
Usage Guide
- Install and enable
bug-reportingfirst (use the install commands in this page). - In your request, provide required context: scope, environment, timeline, and expected output format.
- Trigger with defect evidence, for example: "Use
bug-reportingto create a developer-ready bug ticket." - Require fixed structure: environment, repro steps, expected/actual, logs, impact, retest criteria.
- After fix, ask the skill to generate a closure verification checklist.
Installation
Platform
AI Tool
Quick install (one line)
Generating command... Full script
Loading script...