Skip to main content
ClaudeWave
Skill860 repo starsupdated today

refactor

This Claude Code skill restructures existing code to enhance clarity and maintainability while preserving its external behavior. Use it when codebase readability has degraded through accumulated changes, when extracting repeated logic into reusable functions, when simplifying complex conditionals or deeply nested structures, or when renaming variables for consistency. The skill enforces test-driven refactoring by requiring tests to pass before and after modifications, preventing behavioral changes during restructuring.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/vstorm-co/pydantic-deepagents /tmp/refactor && cp -r /tmp/refactor/pydantic_deep/bundled_skills/refactor ~/.claude/skills/refactor
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# Refactor

Improve code structure without changing external behavior.

## Process

1. **Understand** — Read all related code, run existing tests
2. **Plan** — Identify what to change and why
3. **Execute** — Make changes incrementally
4. **Verify** — Run tests after each change

## Common Refactoring Patterns

### Extract
- Long function → smaller focused functions
- Repeated code → shared helper
- Magic numbers → named constants

### Simplify
- Deep nesting → early returns / guard clauses
- Complex conditionals → descriptive functions
- Large classes → smaller focused classes

### Rename
- Unclear names → descriptive names
- Inconsistent naming → consistent conventions

### Reorganize
- Related functions scattered → grouped in modules
- Circular dependencies → dependency inversion

## Rules

- Never change behavior — tests must pass before and after
- One refactoring type per commit
- If tests don't exist, write them first
- Don't refactor and add features in the same change