How does this skill prevent 'shotgun debugging'?

It requires Claude to find a root cause and create a reliable reproduction case before attempting any code changes, preventing random trial-and-error modifications.

What is the systematic debugging process?

It is a structured approach consisting of five steps: Reproduce, Isolate, Understand, Fix, and Verify. This ensures bugs are correctly identified and permanently resolved.

Can I use this with Test-Driven Development (TDD)?

Yes, this skill explicitly integrates with TDD by mandating the creation of a failing test that captures the bug before any fix is implemented.

What common mistakes does this skill help avoid?

It helps avoid 'symptom fixing' (patching the visible error without fixing the cause), deleting failing tests, and masking performance issues by simply increasing timeouts.

Systematic Debugging

Name: Systematic Debugging
Author: johnhanks1

byjohnhanks1

0•

Seguridad y Pruebas

Implements a rigorous, five-step diagnostic process to identify and resolve software bugs without guesswork or trial-and-error.

The Systematic Debugging skill transforms the debugging process from erratic 'shotgun debugging' into a disciplined engineering workflow. By enforcing a structured path—starting with reliable reproduction and isolation before moving to root-cause analysis—this skill ensures that Claude identifies why a failure occurs rather than just patching symptoms. It is particularly useful for complex codebases where regressions are common, as it integrates failure-driven testing and verification into every fix, ensuring long-term code stability and preventing common anti-patterns like timeout bumping or test removal.

Características Principales

01Prevention of anti-patterns like shotgun debugging and timeout bumping

02Root-cause analysis to ensure fixes address the source, not the symptom

03Automated regression testing and verification of fixes

040 GitHub stars

05Reliable bug reproduction through failing test cases

06Binary search isolation of issues within the call stack and data flow

Casos de Uso

01Standardizing troubleshooting workflows across a development team to improve code quality

02Fixing legacy bugs where the original implementation intent is unclear

03Diagnosing intermittent race conditions or complex logic errors in production code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add johnhanks1/vim-setup systematic-debugging

For use in Claude.ai and ChatGPT

Características Principales

01Prevention of anti-patterns like shotgun debugging and timeout bumping

02Root-cause analysis to ensure fixes address the source, not the symptom

03Automated regression testing and verification of fixes

040 GitHub stars

05Reliable bug reproduction through failing test cases

06Binary search isolation of issues within the call stack and data flow

Casos de Uso

01Standardizing troubleshooting workflows across a development team to improve code quality

02Fixing legacy bugs where the original implementation intent is unclear

03Diagnosing intermittent race conditions or complex logic errors in production code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add johnhanks1/vim-setup systematic-debugging

For use in Claude.ai and ChatGPT