What problem does it solve?
This Skill helps you break out of unproductive debugging loops by replacing guess-driven troubleshooting with a disciplined falsification process. It is especially useful when the obvious fix failed, the symptoms are confusing, or multiple causes seem plausible.
Core Features & Use Cases
- Structured Hypothesis Testing: Forces explicit fact collection, generation of multiple distinct hypotheses, and ranked investigation instead of anchoring on the first idea.
- Disconfirming Tests First: Focuses on designing tests that could rule a hypothesis out, which reduces confirmation bias and speeds root-cause discovery.
- Handles Tricky Failures: Adapts well to intermittent bugs, environment-specific issues, contradictory symptoms, and regressions after recent changes.
- Use Case: When a test appears flaky and recent commits suggest several suspicious causes, this Skill helps you reproduce the failure, separate real facts from misleading framing, cheaply falsify red herrings, and converge on the actual defect.
Quick Start
Use the popperian-debug skill to investigate a failing test by listing the facts, proposing several distinct causes, and trying to disprove the top hypothesis before making changes.