systematic-debugging

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

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/CeeKay1901/pilot-skillmarkt --skill systematic-debugging-ceekay1901
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/CeeKay1901/pilot-skillmarkt/tree/main/skills/systematic-debugging
Command: npx skills add https://github.com/CeeKay1901/pilot-skillmarkt --skill systematic-debugging-ceekay1901

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you debug bugs, test failures, performance regressions, and other unexpected behavior without falling into guess-and-check fixes that waste time or create new issues.

Core Features & Use Cases

  • Root-cause first workflow: Forces investigation before any fix is proposed, so symptoms are traced back to the original trigger.
  • Evidence-driven debugging: Guides you to read errors carefully, reproduce reliably, inspect recent changes, and instrument multi-component systems to see where failures actually occur.
  • Pattern and hypothesis testing: Compares broken behavior against working examples, forms a single testable hypothesis, and validates the smallest possible change.
  • Safe implementation: Encourages failing tests, single-root-cause fixes, and verification before claiming success.
  • Example use case: A flaky CI test, an API returning unexpected data, or a build failure can be traced systematically instead of patched blindly.

Quick Start

Use the systematic-debugging skill to investigate this bug step by step, identify the root cause, and propose the smallest verified fix only after evidence points to the source.

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 flaky test or build failure?

To find the root cause of a flaky test, you must investigate by reproducing the failure reliably, gathering evidence, comparing against working patterns, and forming a testable hypothesis before proposing a fix.

What is the best way to debug multi-component software defects without guessing?

The best way to debug multi-component software defects is through evidence-driven debugging, which involves reading errors carefully, inspecting recent changes, and instrumenting the system to observe exactly where the failure occurs.

Why should I trace an unexpected API response before applying a bug fix?

Tracing an unexpected API response before fixing prevents guess-and-check patches that waste time, ensuring you identify the original trigger and validate the smallest possible change through verification.

How do I systematically troubleshoot a performance regression?

To systematically troubleshoot a performance regression, form a single testable hypothesis based on gathered evidence, validate it with the smallest possible change, and run failing tests to verify the implementation.

Does this debugging approach work for both test failures and complex system bugs?

Yes, this systematic debugging approach applies to software defects, flaky tests, build failures, performance regressions, and multi-component issues by enforcing an evidence-gathering and hypothesis-testing workflow.

When should I not use a systematic root cause debugging workflow?

You should avoid this systematic workflow for trivial issues where the root cause is already visually obvious, as it requires strict pattern comparison, hypothesis testing, and verification steps that add overhead to simple fixes.