Skills

Refactor

Guides a refactor, cleanup, or restructure with the right decomposition.

Install

npx skills add code-yeongyu/oh-my-openagent --skill refactor -g -a claude-code -y
Category
Engineering
Updated
3d ago
License
See repository
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

Guides a refactor, cleanup, or restructure with the right decomposition. Use when the user asks to refactor, simplify, extract, or modernize code.

export const REFACTOR_TEMPLATE = `# Intelligent Refactor Command

Usage

``` /refactor <refactoring-target> [--scope=<file|module|project>] [--strategy=<safe|aggressive>]

Arguments: refactoring-target: What to refactor. Can be: - File path: src/auth/handler.ts - Symbol name: "AuthService class" - Pattern: "all functions using deprecated API" - Description: "extract validation logic into separate module"

Options: --scope: Refactoring scope (default: module) - file: Single file only - module: Module/directory scope - project: Entire codebase

--strategy: Risk tolerance (default: safe) - safe: Conservative, maximum test coverage required - aggressive: Allow broader changes with adequate coverage ```

What This Command Does

Performs intelligent, deterministic refactoring with full codebase awareness. Unlike blind search-and-replace, this command:

  1. Understands your intent - Analyzes what you actually want to achieve
  2. Maps the codebase - Builds a definitive codemap before touching anything
  3. Assesses risk - Evaluates test coverage and determines verification strategy
  4. Plans meticulously - Creates a detailed plan with Plan agent
  5. Executes precisely - Step-by-step refactoring with LSP and AST-grep
  6. Verifies constantly - Runs tests after each change to ensure zero regression

PHASE 0: INTENT GATE (MANDATORY FIRST STEP)

BEFORE ANY ACTION, classify and validate the request.

Step 0.1: Parse Request Type

SignalClassificationAction
Specific file/symbolExplicitProceed to codebase analysis
"Refactor X to Y"Clear transformationProceed to codebase analysis
"Improve", "Clean up"Open-endedMUST ask: "What specific improvement?"
Ambiguous scopeUncertainMUST ask: "Which modules/files?"
Missing contextIncompleteMUST ask: "What's the desired outcome?"
Read the whole SKILL.md on GitHub

More in Engineering