debugging-and-error-recovery

Guide systematic root-cause debugging of failing tests and build errors.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/logo-solutions/NAS-logo --skill debugging-and-error-recovery-logo-solutions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-and-error-recovery
Source: https://github.com/logo-solutions/NAS-logo/tree/main/skills/debugging-and-error-recovery
Command: npx skills add https://github.com/logo-solutions/NAS-logo --skill debugging-and-error-recovery-logo-solutions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured, evidence-first approach to diagnosing and resolving software failures so teams avoid guessing, prevent regressions, and restore correct behavior reliably.

Core Features & Use Cases

  • Structured Triage Checklist: Step-by-step process to reproduce, localize, reduce, fix, guard, and verify problems.
  • Technical Techniques: Guidance on creating minimal repros, using git bisect for regressions, adding instrumentation and targeted logs, and writing regression tests that prevent recurrence.
  • Use Cases: Debugging failing tests, broken builds, runtime errors, flaky tests, and production incidents where preserving evidence and verifying fixes is critical.

Quick Start

Follow the stop-the-line triage: stop changes, preserve evidence, reproduce reliably, localize the fault, create a minimal repro, fix the root cause, add a regression test, and verify end-to-end before resuming work.

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 debug failing tests and find the root cause of build errors?

Debug failing tests and build errors by following a structured triage checklist to reproduce reliably, localize the fault, create a minimal repro, fix the root cause, and verify end-to-end. This evidence-first approach prevents guessing and avoids regressions.

What is the best way to find which commit introduced a regression?

The best way to find a regression commit is using git bisect. This Skill guides you through git bisect to systematically narrow down commits, localizing the exact change that introduced the defect so you can target the root cause directly.

How do I fix flaky tests and prevent them from happening again?

Fix flaky tests by reproducing the failure reliably and localizing the fault through targeted instrumentation and logging. After applying the root-cause fix, add regression-test guardrails to verify the behavior and prevent future recurrence.

Can I use a systematic debugging process for production incident response?

Yes, you can use this systematic debugging process for production incident response. It applies a stop-the-line triage method: preserve evidence, reproduce the issue, minimize the repro, fix the root cause, and verify the resolution before resuming work.

What should I do when a runtime bug is hard to reproduce?

When a runtime bug is hard to reproduce, follow the triage steps to preserve evidence and add targeted instrumentation. Creating a minimal repro helps isolate the exact conditions triggering the unexpected behavior for accurate root-cause analysis.