What problem does it solve?
This Skill guides engineers and maintainers through a structured, evidence-driven bug investigation when users report errors, stack traces, screenshots, or build/test failures, ensuring the root cause is found before code changes are made.
Core Features & Use Cases
- Structured Reproduction: Confirms whether an issue can be reproduced and records exact steps to trigger the bug.
- Falsifiable Assertions & Verification: Generates 3-5 specific, testable hypotheses with file:line evidence and verifies them one at a time.
- Value-Domain & Parallel-Path Analysis: Performs mandatory value-domain tracing for data-related bugs and inspects parallel processing paths to avoid partial fixes.
- Planned, User-Approved Fixes: Produces consumer-impact lists and classifies fixes as simple or complex, gating implementation on user approval to avoid accidental regressions.
Quick Start
Use the fix-bug skill to investigate the provided error or stack trace, reproduce the issue, generate falsifiable hypotheses with evidence, and produce a user-approved fix plan.