refactoring-catalog

Map code smells to Fowler's refactoring techniques with step-by-step workflows.

1|1|Updated Dec 27, 2025
One-click install
npx skills add https://github.com/emvnuel/SKILL.md --skill refactoring-catalog-emvnuel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactoring-catalog
Source: https://github.com/emvnuel/SKILL.md/tree/main/refactoring-catalog
Command: npx skills add https://github.com/emvnuel/SKILL.md --skill refactoring-catalog-emvnuel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill helps teams identify code smells and map them to refactoring techniques from Martin Fowler's Refactoring Catalog, guiding safe, measurable improvements to code structure without changing behavior.

Core Features & Use Cases

  • Detects common code smells such as Long Method, Replace Temp with Query, and Encapsulate Variable, and links them to Fowler's refactorings.
  • Provides a Cookbook-like collection of techniques with mechanical steps, examples, and best practices to apply in real projects.
  • Supports maintenance workflows by offering repeatable patterns for incremental improvement and risk reduction.

Quick Start

  • Scan a module to surface a primary code smell.
  • Open the relevant cookbook entry to follow the step-by-step refactoring plan.
  • Apply changes, run the test suite, and confirm behavior remains unchanged.

Frequently Asked Questions about refactoring-catalog

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I identify code smells and map them to Fowler's refactoring techniques?

To identify code smells and map them to Fowler's refactoring techniques, scan a module to surface primary smells like Long Method, then open the relevant cookbook entry to follow the step-by-step refactoring plan for safe structural improvement.

What is the best way to safely refactor code without changing its behavior?

The best way to safely refactor code without changing behavior is applying mechanical, step-by-step workflows from a refactoring catalog, running the test suite after changes to confirm functionality remains unchanged while reducing complexity.

When do I need to use a refactoring catalog for code maintenance?

You need a refactoring catalog for code maintenance when reducing complexity and refactoring safely is essential, offering repeatable patterns for incremental improvement and risk reduction in existing software projects.

How do I apply refactoring techniques like Replace Temp with Query in my project?

To apply refactoring techniques like Replace Temp with Query in your project, access the cookbook-style collection of techniques providing mechanical steps, examples, and best practices to execute changes safely and incrementally.

Does this refactoring catalog support incremental improvement workflows for large codebases?

Yes, this refactoring catalog supports incremental improvement workflows for large codebases by offering repeatable patterns for risk reduction, guiding measurable structural improvements through mechanical steps during maintenance.