mcpbeat

Refactoring Patterns

cosmicstack-labs/refactoring-patterns

Systematic refactoring techniques, code smell elimination, pattern extraction, and legacy modernization

652 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
365
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/cosmicstack-labs/mercury-agent-skills --skill refactoring-patterns

The instruction itself

6 sections, as written by the author

Refactoring Patterns

Systematically improve code without changing its behavior.

The Refactoring Workflow

  • Identify a code smell or pain point
  • Ensure you have tests (write them first if not)
  • Apply one refactoring at a time
  • Test after each change (green = continue, red = revert)
  • Commit — small, focused, descriptive
  • Repeat

Extract Method

When: A method does multiple things or is too long.

How: Find a cohesive block → extract to new method → call it.

// Before
function processOrder(order) {
  const total = order.items.reduce((sum, i) => sum + i.price, 0);
  const tax = total * 0.08;
  const discount = order.coupon ? total * 0.1 : 0;
  return total + tax - discount;
}

// After
function processOrder(order) {
  const subtotal = calculateSubtotal(order);
  const tax = calculateTax(subtotal);
  const discount = calculateDiscount(order, subtotal);
  return subtotal + tax - discount;
}

Replace Conditional with Polymorphism

When: Switch/if-else chains based on type grow too long.

// Before
function calculateShipping(order) {
  if (order.type === 'standard') return order.weight * 0.5;
  if (order.type === 'express') return order.weight * 1.5 + 5;
  if (order.type === 'overnight') return order.weight * 3 + 15;
}

// After
class StandardShipping {
  calculate(weight) { return weight * 0.5; }
}
class ExpressShipping {
  calculate(weight) { return weight * 1.5 + 5; }
}

Legacy Code Strategy

  • Characterize with tests: Write tests that capture current behavior
  • Sprout method: Add new code in new methods, don't modify old
  • Wrap method: Wrap entire methods with new behavior (logging, caching)
  • Step-by-step: Extract small pieces over time
  • Strangler pattern: New code replaces old incrementally, old gets retired

Common Refactorings

| Refactoring | When | Risk |

|-------------|------|------|

| Rename Variable | Unclear name | Low |

| Extract Method | Long function | Low |

| Replace Magic Literal | Hard-coded values | Low |

| Introduce Parameter Object | Many parameters | Medium |

| Replace Temp with Query | Reused expressions | Low |

| Decompose Conditional | Complex condition | Medium |

| Extract Class | Class doing too much | Medium-High |

How to use it

Copy the folder

Take cosmicstack-labs/refactoring-patterns from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.