How does it handle public APIs and breaking changes?

It utilizes backward compatibility strategies like adding new methods while deprecating old ones, using the adapter pattern, and providing clear migration documentation.

Can I use this skill on codebases without existing tests?

While possible, the skill's golden rule is to have tests before refactoring. It will suggest writing characterization tests first to ensure the behavior is locked in before changes begin.

What specific code smells can it identify?

It identifies categories such as Bloaters (long methods), Object-Orientation Abusers (switch statements), Change Preventers (shotgun surgery), and Dispensables (dead code).

What kind of output can I expect from the refactor skill?

The skill provides a structured response including the current issue, a proposed change technique, a step-by-step implementation plan, and a risk assessment.

Does this skill change the code's behavior?

No, the skill follows the core principle of refactoring: improving internal structure while preserving external behavior through incremental changes and rigorous testing.

Code Refactoring Expert

Name: Code Refactoring Expert
Author: Arthur742Ramos

byArthur742Ramos

0•

Herramientas para Desarrolladores

Refactors code systematically using design patterns and incremental changes while ensuring behavioral consistency and test coverage.

The Refactoring Expert skill transforms Claude into a specialized engineer focused on improving code maintainability and reducing technical debt. It identifies common code smells like bloaters, object-oriented abusers, and change preventers, then applies proven techniques such as method extraction or polymorphic replacement. By following a strict safe refactoring protocol—including mandatory test verification and backward compatibility strategies—this skill helps developers modernize legacy codebases and streamline complex logic without introducing regressions or breaking public APIs.

Características Principales

01Ensures backward compatibility for public APIs using adapters and deprecation paths

020 GitHub stars

03Enforces a safe, test-driven, incremental refactoring process

04Applies standard refactoring patterns such as Extract Method and Extract Class

05Identifies architectural code smells like bloaters and high coupling

06Generates structured refactoring plans with detailed risk assessments

Casos de Uso

01Modernizing legacy systems by breaking down large, monolithic classes

02Reducing technical debt and complexity before implementing new features

03Improving code readability and maintainability during architectural reviews

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add arthur742ramos/azure-codex refactor

For use in Claude.ai and ChatGPT

Download Skill