Can I use this for plugins in any programming language?

Yes, as long as the plugin follows the Claude Code plugin structure, the refactoring workflow can analyze and plan improvements regardless of the underlying language.

How do I start the refactoring implementation?

After running the refactor command and reviewing the plan, you use the /plugin-creator:implement-refactor command to begin the actual code changes.

What does the Refactor Plugin skill do?

It manages a complete workflow for improving Claude Code plugins, including automated analysis, design planning, and task execution.

What are the requirements to use this skill?

The target directory must be a valid Claude plugin containing either a .claude-plugin/plugin.json file or a skills/ directory.

Does this skill automatically change my plugin code?

No, it first generates a comprehensive Assessment Report and Task File for your review. You must manually approve the plan before execution begins.

Plugin Refactoring Workflow

Name: Plugin Refactoring Workflow
Author: Jamie-BitFlight

byJamie-BitFlight

•

Productivity & Workflow

Automates the end-to-end process of analyzing, planning, and executing structural refactors for Claude Code plugins.

The Plugin Refactoring Workflow provides a systematic framework for modernizing and optimizing Claude Code plugins. It handles the complex task of auditing existing plugin structures, identifying architectural technical debt, and generating a comprehensive refactoring design map. By breaking down the refactoring process into logical phases—Assessment, Design, Planning, Execution, and Validation—it ensures that plugin improvements are handled with high precision and minimal risk to existing functionality.

Key Features

01Built-in validation to ensure post-refactor quality

02Orchestrates specialized agents for code execution

03Generates detailed refactoring design specifications and maps

04Automated plugin structure and dependency assessment

05Creates actionable task files with dependency tracking

0618 GitHub stars

Use Cases

01Restructuring monolithic plugins into modular, skill-based architectures

02Modernizing legacy Claude Code plugins to follow current best practices

03Systematically improving plugin documentation and argument handling

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamie-bitflight/claude_skills refactor-plugin

For use in Claude.ai and ChatGPT

Download Skill