debugging-and-error-recovery

Diagnose software defects through structured triage and root-cause analysis.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/fsolla/teqo --skill debugging-and-error-recovery-fsolla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-and-error-recovery
Source: https://github.com/fsolla/teqo/tree/main/.agents/skills/debugging-and-error-recovery
Command: npx skills add https://github.com/fsolla/teqo --skill debugging-and-error-recovery-fsolla

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the inefficiency of guessing during debugging by providing a rigorous, step-by-step triage framework to identify and resolve the root cause of software failures.

Core Features & Use Cases

  • Structured Triage: A standardized 6-step process to stop the line, preserve evidence, and verify fixes.
  • Regression Prevention: Guidance on writing specific tests to ensure bugs do not recur.
  • Use Case: When a build fails or a test suite breaks, use this skill to systematically isolate the failing layer, create a minimal reproduction, and implement a permanent fix rather than a temporary patch.

Quick Start

Apply the debugging and error recovery framework to investigate the failing test case in the current repository.

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 find the root cause of a software defect?

Root cause analysis for software defects requires a systematic 6-step triage process that stops the line, preserves evidence, creates a minimal reproduction, and verifies the permanent fix through regression testing.

How do I systematically debug failing tests and build errors?

Debug failing tests and build errors by applying a structured triage methodology that stops the line, isolates the failing layer, creates a minimal reproduction, and implements a permanent fix rather than a temporary patch.

How does structured triage help with error recovery during runtime anomalies?

Structured triage enables error recovery during runtime anomalies by enforcing a stop-the-line rule to preserve evidence, ensuring you diagnose the actual root cause instead of guessing at temporary patches.

Can I use this debugging methodology for both development and production environments?

Yes, this debugging methodology applies to both development and production environments, providing structured root-cause analysis for test failures, build errors, and runtime anomalies across both contexts.

Why should I write a regression test after fixing a bug?

Writing a regression test after fixing a bug ensures the specific defect does not recur. The framework mandates verifying fixes through regression testing to prevent future breakage.

What are the limitations of guessing during troubleshooting instead of using root-cause analysis?

Guessing during troubleshooting introduces inefficiency and risks applying temporary patches, whereas root-cause analysis eliminates this by requiring a minimal reproduction and a permanent fix verified through regression testing.