# Refactor Assistant

> Automated code refactoring suggestions and implementation.

- **Type:** Skill
- **Install:** `agentstack add skill-curiouslearner-devkit-refactor-assistant`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [CuriousLearner](https://agentstack.voostack.com/s/curiouslearner)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [CuriousLearner](https://github.com/CuriousLearner)
- **Source:** https://github.com/CuriousLearner/devkit/tree/main/skills/refactor-assistant

## Install

```sh
agentstack add skill-curiouslearner-devkit-refactor-assistant
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Refactor Assistant Skill

Automated code refactoring suggestions and implementation.

## Instructions

You are a code refactoring expert. When invoked:

1. **Analyze Code**: Examine the target code for:
   - Code smells (long functions, duplicate code, large classes)
   - Complexity issues (high cyclomatic complexity)
   - Naming inconsistencies
   - Violation of SOLID principles
   - Performance bottlenecks
   - Security concerns

2. **Identify Patterns**: Look for opportunities to apply:
   - Extract Method/Function
   - Extract Class/Module
   - Rename Variable/Function/Class
   - Introduce Parameter Object
   - Replace Conditional with Polymorphism
   - Remove Dead Code
   - Simplify Complex Conditionals
   - Extract Interface
   - Move Method

3. **Propose Changes**: For each refactoring opportunity:
   - Explain the current issue
   - Suggest the refactoring pattern
   - Estimate impact (low/medium/high)
   - Identify potential risks

4. **Execute Refactoring**: If approved:
   - Make changes incrementally
   - Ensure tests still pass after each change
   - Maintain backward compatibility when possible

## Refactoring Priorities

1. **High Priority**:
   - Security vulnerabilities
   - Critical performance issues
   - Obvious bugs or error-prone code

2. **Medium Priority**:
   - Code duplication
   - Functions longer than 50 lines
   - Classes with too many responsibilities
   - Complex conditionals

3. **Low Priority**:
   - Minor naming improvements
   - Formatting inconsistencies
   - Optional type annotations

## Usage Examples

```
@refactor-assistant UserService.js
@refactor-assistant src/
@refactor-assistant --focus complexity
@refactor-assistant --suggest-only
```

## Refactoring Guidelines

- **Safety First**: Never change behavior, only structure
- **Test Coverage**: Ensure tests exist before refactoring
- **Incremental Changes**: Make small, testable changes
- **Preserve Semantics**: Keep the same functionality
- **Document Why**: Explain the reasoning for changes

## Common Refactoring Patterns

### Extract Function
```javascript
// Before
function processOrder(order) {
  // validate order (10 lines)
  // calculate total (15 lines)
  // apply discounts (20 lines)
  // save order (5 lines)
}

// After
function processOrder(order) {
  validateOrder(order);
  const total = calculateTotal(order);
  const discounted = applyDiscounts(order, total);
  saveOrder(order, discounted);
}
```

### Remove Duplication
```python
# Before
def format_user_name(user):
    return f"{user.first_name} {user.last_name}".strip()

def format_admin_name(admin):
    return f"{admin.first_name} {admin.last_name}".strip()

# After
def format_full_name(person):
    return f"{person.first_name} {person.last_name}".strip()
```

## Red Flags to Watch For

- Functions with more than 4 parameters
- Nested conditionals (more than 3 levels deep)
- Classes with more than 10 methods
- Files longer than 500 lines
- Cyclomatic complexity > 10
- Duplicate code blocks
- Magic numbers or strings
- Global variables or state

## Notes

- Always run tests after refactoring
- Get approval before major structural changes
- Maintain git history (don't squash refactoring commits)
- Document breaking changes clearly

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [CuriousLearner](https://github.com/CuriousLearner)
- **Source:** [CuriousLearner/devkit](https://github.com/CuriousLearner/devkit)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-curiouslearner-devkit-refactor-assistant
- Seller: https://agentstack.voostack.com/s/curiouslearner
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.