How does the skill estimate the effort for a fix?

It uses a standardized tagging system ranging from [Quick] (under 30 mins) to [Large] (over a day), helping developers understand the architectural impact of a proposed solution.

How does the hypothesis ranking help in debugging?

It prevents 'tunnel vision' by forcing the analysis of multiple potential causes (Most Likely, Possible, Unlikely), each requiring specific evidence and a verification test before implementation.

What are Heisenbugs and can this skill find them?

Heisenbugs are intermittent failures that change behavior when studied. This skill uses systematic timing and state analysis to isolate race conditions and async issues that cause them.

When does the Debugger skill trigger?

It triggers automatically after two failed fix attempts, or can be manually invoked using keywords like 'ultradebug' or 'uld' when facing complex or intermittent system failures.

Systematic Debugger

Name: Systematic Debugger
Author: TechDufus

byTechDufus

•

Analytics & Monitoring

Provides a rigorous, hypothesis-driven methodology for diagnosing complex software failures and identifying root causes.

The Systematic Debugger skill equips Claude with a structured framework for handling persistent bugs, intermittent failures (Heisenbugs), and complex integration issues. Instead of trial-and-error, it forces a disciplined approach: restating the problem to challenge assumptions, generating multiple ranked hypotheses with specific verification tests, and applying a weighted decision framework to choose the most effective solution. This skill is essential for breaking out of 'debugging circles' and ensuring that the underlying cause of an issue is addressed rather than just its symptoms.

Key Features

0179 GitHub stars

02Structured 'Step-by-Step' analysis framework for complex failures

03Ranked hypothesis generation with evidence-based verification

04Effort estimation tagging (Quick, Short, Medium, Large) for proposed fixes

05Detection of common failure patterns like Fix-break cycles and Integration hell

06Weighted decision framework prioritizing correctness, simplicity, and leverage

Use Cases

01Diagnosing intermittent failures and race conditions that are hard to reproduce

02Breaking out of circular debugging loops after multiple failed fix attempts

03Analyzing multi-system integration problems where the source of failure is unclear

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add techdufus/oh-my-claude debugger

For use in Claude.ai and ChatGPT

Download Skill