Debugging

Trace root causes of bugs through a four-phase debugging workflow.

Updated Jun 16, 2025
One-click install
npx skills add https://github.com/Stonelukas/Mouse-on-Numpad --skill debugging-stonelukas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Debugging
Source: https://github.com/Stonelukas/Mouse-on-Numpad/tree/main/.opencode/skill/debugging
Command: npx skills add https://github.com/Stonelukas/Mouse-on-Numpad --skill debugging-stonelukas

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Systematic debugging with root-cause analysis to prevent guesswork and wasted effort when bugs or failures occur across complex systems.

Core Features & Use Cases

  • Four-phase debugging framework (root cause investigation, pattern analysis, hypothesis testing, implementation) to structure problem solving.
  • Root-cause tracing across call stacks to identify original trigger and fix at source.
  • Defense-in-depth validation across entry, business, environment, and debug layers to prevent regressions.
  • Verification protocols to confirm results before claiming completion and to avoid false positives.

Quick Start

Run the four-phase debugging workflow on a failing scenario to locate the root cause and prepare a verifiable fix.

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 in a deep call stack instead of guessing?

Root-cause debugging systematically traces failures across deep call stacks using a four-phase framework: root cause investigation, pattern analysis, hypothesis testing, and implementation. This enforces verification before applying fixes to prevent guesswork.

What is the best way to debug flaky tests across multi-module systems?

Debugging flaky tests across multi-module systems requires pattern analysis and hypothesis testing to isolate variables. A systematic debugging workflow applies defense-in-depth validation across entry, business, and environment layers to confirm root causes before fixing.

How do I systematically debug performance issues without causing regressions?

Systematically debug performance issues by applying defense-in-depth validation across entry, business, environment, and debug layers. This verification protocol confirms fixes resolve the original trigger without introducing regressions or false positives before completion.

Does this debugging workflow require specific testing frameworks or dependencies?

No specific testing frameworks or dependencies are required. The systematic debugging workflow operates independently using internal scripts and references to structure root-cause investigation, pattern analysis, hypothesis testing, and implementation phases across any software stack.

Why should I use a four-phase debugging workflow instead of directly patching errors?

Directly patching errors often addresses symptoms rather than the original trigger. A four-phase debugging workflow enforces root-cause investigation and hypothesis testing first, ensuring your implementation fix is verified and prevents wasted effort on complex failures.