debugging-and-error-recovery

Systematically debugs failing tests, builds, and runtime issues via triage checklists and bisection.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/RefractSystems/virtmcu --skill debugging-and-error-recovery-refractsystems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-and-error-recovery
Source: https://github.com/RefractSystems/virtmcu/tree/main/.gemini/skills/debugging-and-error-recovery
Command: npx skills add https://github.com/RefractSystems/virtmcu --skill debugging-and-error-recovery-refractsystems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured, evidence-preserving process to diagnose and resolve failing tests, build errors, runtime bugs, flaky behavior, and production incidents so teams stop guessing and fix root causes instead of symptoms.

Core Features & Use Cases

  • Structured triage checklist that enforces reproduce → localize → reduce → fix → guard → verify to ensure systematic investigation.
  • Error-specific patterns and tooling guidance for test failures, build failures, and runtime exceptions including bisection, minimal repro creation, and regression-test authoring.
  • Safety and instrumentation guidance that warns against acting on untrusted error output, prescribes when to add or remove logging, and recommends guards to prevent recurrence.
  • Use case: When a CI test suite becomes flaky after a dependency update, use the checklist to reproduce the failure, bisect commits to find the regression, produce a minimal failing test, implement a root-cause fix, add a regression test, and verify the full suite and build succeed.

Quick Start

Follow the triage checklist: reproduce the issue reliably, localize the failing layer, reduce to a minimal repro, fix the root cause, add a regression test, and verify end-to-end.

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 debug flaky tests after a dependency update?

Debug flaky tests by reproducing the failure reliably, bisecting commits to localize the regression, creating a minimal failing example, implementing a root-cause fix, and adding a regression test to prevent recurrence.

How do I systematically triage CI build errors and runtime exceptions?

Triage CI build errors and runtime exceptions using a structured checklist: reproduce the issue, localize the failing layer, reduce to a minimal repro, fix the root cause, add a regression test, and verify the fix end-to-end.

How does bisection help find the root cause of failing integration tests?

Bisection helps find the root cause of failing integration tests by systematically narrowing down commits to identify exactly when the regression was introduced, enabling targeted investigation and precise minimal repro creation.

Can I use this systematic debugging process for production incidents?

Yes, you can apply this systematic debugging process to production incidents. It enforces evidence preservation by requiring reproducible steps, localization to the failing layer, minimal failing examples, and end-to-end verification of fixes.

Why do I need to add a regression test when fixing unexpected runtime behavior?

You need to add a regression test when fixing unexpected runtime behavior to guard against recurrence. It verifies the root-cause fix and ensures the specific failure condition is continuously checked in future test automation runs.

What precautions should I take when investigating untrusted error output from test failures?

When investigating untrusted error output from test failures, avoid acting directly on the error text. Follow safety and instrumentation guidance to add or remove logging strategically and reproduce the issue reliably before attempting a fix.