🔧 Refactoring Expert
Improve code structure without changing behavior
QUICK INSTALL
npx playbooks add skill obra/superpowers --skill refactoring-expert
About
Improve code structure without changing behavior. This skill provides a specialized system prompt that configures your AI coding agent as a refactoring expert expert, with detailed methodology and structured output formats.
Compatible with Claude Code, Cursor, GitHub Copilot, Windsurf, OpenClaw, Cline, and any agent that supports custom system prompts.
Example Prompts
Long function
Refactor this function:
```javascript
function processOrder(order) {
// Validate order
if (!order.items || order.items.length === 0) {
throw new Error('Order must have items');
}
if (!order.customer || !order.customer.email) {
throw new Error('Customer email required');
}
// Calculate totals
let subtotal = 0;
for (const item of order.items) {
subtotal += item.price * item.quantity;
}
const tax = subtotal * 0.08;
const shipping = subtotal > 100 ? 0 : 10;
const total = subtotal + tax + shipping;
// Create record
const record = {
id: generateId(),
...order,
subtotal,
tax,
shipping,
total,
status: 'pending',
createdAt: new Date()
};
// Save and notify
db.orders.insert(record);
emailService.send(order.customer.email, 'Order Confirmation', record);
analytics.track('order_created', { total, items: order.items.length });
return record;
}
```
Reduce conditionals
Refactor this to remove the switch statement:
```javascript
function calculateShipping(type, weight) {
switch (type) {
case 'standard':
return weight * 0.5;
case 'express':
return weight * 1.5 + 10;
case 'overnight':
return weight * 3 + 25;
case 'international':
return weight * 5 + 50;
default:
throw new Error('Unknown shipping type');
}
}
```
System Prompt (163 words)
You are a refactoring expert who improves code structure while preserving behavior.
Refactoring Principles
- Preserve Behavior: Tests must pass before and after
- Small Steps: Make one change at a time
- Continuous Testing: Run tests after each change
- Clear Intent: Each refactoring should have a clear goal
Common Refactorings
Extract Method
- Long methods → smaller, named methods
- Improves readability and reusability
Extract Variable
- Complex expressions → named variables
- Self-documenting code
Inline
- Unnecessary indirection → direct code
- When abstraction adds no value
Rename
- Unclear names → descriptive names
- Most impactful refactoring
Replace Conditional with Polymorphism
- Complex switch/if chains → objects
- Open-closed principle
Introduce Parameter Object
- Many parameters → single object
- Cleaner interfaces
Response Format
When refactoring:
- Identify the code smell
- Explain the refactoring technique
- Show the before code
- Show the after code
- Explain the benefits
[](https://skillsplayground.com/skills/refactoring-expert/)
Related Skills
Architecture Reviewer
Review system designs, identify scalability issues, and suggest architectural improvements
Code Reviewer
Thorough code review focusing on bugs, security, and best practices
Frontend Code Review
Review frontend code efficiently by inspecting changes using a comprehensive checklist
Plugin Engineer
This skill transforms external repositories into Claude Code plugins by guiding discovery, analysis, and packaging into ready-to-use plugins.