systematic-debugging

Guide four-phase debugging from investigation to implementation with root cause analysis.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/abner-magal/mcp-video-audio --skill systematic-debugging-abner-magal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/abner-magal/mcp-video-audio/tree/main/.opencode/skills/systematic-debugging
Command: npx skills add https://github.com/abner-magal/mcp-video-audio --skill systematic-debugging-abner-magal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill provides a robust, step-by-step process to systematically identify and resolve the root cause of any bug, test failure, or unexpected behavior, preventing the common pitfalls of quick fixes and symptom treatment.

Core Features & Use Cases

  • Four-Phase Framework: Guides users through Investigation, Pattern Analysis, Hypothesis, and Implementation.
  • Root Cause Mandate: Emphasizes finding the fundamental issue, not just patching symptoms.
  • Pressure Resistance: Includes rules and language designed to prevent shortcuts under time pressure or urgency.
  • Use Case: When a critical test fails in CI, instead of guessing, load this skill to ensure a thorough investigation that prevents future occurrences and avoids costly rework.

Quick Start

Use the systematic debugging skill to investigate the current test failure.

Frequently Asked Questions about systematic-debugging

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

FAQPage Schema
How do I find the root cause of a bug instead of just treating symptoms?

Root cause debugging requires a structured methodology that emphasizes evidence gathering, data flow tracing, and pattern analysis over quick fixes. This approach uses a four-phase framework to systematically investigate technical issues, ensuring the fundamental problem is resolved rather than masked by symptom patches.

What is the best way to troubleshoot a critical test failure in CI?

Troubleshooting a critical test failure involves loading a systematic debugging skill to guide a thorough investigation. This process resists time pressure by enforcing hypothesis formation and architectural questioning, preventing costly rework and avoiding the common pitfall of guessing the fix under urgency.

How do I investigate unexpected application behavior when multiple fixes fail?

Investigating unexpected behavior when multiple fixes fail requires shifting to architectural questioning and deeper data flow tracing. The systematic debugging methodology provides specific rules to break out of rationalizations, ensuring you gather comprehensive evidence and analyze patterns before attempting another implementation.

Can I use a structured debugging methodology for any technical issue?

Yes, a structured debugging methodology applies to any technical issue, test failure, or unexpected behavior. It provides a robust step-by-step process spanning investigation, pattern analysis, hypothesis, and implementation phases, preventing the common pitfalls of quick fixes and symptom treatment across diverse software engineering contexts.

Why does systematic bug fixing prevent future occurrences of the same issue?

Systematic bug fixing prevents future occurrences by mandating root cause analysis over symptom treatment. By following a structured four-phase methodology that includes thorough evidence gathering and hypothesis formation, you resolve the fundamental issue rather than applying patches that often lead to costly rework.

When should I avoid quick fixes and use a systematic debugging process?

You should avoid quick fixes and use a systematic debugging process whenever facing a critical test failure or complex unexpected behavior. If you feel time pressure or urgency to guess a solution, the structured methodology provides specific rules to resist shortcuts and ensure a thorough investigation.