debugging

Guide hypothesis-driven debugging from evidence gathering to minimal fix verification.

44|9|Updated May 7, 2026
One-click install
npx skills add https://github.com/Omar-Obando/qwen-orchestrator --skill debugging-omar-obando
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging
Source: https://github.com/Omar-Obando/qwen-orchestrator/tree/main/skills/debugging
Command: npx skills add https://github.com/Omar-Obando/qwen-orchestrator --skill debugging-omar-obando

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It replaces guesswork with a structured, hypothesis-driven process to identify the true root cause of bugs and failures.

Core Features & Use Cases

  • Hypothesis-driven debugging (OBSERVE → HYPOTHESIZE → TEST → FIX → VERIFY): Collects concrete evidence, tests one variable at a time, and confirms the fix without introducing regressions.
  • Investigation techniques: Uses methods like binary search debugging to narrow where the failure occurs and rubber-duck debugging to surface contradictions in understanding.
  • Log-based debugging & bug categorization: Helps interpret symptoms such as off-by-one errors, race conditions, null references, stale state, memory leaks, and circular references.

Quick Start

Ask the AI to debug your issue by guiding you through evidence collection, generating at least three ranked hypotheses, running one-variable-at-a-time tests, applying the minimal fix, and then verifying with the original failing case.

Frequently Asked Questions about 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 fixing the symptoms?

Root cause identification requires hypothesis-driven debugging, collecting concrete evidence first, then testing one variable at a time to systematically narrow down failures. This structured approach replaces guesswork and prevents symptom-only fixes that introduce regressions later.

What is the best way to debug race conditions and memory leaks in production?

Debugging race conditions and memory leaks involves log-based debugging to categorize symptoms, generating at least three ranked hypotheses, and applying binary search to isolate the failure. This methodical narrowing ensures you accurately identify the true cause of complex production failures.

How do I systematically troubleshoot failures using log analysis?

Log analysis for troubleshooting uses a structured five-phase workflow: OBSERVE, HYPOTHESIZE, TEST, FIX, and VERIFY. You collect concrete evidence from logs, generate ranked hypotheses, and run one-variable-at-a-time tests to confirm the minimal fix without introducing regressions.

Can I use hypothesis testing to fix off-by-one errors and null references?

Hypothesis testing fixes off-by-one errors and null references by observing the symptom, generating ranked hypotheses, and testing one variable at a time. You apply the minimal fix and verify with the original failing case to ensure the bug is truly resolved.

Why does my software fix introduce new regressions during incident response?

Software fixes introduce regressions during incident response when they address only symptoms instead of the root cause. Applying a minimal fix and verifying with the original failing case after structured hypothesis testing prevents this regression cycle.

Does structured debugging work for stale state and circular references?

Structured debugging works for stale state and circular references by guiding evidence-based investigation. It categorizes these specific bugs, applies rubber-duck debugging to surface contradictions, and uses one-variable testing to verify the minimal fix completely.