Does it provide documentation for the fixes applied?

The skill provides a clear state summary including reproduction steps, the hypothesis formed, and the verification steps taken to confirm the fix.

Can this skill help with failing unit tests?

Yes, it is specifically designed to analyze test failures, reproduce them in a minimal environment, and apply the smallest possible fix to pass the test.

How does it prevent bugs from coming back?

The workflow includes adding guardrails such as assertions, validations, or targeted tests as the final step of the debugging process.

How does the Systematic Debugging skill improve bug fixing?

It replaces guesswork with a scientific methodology that includes reproduction, evidence collection, hypothesis testing, and rigorous validation.

Will it refactor my entire file to fix a bug?

No, the skill's output expectations prioritize minimal diffs over broad refactors to maintain codebase stability.

Systematic Debugging

Name: Systematic Debugging
Author: rozwer

byrozwer

0•

Security & Testing

Implements a rigorous, step-by-step methodology for isolating, fixing, and validating software bugs and test failures.

The Systematic Debugging skill provides Claude with a structured framework to resolve technical issues with scientific precision. Instead of relying on trial-and-error, it guides the AI through a logical progression of capturing exact reproduction steps, gathering evidence from logs and stack traces, localizing the root cause, and testing falsifiable hypotheses. This approach ensures that bugs are not just patched but fully understood, resulting in minimal diffs, validated fixes, and the implementation of guardrails to prevent future regressions.

Key Features

010 GitHub stars

02Automated validation and regression guardrail implementation

03Evidence-based root cause analysis using logs and traces

04Reliable bug reproduction and environment environment capture

05Minimalist code modification to reduce technical debt

06Scientific hypothesis testing to isolate specific failure points

Use Cases

01Troubleshooting logic errors in unfamiliar or legacy codebases

02Resolving intermittent test failures in complex CI/CD pipelines

03Identifying and fixing the root cause of performance regressions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rozwer/cross2b-pro systematic-debugging

For use in Claude.ai and ChatGPT

Download Skill