How does this skill prevent breaking my code?

The skill enforces a 'Mandatory Stop' policy, requiring your explicit approval via an interactive prompt before any changes are applied. It also offers an incremental mode to verify changes step-by-step.

Does it support automated testing after a refactor?

After applying changes, the skill prompts you to run a quick code review or verification step to ensure the modifications haven't introduced any immediate issues.

Can I save a refactoring suggestion for a later sprint?

Yes. The skill includes a 'Defer' option that can automatically create work items in your project's tracking system, such as GitHub Issues, Azure DevOps, or simple TODO comments.

What happens if I have a long list of refactorings to review?

The skill saves its progress to a local state file. If the session is interrupted or the AI context is cleared, it can resume exactly where you left off by reading the state from the .refactoring-plans folder.

Interactive Refactoring Handler

Name: Interactive Refactoring Handler
Author: alphaleonis

byalphaleonis

0•

Developer Tools

Manages code refactoring tasks interactively by processing plan units one-by-one with mandatory user approval.

The handle-refactoring skill provides a structured, human-in-the-loop workflow for implementing complex code improvements. Instead of allowing the AI to rewrite files autonomously, this skill parses generated refactoring plans, presents each opportunity with before-and-after sketches, and maintains persistent state to ensure progress is never lost during long sessions or context resets. It supports incremental implementation, deferring tasks to external issue trackers, and automated post-change verification to ensure code quality throughout the refactoring process.

Key Features

010 GitHub stars

02Integration with project tracking systems to defer tasks for later

03Incremental 'Apply' mode for step-by-step verification of complex changes

04One-by-one unit processing to prevent complex, error-prone batch updates

05Mandatory user approval for every code modification to ensure safety

06Persistent state tracking to resume sessions after context compaction or resets

Use Cases

01Systematically addressing technical debt across multiple files

02Safely executing architectural migrations with manual oversight

03Managing large-scale code cleanups that span multiple development sessions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alphaleonis/decaf-claude-config handle-refactoring

For use in Claude.ai and ChatGPT

Key Features

010 GitHub stars

02Integration with project tracking systems to defer tasks for later

03Incremental 'Apply' mode for step-by-step verification of complex changes

04One-by-one unit processing to prevent complex, error-prone batch updates

05Mandatory user approval for every code modification to ensure safety

06Persistent state tracking to resume sessions after context compaction or resets

Use Cases

01Systematically addressing technical debt across multiple files

02Safely executing architectural migrations with manual oversight

03Managing large-scale code cleanups that span multiple development sessions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add alphaleonis/decaf-claude-config handle-refactoring

For use in Claude.ai and ChatGPT