Can I use this skill to fix bugs while refactoring?

No. Refactoring is strictly for improving structure without changing behavior. If you need to fix a bug, you should use a dedicated debugging workflow before or after the refactoring process.

Is an existing test suite required?

Yes. Refactoring without tests is high-risk. This skill requires a passing test suite to verify that your changes haven't altered the software's functional behavior.

How does this skill handle large-scale code changes?

It breaks large changes into the smallest possible compilable units. For massive architectural shifts, it utilizes the Strangler Fig pattern to incrementally replace logic while keeping the system operational.

What happens if a test fails during the refactoring process?

The skill mandates an immediate stop. You must undo the last change, revert to the last known 'green' state, and attempt a smaller or different transformation to ensure tests stay passing.

Safe Code Refactoring

Name: Safe Code Refactoring
Author: Veraticus

byVeraticus

0•

Productivity & Workflow

Improves code structure and readability through a strict incremental cycle that ensures functional integrity with automated testing.

Safe Code Refactoring provides a disciplined, step-by-step workflow for Claude Code to modernize and clean up codebases without introducing regressions. By enforcing a strict 'Change → Test → Commit' cycle, the skill ensures that every transformation—such as extracting methods, renaming variables, or simplifying logic—is validated against existing test suites. It is specifically designed to help developers manage technical debt and improve software architecture while maintaining a 100% green test status throughout the entire process.

Key Features

010 GitHub stars

02Pre-configured rollback triggers for any failing test scenarios

03Support for advanced patterns like the Strangler Fig for legacy migration

04Strict enforcement of the Change-Test-Commit cycle

05Integrated task tracking for multi-step architectural changes

06Automated test verification before and after every transformation

Use Cases

01Reducing cyclomatic complexity in legacy methods while preserving behavior

02Extracting duplicated logic into reusable utility functions or modules

03Improving code clarity through safe, multi-file renaming and reorganization

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add veraticus/gambit refactoring

For use in Claude.ai and ChatGPT

Download Skill