What problem does it solve?
This skill eliminates unproductive, ad-hoc debugging for complex, hard-to-reproduce bugs and performance regressions that waste engineering time and often lead to incomplete, recurring fixes.
Core Features & Use Cases
- 6-Phase Disciplined Debug Loop: Follow a structured workflow of building a feedback loop, reproducing the bug, generating falsifiable hypotheses, targeted instrumentation, fixing with regression tests, and post-mortem cleanup to ensure thorough, repeatable debugging.
- Reproduction Loop Guidance: Provides 10 prioritized methods to build fast, deterministic, agent-runnable reproduction loops, including failing tests, headless browser scripts, and bisection harnesses, even for non-deterministic or flaky bugs.
- Use Case: For example, if a team is investigating a performance regression that only occurs under high concurrent load, this skill guides them to build a load test reproduction loop, rank hypotheses about database query bottlenecks or cache misses, instrument only the relevant code paths, and add a regression test to prevent the issue from recurring.
Quick Start
Use the diagnose skill to debug the intermittent 500 error that occurs when uploading large files to the production API.