handle-refactoring

Guide users through interactive code refactoring from a plan file.

4|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/alphaleonis/decaf-claude-config --skill handle-refactoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: handle-refactoring
Source: https://github.com/alphaleonis/decaf-claude-config/tree/main/decaf-review/skills/handle-refactoring
Command: npx skills add https://github.com/alphaleonis/decaf-claude-config --skill handle-refactoring

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of addressing code refactoring opportunities by guiding users through each suggestion one by one, ensuring controlled and informed code improvements.

Core Features & Use Cases

  • Interactive Refactoring: Walk through refactoring suggestions, applying them incrementally or all at once.
  • State Management: Resumes interrupted sessions by saving progress to a state file.
  • Use Case: After a code analysis identifies several refactoring opportunities, use this Skill to systematically review, approve, and apply each change, ensuring code quality is maintained without overwhelming the developer.

Quick Start

Use the handle-refactoring skill to process the refactoring plan found in the .refactoring-plans directory.

Frequently Asked Questions about handle-refactoring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I systematically apply multiple code refactoring suggestions without missing any?

Interactive refactoring guides you through code improvement suggestions one by one, presenting opportunities sequentially from a plan file. This ensures controlled, informed changes without overwhelming the developer during the refactoring process.

What is the best way to resume an interrupted code refactoring session?

Resuming a refactoring session relies on state management that saves progress to a state file. This allows you to resume interrupted interactive refactoring workflows exactly where you left off without losing your review status.

Can I skip or defer specific code refactoring opportunities and apply them later?

Yes, interactive refactoring offers options to apply, skip, dismiss, or defer specific code changes. You can incrementally apply suggestions while maintaining full control over which refactorings are executed during the session.

How do I review code refactoring opportunities after running an automated code analysis?

Post-analysis refactoring involves processing opportunities saved in a plan file. The skill presents each suggestion sequentially, offering code review suggestions after application to systematically verify that code quality is maintained.

Do I need a specific file format to start an interactive refactoring workflow?

You need refactoring plans stored as files in the .refactoring-plans directory. The interactive workflow reads these plan files to extract and present code refactoring opportunities one by one for your review.

Can I apply all suggested code refactorings at once instead of reviewing them individually?

Yes, while interactive refactoring presents opportunities one by one for controlled changes, it supports applying them all at once or incrementally. This allows you to balance automated code improvement with manual review preferences.