Code Refactoring Skill

A stable refactoring skill for any AI coding agent. Safe, incremental, behavior-preserving code improvements for any programming language.

Works with Claude Code, Cursor, Aider, Continue, GitHub Copilot, OpenAI Assistants, or any LLM that accepts a system prompt.

Built on Martin Fowler’s refactoring catalog, extended with modern patterns for functional programming, async/await, reactive systems, dependency injection, and architectural patterns (MVVM, MVP, Clean Architecture, Hexagonal, Repository, Use Case).

---

What It Does

• Detects code smells across 6 families (Bloat, OO Abusers, Change Preventers, Dispensables, Couplers, Architectural Violations)
• Applies 70+ refactoring operations from the complete Fowler catalog + modern patterns + architectural patterns
• Handles architectural refactoring — safely migrates toward MVVM, MVP, Clean Architecture, Repository pattern, and more
• Works in any language — TypeScript, Python, Go, Rust, Java, Kotlin, C#, Swift, Ruby, C/C++, SQL, and more
• Tests gate every step — runs your test suite after each change; reverts immediately on failure
• One operation at a time — no bundled changes, every step is independently verifiable
• Safety-first — explicit red lines for public APIs, serialization formats, concurrent code, and architectural layer violations

---

Installation

Interactive installer

npx code-refactoring-skill

Prompts for:

1. Scope — Global (home dir, all projects) or Project (current directory)
2. Agent(s) — pick one, several, or all

Manual install (any agent)

Copy PROMPT.md into your agent’s system prompt, custom instructions, or rules file. That’s the complete self-contained skill — no other files needed.

curl -O https://raw.githubusercontent.com/MuhiminOsim/code-refactoring-skill/main/PROMPT.md

For a generic global install:

mkdir -p ~/.agents/skills/refactor