Does this skill require a specific testing framework?

While it enforces the TDD workflow, it is designed to be compatible with various test runners like pytest, jest, or vitest as long as they can be executed via the command line.

Can I use this for non-bug tasks?

This skill is specifically optimized for defects. For new features, the 'test-driven-development' or general coding skills are more appropriate.

How does it handle bugs that cannot be reproduced?

The workflow includes a 'CANNOT_DETERMINE' status which prompts the user to gather more reproduction data rather than closing the issue prematurely.

Why is the 'Red Phase' mandatory in this workflow?

The Red Phase ensures the regression test actually reproduces the bug. If a test passes before the fix is applied, it isn't an effective guard against that specific bug returning.

Systematic Bug Fixing

Name: Systematic Bug Fixing
Author: withzombies

bywithzombies

•

Security & Testing

Automates a rigorous bug-fixing workflow including issue tracking, root-cause debugging, TDD regression testing, and verification.

The Systematic Bug Fixing skill provides a high-discipline framework for resolving software defects within Claude Code. It enforces a 'Low Freedom' workflow that mandates tracking every bug via issue management tools, performing deep root-cause analysis, and following a strict Red-Green Test-Driven Development (TDD) cycle. By requiring failing regression tests and full-suite verification before any issue is closed, this skill ensures that bugs are not just patched superficially but are permanently resolved and documented with verifiable evidence.

Key Features

01Mandatory Regression Testing: Enforces the TDD Red/Green cycle to ensure every fix is validated by a specific test case.

02Full Suite Verification: Guards against regressions by requiring a complete test suite pass before closing any bug.

0358 GitHub stars

04Strict Bug-Tracking Integration: Automatically manages issue creation, documentation, and closure status.

05Root-Cause Investigation: Orchestrates systematic debugging tools and codebase exploration to find the source, not just the symptom.

06Fix Status Classification: Requires evidence-based categorization of fixes as Fixed, Partially Fixed, or Not Addressed.

Use Cases

01Resolving complex logic errors with documented evidence and permanent regression protection.

02Ensuring production hotfixes are properly back-filled with tests and documentation after initial deployment.

03Systematizing the debugging process for team-wide consistency in issue tracking and resolution.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add withzombies/hyperpowers fixing-bugs

For use in Claude.ai and ChatGPT

Download Skill