debugging-and-error-recovery

Diagnose software failures using a triage checklist and error-specific patterns.

84.9k|9.1k|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/addyosmani/agent-skills --skill debugging-and-error-recovery
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-and-error-recovery
Source: https://github.com/addyosmani/agent-skills/tree/main/skills/debugging-and-error-recovery
Command: npx skills add https://github.com/addyosmani/agent-skills --skill debugging-and-error-recovery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured, systematic approach to diagnosing and resolving software failures, preventing guesswork and ensuring root causes are addressed.

Core Features & Use Cases

  • Triage Checklist: A step-by-step process (Reproduce, Localize, Reduce, Fix, Guard, Verify) for tackling any unexpected error.
  • Error-Specific Patterns: Tailored guidance for test failures, build errors, and runtime bugs.
  • Safe Fallbacks: Strategies for implementing graceful degradation and default values to prevent crashes.
  • Use Case: When a critical bug is reported in production, this Skill guides the engineer through reproducing the issue, pinpointing the faulty code, implementing a robust fix, and adding a regression test to prevent recurrence.

Quick Start

Use the debugging and error recovery skill to diagnose and fix the failing test suite.

Frequently Asked Questions about debugging-and-error-recovery

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

FAQPage Schema
What is the best way to systematically debug a critical production bug?

To systematically debug a critical production bug, follow a triage checklist: Reproduce, Localize, Reduce, Fix, Guard, and Verify. This methodology ensures root cause analysis and prevents future recurrence through regression tests.

How do I troubleshoot failing test suites and build errors?

To troubleshoot failing test suites and build errors, apply error-specific debugging patterns tailored to those failures. This process isolates the faulty code and implements a robust fix while addressing common rationalizations that hinder troubleshooting.

How do I implement safe fallbacks for error handling to prevent application crashes?

To prevent application crashes during error handling, implement safe fallbacks using graceful degradation and default values. These strategies ensure your software fails safely without interrupting the user experience when runtime bugs occur.

Why does adding regression tests matter during bug fixing?

Adding regression tests matters during bug fixing because it guards the codebase against recurrence. By verifying the fix with a targeted test, you confirm the root cause is resolved and maintain long-term code quality.

What are common red flags to watch for when diagnosing runtime bugs?

Common red flags when diagnosing runtime bugs include rationalizations that bypass root cause analysis. A structured debugging methodology addresses these psychological traps, ensuring you reduce the problem accurately before applying a fix.