debugging-and-error-recovery

Diagnose software failures by reproducing, localizing, and reducing to root cause.

Updated May 3, 2026
One-click install
npx skills add https://github.com/kevindree/geehoo-gateway --skill debugging-and-error-recovery-kevindree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-and-error-recovery
Source: https://github.com/kevindree/geehoo-gateway/tree/main/.github/skills/debugging-and-error-recovery
Command: npx skills add https://github.com/kevindree/geehoo-gateway --skill debugging-and-error-recovery-kevindree

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you diagnose failures systematically instead of guessing, so you can fix broken tests, builds, runtime bugs, and incidents with confidence.

Core Features & Use Cases

  • Structured triage from reproduction to root cause
  • Works for test failures, build errors, flaky behavior, and unexpected runtime issues
  • Includes guidance for minimal repros, localization, regression guards, and end-to-end verification
  • Use case: when a CI test starts failing after a change, it helps you isolate the layer, confirm the cause, fix the real defect, and add a test to prevent recurrence.

Quick Start

Use the debugging-and-error-recovery skill to investigate this failing test and walk me through reproduce, localize, reduce, fix, and verify steps.

Frequently Asked Questions about debugging-and-error-recovery

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

FAQPage Schema
How do I find the root cause of a failing test in CI?

To find the root cause of a failing test, you reproduce the issue, localize the fault to a specific layer, reduce it to a minimal repro, apply a fix, and verify end-to-end. This systematic triage isolates the real defect instead of guessing.

What is the best way to debug flaky behavior and runtime errors?

Debugging flaky behavior and runtime errors requires preserving evidence during reproduction, localizing the fault, and reducing the problem to a minimal root cause. This structured approach prevents guessing and ensures the fix addresses the underlying defect.

How do I fix build failures systematically without guessing?

To fix build failures systematically, you diagnose the failure by reproducing the issue, localizing the fault, and reducing the problem to a minimal root cause. You then apply a fix and add regression guards to prevent recurrence.

Can I use this structured triage process for production incidents?

Yes, this structured triage process works for production incidents by reproducing the issue, localizing the fault, and reducing the problem to a minimal root cause. It requires evidence preservation and end-to-end verification to ensure the fix works.

Why do I need to add regression guards when fixing unexpected runtime bugs?

Adding regression guards when fixing unexpected runtime bugs prevents the same defect from recurring in the future. After localizing the fault and applying a fix, regression guards verify the underlying issue is resolved and protected against future changes.

What steps are involved in reducing a software failure to a minimal root cause?

Reducing a software failure to a minimal root cause involves reproducing the issue, localizing the fault to a specific layer, and stripping away irrelevant factors. This process isolates the exact defect so you can fix it and verify the solution end-to-end.