systematic-debugging

Trace root causes of bugs and test failures before proposing fixes.

1|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/darkmatter/skills --skill systematic-debugging-darkmatter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/darkmatter/skills/tree/main/docs/00-inbox/skills/systematic-debugging
Command: npx skills add https://github.com/darkmatter/skills --skill systematic-debugging-darkmatter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents guess-and-check debugging by forcing a root-cause-first approach for bugs, test failures, performance issues, and unexpected behavior.

Core Features & Use Cases

  • Root Cause Investigation: Read errors carefully, reproduce issues reliably, review recent changes, and trace data flow back to the original trigger.
  • Pattern Analysis and Hypothesis Testing: Compare against working examples, form a single specific hypothesis, and test the smallest possible change.
  • Safe Implementation: Create a failing test, apply one fix at a time, verify the result, and escalate to architectural review after repeated failures.
  • Use Case: When a flaky test or production incident tempts you toward a quick patch, this Skill keeps you from masking symptoms and helps you fix the real source.

Quick Start

Use the systematic-debugging skill to investigate this issue from root cause to verified fix before suggesting any solution.

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 flaky test failures instead of guessing?

To find the root cause of flaky test failures, you must establish consistent reproduction, trace data flow backwards to the original trigger, and form a single specific hypothesis before changing code.

What is the best way to debug production incidents in multi-component systems?

The best way to debug production incidents in multi-component systems is gathering evidence, analyzing patterns against working examples, and tracing data flow back to the original trigger before proposing any fix.

Why should I create a failing test before applying a bug fix?

You should create a failing test before applying a bug fix to validate the root cause hypothesis and confirm that your single-variable change resolves the exact issue durably.

How do I troubleshoot build failures and integration issues systematically?

To troubleshoot build failures and integration issues systematically, review recent changes, compare against working examples, and apply one minimal fix at a time while escalating to architectural review after repeated failures.

When should I escalate debugging to an architectural review?

You should escalate debugging to an architectural review after repeated single-variable fixes fail to resolve the issue, indicating a deeper structural problem rather than a simple bug.

Does systematic debugging work for performance issues and unexpected behavior?

Yes, systematic debugging works for performance issues and unexpected behavior by applying layered validation, pattern analysis, and hypothesis testing to trace the root cause before any solution is implemented.