systematic-debugging

Investigate root causes of bugs and test failures through evidence-based analysis.

Updated Aug 23, 2026

Search Tags:#debugging #troubleshooting #root cause analysis #bug fixing #problem-solving #software quality #system analysis

One-click install

npx skills add https://github.com/totalaudiopromo/total-audio-platform --skill systematic-debugging-totalaudiopromo

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: systematic-debugging
Source: https://github.com/totalaudiopromo/total-audio-platform/tree/main/.claude/skills/systematic-debugging
Command: npx skills add https://github.com/totalaudiopromo/total-audio-platform --skill systematic-debugging-totalaudiopromo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill stops the cycle of random fixes and symptom patching, ensuring that every bug, test failure, or unexpected behavior is understood and resolved at its root cause, saving time and preventing new issues.

Core Features & Use Cases

Four-Phase Framework: Guides through Root Cause Investigation, Pattern Analysis, Hypothesis Testing, and Implementation, ensuring thoroughness.
Evidence-Based Troubleshooting: Mandates gathering diagnostic instrumentation and tracing data flow in multi-component systems before proposing any fixes.
Architectural Problem Detection: Provides a clear signal to question the underlying architecture if multiple fixes fail, preventing endless symptom patching.
Use Case: When a production API is down and there's pressure for a quick fix, use this skill to resist patching symptoms and instead systematically investigate the root cause, ensuring a lasting solution.

Quick Start

Use the systematic-debugging skill to help me investigate why the 'user-auth' test is consistently failing.