debug

Diagnose software bugs through reproduction, hypothesis testing, and root-cause analysis.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/remiconnesson/insights-garden --skill debug-remiconnesson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/remiconnesson/insights-garden/tree/main/.agents/skills/debug
Command: npx skills add https://github.com/remiconnesson/insights-garden --skill debug-remiconnesson

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill helps you diagnose, isolate, and fix software bugs by replacing guesswork with a systematic debugging workflow. It is designed for situations where code crashes, behaves unexpectedly, or fails only under specific conditions.

Core Features & Use Cases

  • Reproduction First: Confirm the issue reliably before changing code so you can validate every hypothesis.
  • Hypothesis-Driven Investigation: Narrow the search with scientific, stepwise reasoning instead of random edits.
  • Observation and Root Cause Analysis: Use logs, stack traces, breakpoints, and data-flow tracing to locate the real fault.
  • Verification and Prevention: Confirm the fix, check for regressions, and capture lessons so the bug does not return.
  • Use Case: A production incident triggers an exception in a payment flow, and this Skill guides you from the first symptom through reproduction, localization, root cause, and regression-proof verification.

Quick Start

Use the debug skill to investigate the bug from first symptom to verified fix by reproducing the issue, identifying the failing step, and following the debugging checklist.

Frequently Asked Questions about debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I systematically debug a software crash using stack traces and reproduction?

Systematic debugging starts by reliably reproducing the crash, then using stack traces, logs, and breakpoints to isolate the fault through hypothesis-driven investigation rather than random edits. This approach locates the true root cause quickly and verifies the fix.

What is hypothesis-driven root cause analysis for intermittent failures?

Hypothesis-driven root cause analysis is a stepwise debugging method that narrows the search for intermittent failures by forming testable assumptions, using strategic observation like data-flow tracing, and validating each hypothesis before changing code.

How do I create a minimal reproduction for a production incident exception?

To create a minimal reproduction for a production incident, isolate the exact conditions triggering the exception, strip away unrelated code paths, and confirm the issue reliably. This reproducible test case lets you validate every debugging hypothesis.

What is the best way to investigate performance regressions without guessing?

The best way to investigate performance regressions without guessing is to replace guesswork with a systematic debugging workflow: reproduce the slowdown, use strategic observation to trace data flow, and apply root cause analysis to pinpoint the failing step.

Can I use this debugging workflow for regression testing after a bug fix?

Yes, this debugging workflow supports regression testing and prevention after a fix. You confirm the fix resolves the original symptom, check that no regressions were introduced, and capture lessons so the bug does not return.

When do I need strategic observation and breakpoints for bug investigation?

You need strategic observation and breakpoints during bug investigation when symptoms are ambiguous or intermittent. They let you pause execution, inspect data flow, and gather the evidence needed for accurate root cause analysis across complex codebases.