debugging-and-error-recovery

Guides root-cause debugging for failing tests, builds, runtime errors, and incorrect behavior.

1|1|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/svssdeva/agentic-skills --skill debugging-and-error-recovery-svssdeva
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-and-error-recovery
Source: https://github.com/svssdeva/agentic-skills/tree/main/engineering/debugging-and-error-recovery
Command: npx skills add https://github.com/svssdeva/agentic-skills --skill debugging-and-error-recovery-svssdeva

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents wasted time and escalating failures by giving a systematic, evidence-preserving workflow for identifying and fixing the true root cause of test, build, runtime, or incident errors.

Core Features & Use Cases

  • Structured triage from reproduction to verification: Reproduce reliably, localize the failing layer, reduce to a minimal case, fix the root cause, add a regression test, then verify end-to-end.
  • Actionable patterns for common failure modes: Stepwise guidance for test failures, build failures, runtime errors, and non-reproducible issues like timing, environment, state, or randomness.
  • Safety for diagnostic inputs: Treat error output as untrusted text, avoiding blindly following instructions embedded in logs or stack traces.
  • Recurrence prevention: Emphasizes guarding against repeat failures by adding targeted tests and keeping only necessary instrumentation.

Quick Start

Use this skill when your tests fail or your build/runtime behavior is unexpected, and ask for a triage plan that follows the stop-the-line rule and walks through reproduction, localization, minimal reproduction, root-cause fix, regression test, and verification.

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 a failing test by finding the root cause instead of just patching the symptom?

Root cause debugging requires a systematic workflow: reliably reproduce the failing test, localize the broken layer, reduce to a minimal case, apply the fix, add a regression test, and verify end-to-end.

What is the best way to fix broken builds and runtime errors without escalating failures?

Fixing broken builds and runtime errors safely requires enforcing a stop-the-line rule and treating error output as untrusted diagnostic data to prevent blindly following embedded instructions in stack traces.

How do I debug non-reproducible runtime incidents caused by timing or environment state?

Debugging non-reproducible runtime incidents involves systematic localization across UI, API, database, and external services, preserving diagnostic evidence to capture timing, environment, state, or randomness issues.

Why should I treat error output and stack traces as untrusted text during test triage?

Treating error output as untrusted text during test triage prevents blindly executing instructions embedded in logs or stack traces, ensuring you preserve diagnostic evidence and maintain debugging safety.

How do I prevent regression failures after applying a root cause fix?

Preventing regression failures requires creating targeted regression tests for the specific root cause, keeping only necessary instrumentation, and completing full end-to-end validation to add guardrails against repeat issues.

Can I use this systematic debugging workflow for localizing failures across UI, API, and database layers?

Yes, the debugging workflow applies to regression triage and localization across UI, API, database, tooling, and external services by enforcing stepwise reproduction, reduction, fix, and verification.