Can I use this for languages other than JavaScript and TypeScript?

Yes. While the examples provided are in JS/TS, the refactoring principles, patterns, and safety checklists are applicable to almost any programming language.

Do I need existing tests to use the Refactor Assistant?

While it can provide advice on any code, the skill strongly advocates for a 'test-first' approach, guiding you to write tests before refactoring to ensure safety.

What common code smells can this skill help identify?

It helps detect and fix Long Methods, Duplicate Code, Long Parameter Lists, God Objects, Magic Numbers, and deeply Nested Conditionals.

Does this skill change the external behavior of my code?

No. The core philosophy of the Refactor Assistant is to improve internal code structure, readability, and maintainability while strictly preserving existing functionality.

How does it handle complex conditional logic?

The skill suggests techniques like 'Replace Conditional with Polymorphism' or the use of 'Guard Clauses' to flatten nested if/else blocks and make logic more readable.

Refactor Assistant

Name: Refactor Assistant
Author: a-ariff

bya-ariff

0•

Developer Tools

Improves code structure, readability, and maintainability by identifying code smells and applying systematic refactoring patterns.

Refactor Assistant is a specialized Claude Code skill designed to help developers systematically eliminate technical debt and improve software design without altering external behavior. It provides a structured methodology for identifying common code smells—such as Long Methods, God Objects, and Magic Numbers—and offers step-by-step guidance on applying safe refactoring techniques like function extraction, polymorphism, and guard clauses. By prioritizing test-driven workflows and small, incremental changes, this skill ensures that code improvements remain safe, predictable, and easy to maintain across any project or language.

Key Features

01Optimizes data processing by converting loops into readable pipelines

020 GitHub stars

03Identifies and remediates common code smells like duplication and long parameter lists

04Enforces a test-driven workflow to prevent behavioral regressions during cleanup

05Provides step-by-step guidance for safe refactoring techniques like Extract Function and Move Method

06Simplifies complex logic by replacing nested conditionals with guard clauses

Use Cases

01Breaking down monolithic 'God Objects' into modular, single-responsibility services

02Standardizing code patterns and improving naming conventions during code reviews

03Cleaning up legacy or spaghetti code before implementing new features

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add a-ariff/ariff-code-config refactor-assistant

For use in Claude.ai and ChatGPT

Download Skill