Skills
.Work. You
Rest

refactoring-surgeon

Community

Refactor code safely, improve quality.

Software Engineering#refactoring#cleanup#solid#code-smells#dry#legacy-migration
Authorerichowens
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Expert in code refactoring and software modernization. Helps teams identify and address code smells, apply safe, incremental refactorings, and migrate legacy codebases without changing observable behavior. Provides a structured safety checklist, cross-cut references to proven patterns, and guidance for progressively disclosing complex refactor steps.

Core Features & Use Cases

  • Anti-patterns coverage: Bloaters, OO Abusers, Change Preventers, and more with actionable fixes.
  • Refactoring patterns: Extraction, Movement, Simplification, Organization, and Legacy Migration strategies (e.g., Strangler Fig, Introduce Parameter Object).
  • Safety-first workflow: tests-first approach, change-by-change with clear rollback and documentation.
  • Reference examples: complete "Before" and "After" refactoring examples in ./references/ to aid learning and reproducibility.
  • Dependency-aware guidance: promotes deterministic steps and traceable changes to reduce risk.

Quick Start

Use the refactoring skill to structure a legacy module into smaller, testable pieces and validate behavior after each change.

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: refactoring-surgeon
Download link: https://github.com/erichowens/some_claude_skills/archive/main.zip#refactoring-surgeon

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.