debugging-and-error-recovery

Diagnose reproducible bugs using a structured six-step triage workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides systematic root-cause debugging and incident triage. Use when tests fail, builds break, behavior doesn't match expectations, or you encounter any unexpected error. Focus on a disciplined, evidence-driven approach rather than guessing.

Core Features & Use Cases

  • Structured triage with a stop-the-line rule to preserve evidence and guide diagnosis.
  • Reproducibility, localization, and minimal reproduction steps to pinpoint failures across UI, API, database, and tests.
  • Root-cause fixes with guardrails, regression testing, and instrumentation to prevent recurrence.

Quick Start

Reproduce the failure and follow Step 1 through Step 6 of the triage checklist to resolve it.

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 triage and fix reproducible bugs?

Systematic triage requires a structured workflow to find root causes: reproduce the failure, localize the issue, reduce it to a minimal case, apply a fix, add guardrails, and verify the resolution.

How do I find the root cause when tests fail or builds break unexpectedly?

To find the root cause of failures, follow an evidence-driven triage checklist rather than guessing. Preserve diagnostic evidence using stop-the-line rules to accurately resolve unexpected behavior across UI, API, and tests.

How do I create minimal reproduction steps to pinpoint failures across different layers?

Creating minimal reproduction steps involves systematically narrowing the failure scope across UI, API, and database layers. This localization process isolates the exact trigger, ensuring you fix the actual defect instead of masking symptoms.

Why do I need a stop-the-line rule during incident management and error recovery?

A stop-the-line rule is necessary during incident management to immediately halt progress and preserve failure evidence. This disciplined approach prevents diagnostic data loss, ensuring accurate root-cause diagnosis before applying fixes.

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

To prevent recurring failures, implement guardrails, add regression testing, and increase instrumentation alongside your root-cause fix. This structured approach ensures end-to-end reliability and stops the same error from reappearing.

Can I use this structured triage workflow for database and API failures, or is it limited to UI tests?

You can use this structured triage workflow across UI, API, database, and test layers. The disciplined debugging practices apply evidence-driven localization and safe fallbacks to achieve end-to-end reliability regardless of the failing component.