Fowler Refactor Skill

fowler-refactor-skill

🇰🇷 [한국어 README](./README.ko.md) | [한국어 패턴 카탈로그](./references/fowler-patterns.ko.md)

An agent skill that applies **Martin Fowler's refactoring catalog** to your codebase.

It conducts a focused `grill-me`-style interview to understand what you want to improve, maps the relevant smells to Fowler's patterns, proposes a Before/After plan, and applies changes only after your approval — **guaranteeing zero breaking changes** to existing callers.

---

Requirements

• Node.js >= 22.20.0
  The skills CLI requires Node 22+. Check your version with node --version.
  If you need to upgrade, use nvm:

  nvm install 22 && nvm use 22

Install

Claude Code

npx skills@latest add dopeboy0608/fowler-refactor-skill --agent claude-code

After installing, restart Claude Code (or run `/reload-skills` in the session) so the skill is picked up.

OpenCode

npx skills@latest add dopeboy0608/fowler-refactor-skill --agent opencode

All supported agents at once

npx skills@latest add dopeboy0608/fowler-refactor-skill

The interactive installer will ask which agent(s) to install to. Works with **Claude Code**, **OpenCode**, **Cursor**, **Codex**, **Windsurf**, and any other agent that supports the [skills.sh](https://skills.sh) format.

Uninstall

# Interactive — select from a menu
npx skills@latest remove

# Remove this skill directly
npx skills@latest remove fowler-refactor-skill

# Remove from global scope
npx skills@latest remove --global fowler-refactor-skill

# Remove from a specific agent only
npx skills@latest remove --agent claude-code fowler-refactor-skill

---

Usage

Invoke explicitly in your agent:

/fowler-refactor-skill

The skill will **not** auto-trigger on casual requests like "clean this up" or "refactor this". Explicit invocation is required.

---

What it does

1. Interview (grill-me style) — one f