What problem does it solve?
This Skill investigates unknown defects, anomalies, and unexpected behavior when the cause is not yet understood. It helps teams avoid guesswork by forcing evidence-backed diagnosis before any fix is attempted.
Core Features & Use Cases
- Structured Investigation: Captures the symptom, reproduction steps, and evidence before analysis begins.
- Root-Cause Reasoning: Requires multiple distinct hypotheses, including at least one boring environmental explanation, before narrowing down the cause.
- Evidence-Gated Decisions: Reads logs, traces, commits, and configuration in a read-only way to decide whether the issue should route to fix, adr, or no-action close.
- Safe Handoff: Produces a concise summary and downstream handoff so fix, architecture review, or task tracking can continue without re-reading the full session.
Quick Start
Use the debug skill to investigate the reported failure, collect a minimal repro, and route the outcome to the correct follow-up action.