debugging

Diagnose and fix bugs using a five-step observe, hypothesize, test, conclude, verify protocol.

Updated Feb 10, 2026
One-click install
npx skills add https://github.com/thienty1207/rust-skills --skill debugging-thienty1207
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging
Source: https://github.com/thienty1207/rust-skills/tree/main/debugging
Command: npx skills add https://github.com/thienty1207/rust-skills --skill debugging-thienty1207

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Systematic debugging framework — structured root-cause analysis, hypothesis-driven debugging, evidence collection, defense-in-depth validation, regression prevention. Use when fixing bugs, investigating failures, diagnosing performance issues, or troubleshooting production incidents.

Core Features & Use Cases

  • Systematic Debugging: follow observe → hypothesize → test → conclude → verify loop to pinpoint root causes.
  • Root Cause Tracing & Defense-in-Depth: multi-layer validation across unit, integration, and end-to-end tests.
  • Reference-guided troubleshooting: leverage git-bisect, debugging tools, and common bug patterns to accelerate diagnosis.
  • Use Case: When a production incident occurs, reproduce the issue, isolate the cause, form hypotheses, test them, and verify a regression-free fix.

Quick Start

Describe a reproducible bug scenario and apply the 5-step debugging protocol to identify the root cause.

Frequently Asked Questions about debugging

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

FAQPage Schema
What is a structured debugging framework for root-cause analysis?

A structured debugging framework systematically isolates software bugs by enforcing an observe, hypothesize, test, conclude, and verify loop to pinpoint exact root causes rather than patching symptoms. It relies on evidence collection across local, staging, and production environments.

How do I diagnose a production incident using hypothesis-driven debugging?

Diagnose a production incident using hypothesis-driven debugging by reproducing the failure, forming hypotheses based on observed evidence, testing them systematically, and verifying the fix prevents regressions. This structured approach isolates fault origins across environments.

When should I use git-bisect for troubleshooting regressions?

Use git-bisect for troubleshooting regressions when you need to identify the exact commit that introduced a bug across a range of code changes. It accelerates root-cause tracing by binary searching through commit history to isolate the failure origin.

Does defense-in-depth validation work for both unit and end-to-end tests?

Yes, defense-in-depth validation works across unit, integration, and end-to-end tests to ensure regression-free fixes. It enforces multi-layer validation after concluding the root cause, verifying that the software bug fix holds across all testing environments.

What is the best way to troubleshoot performance issues across staging and production?

The best way to troubleshoot performance issues is applying a five-step debugging protocol: observe symptoms, hypothesize causes, test assumptions, conclude the root cause, and verify the resolution. This ensures evidence-based diagnosis across staging and production environments.

Why does fixing a bug often cause new regressions in production?

Fixing a bug often causes new regressions when the root-cause analysis skips the verification step. Without defense-in-depth validation across unit, integration, and end-to-end tests, isolated fixes fail to account for multi-layered system interactions in production.