Can this skill be used with specific frameworks or languages?

Yes, it is language-agnostic and can even leverage custom 'Knowledge Packs' that contain framework-specific common errors, diagnostic commands, and known 'gotchas'.

Does the diagnosing skill use my Git history?

Yes, it specifically analyzes recent commits and diffs (e.g., the last 3-5 commits) to determine if a recent change to code, configuration, or dependencies is the likely source of the error.

What is the benefit of the hypothesis testing step?

By forming a single, testable hypothesis before applying changes, the skill avoids 'shotgun debugging' and ensures that the proposed solution actually addresses the root cause rather than just masking the symptoms.

How does this skill handle intermittent or flaky errors?

The skill performs multiple execution runs to identify patterns in succeeding versus failing attempts, gathering evidence at data boundaries to find the specific conditions that trigger the intermittent failure.

Systematic Debugging & Diagnosis

Name: Systematic Debugging & Diagnosis
Author: jugrajsingh

byjugrajsingh

0•

開発者ツール

Conducts systematic root cause investigations using evidence gathering and hypothesis-based testing to resolve complex software errors.

The diagnosing skill implements the 'Strike 1' phase of the unstuck protocol, providing a rigorous framework for identifying and resolving software bugs. It moves beyond guesswork by guiding Claude through a methodical process: analyzing full stack traces, establishing consistent reproduction steps, reviewing recent Git history, and tracing data flow across architectural boundaries. By enforcing a strict hypothesis-driven approach, the skill ensures that every proposed fix is backed by empirical evidence and minimal testing, preventing the introduction of regressions in complex codebases.

主な機能

01Automated Git diff and history review for regression detection

02Formal hypothesis testing to validate root causes before patching

03Comprehensive stack trace analysis and error categorization

040 GitHub stars

05Evidence-based boundary tracing to isolate data flow corruption

06Integration with knowledge packs for known pattern matching

ユースケース

01Identifying the specific commit or dependency change that introduced a regression

02Debugging cryptic stack traces or intermittent failures in legacy codebases

03Isolating state corruption bugs by tracing data at function and API boundaries

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jugrajsingh/skillgarden diagnosing

For use in Claude.ai and ChatGPT

Download Skill