Is this skill manually invoked by the user?

No, it is a background skill that triggers automatically when Claude detects tasks involving debugging, unexpected behavior, or investigation.

Does this work with specific web frameworks?

Yes, it is designed to load relevant tech skill references to provide context-aware debugging for various frameworks and languages.

What is the 'verification-gate' dependency?

It is a required check that ensures every fix is rigorously tested and proven effective before the debugging process is considered complete.

What happens if the AI cannot resolve the bug?

The skill includes an escalation rule; if three fixes fail, it stops to perform an architecture review, preventing endless cycles of ineffective code changes.

How does this skill prevent 'band-aid' fixes?

It requires the AI to provide a testable hypothesis and evidence-based pattern analysis before any code changes are allowed, ensuring the core issue is addressed.

Root Cause Debugging

Name: Root Cause Debugging
Author: hjemmesidekongen

byhjemmesidekongen

0•

Security & Testing

Implements a mandatory four-phase investigation protocol to identify and resolve the underlying source of software bugs rather than just patching symptoms.

The Root Cause Debugging skill enforces a disciplined approach to troubleshooting by requiring an evidence-based workflow consisting of investigation, pattern analysis, hypothesis formation, and implementation. It prevents common pitfalls like shotgun debugging and fix-and-pray tactics by mandating specific, testable hypotheses and strict verification gates. Designed for complex or recurring issues, the skill includes an escalation rule that triggers architectural reviews if initial fixes fail, ensuring that AI-driven development remains stable and structurally sound.

Key Features

01Anti-Pattern Prevention: Actively blocks shotgun debugging and symptom-only fixation

02Mandatory 4-Phase Protocol: Investigate, Pattern, Hypothesis, and Implement

03Escalation Logic: Triggers architecture reviews after three failed fix attempts

04Framework-Aware Diagnostics: Integrates with specific tech stack references for deep debugging

05Evidence-Based Verification: Requires logs and traces before forming any hypothesis

060 GitHub stars

Use Cases

01Investigating complex system behaviors where the cause is not immediately obvious

02Diagnosing recurring bugs that keep returning after temporary patches

03Stabilizing flaky tests by identifying the true source of failure

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hjemmesidekongen/ai root-cause-debugging

For use in Claude.ai and ChatGPT

Key Features

01Anti-Pattern Prevention: Actively blocks shotgun debugging and symptom-only fixation

02Mandatory 4-Phase Protocol: Investigate, Pattern, Hypothesis, and Implement

03Escalation Logic: Triggers architecture reviews after three failed fix attempts

04Framework-Aware Diagnostics: Integrates with specific tech stack references for deep debugging

05Evidence-Based Verification: Requires logs and traces before forming any hypothesis

060 GitHub stars

Use Cases

01Investigating complex system behaviors where the cause is not immediately obvious

02Diagnosing recurring bugs that keep returning after temporary patches

03Stabilizing flaky tests by identifying the true source of failure