How does it help with complex nested IF statements?

It utilizes 'Guard Clauses' and early return patterns to flatten logic, making the code much easier to follow and maintain.

Can I use this skill on legacy codebases without tests?

The skill strongly recommends establishing a test suite before refactoring to ensure no regressions occur, though it can provide guidance on how to safely wrap legacy code in tests.

Is this skill limited to a specific programming language?

While the examples provided are in TypeScript, the refactoring principles such as Extract Method and Polymorphism are universal concepts applicable to most modern programming languages.

Does this skill change how my code functions?

No, the primary goal of refactoring is to improve the internal structure and readability of the code without changing its external behavior.

What kind of 'Code Smells' can this skill identify?

It specializes in identifying long methods, deeply nested conditionals (Arrow Code), primitive obsession, magic numbers, and feature envy.

Code Refactoring Expert

Name: Code Refactoring Expert
Author: julianromli

byjulianromli

•

101

•

Developer Tools

Improves code quality and maintainability by identifying code smells and applying proven structural transformation patterns.

This skill equips Claude with a comprehensive framework for transforming legacy code into clean, readable, and maintainable systems without altering external behavior. It provides specific guidance on detecting common architectural flaws like 'Arrow Code,' primitive obsession, and feature envy, while offering step-by-step techniques for safe resolution. By emphasizing a test-driven approach and incremental changes, the skill ensures that developers can reduce technical debt and complexity with minimal risk, making it an essential companion for feature preparation and code reviews.

Key Features

01101 GitHub stars

02Conversion of magic numbers into descriptive, maintainable constants

03Identification and elimination of 'Code Smells' like long methods and deep nesting

04Safety-first refactoring workflows prioritizing test coverage and small commits

05Logic simplification through guard clauses and polymorphic replacements

06Automated patterns for extracting methods and introducing parameter objects

Use Cases

01Cleaning up complex legacy modules before implementing new functional requirements

02Refactoring deeply nested conditional logic to improve readability and testability

03Modernizing codebase architecture by replacing primitive types with domain-specific value objects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add julianromli/opencode-template code-refactoring

For use in Claude.ai and ChatGPT

Download Skill