How do I install the Refactor Plugin skill?

Run npx skillmds@latest add jamie-bitflight/refactor-plugin in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Refactor Plugin safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Refactor Plugin?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Refactor Plugin free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Refactor Plugin?

Jamie-BitFlight (@jamie-bitflight) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Refactor Plugin by jamie-bitflight — Agent Skill

Name: Refactor Plugin
Rating: 4.5 (4 reviews)
Author: Jamie-BitFlight

Refactor Plugin

Start a complete plugin refactoring workflow that analyzes plugin structure, creates a refactoring plan with tasks, and guides through execution. Use when you need to refactor an entire plugin — triggers assessment, design, planning, and parallel agent execution phases.

File contents

If the user's intent does not match the purpose of this skill, load plugin-lifecycle to route to the right skill and process: Skill(skill="plugin-creator:plugin-lifecycle").

$ARGUMENTS

Plugin Refactoring Workflow

Start a comprehensive plugin refactoring workflow for the specified plugin.

Arguments

<plugin_path/>: Path to the plugin directory to refactor (e.g., ./plugins/python3-development)

Workflow Overview

This command orchestrates the complete refactoring workflow:

Assessment - Analyze plugin structure and identify issues
Design - Create refactoring design specification
Planning - Generate task file with dependencies
Execution - Run tasks via specialized agents
Validation - Verify refactoring quality

Instructions

Step 1: Validate Input

If no plugin path provided:

ERROR: No plugin path provided.
Usage: /plugin-creator:refactor <plugin-path>
Example: /plugin-creator:refactor ./plugins/python3-development

Step 2: Verify Plugin Exists

Check that the path contains a valid plugin:

.claude-plugin/plugin.json exists
OR skills/ directory exists

Step 3: Run Assessment

Invoke the assessor skill to analyze the plugin:

Skill(skill="plugin-creator:assessor", args="<plugin_path/>")

This generates:

Plugin Assessment Report
Refactoring Design Map at .plugin-creator/plans/refactor-design-{slug}.md
Task File at .plugin-creator/plans/tasks-refactor-{slug}.md

Step 4: Review Plan

After assessment completes, display:

================================================================================
                    REFACTORING PLAN READY FOR REVIEW
================================================================================

Plugin: <plugin_path/>
Assessment Score: [X/100]

Plan Files Created:
- Design: .plugin-creator/plans/refactor-design-{slug}.md
- Tasks: .plugin-creator/plans/tasks-refactor-{slug}.md

Tasks Summary:
- Total tasks: [N]
- Skill splits: [N]
- Agent optimizations: [N]
- Documentation improvements: [N]

Next Steps:
1. Review the plan files
2. Run `/plugin-creator:implement-refactor {slug}` to execute
================================================================================

Step 5: Await User Decision

Ask user:

Continue: Proceed to implementation
Review: Open plan files for review
Abort: Cancel refactoring

Related Commands

/plugin-creator:implement-refactor - Execute tasks from plan
/plugin-creator:ensure-complete - Validate completed refactoring
/plugin-creator:count-lines - Quick line count check

Example Usage

# Start refactoring a plugin
/plugin-creator:refactor ./plugins/python3-development

# Start refactoring current directory plugin
/plugin-creator:refactor .

---name: refactor-plugindescription: Start a complete plugin refactoring workflow that analyzes plugin structure, creates a refactoring plan with tasks, and guides through execution. Use when you need to refactor an entire plugin — triggers assessment, design, planning, and parallel agent execution phases.---If the user's intent does not match the purpose of this skill, load `plugin-lifecycle` to route to the right skill and process: `Skill(skill="plugin-creator:plugin-lifecycle")`.<plugin_path>$ARGUMENTS</plugin_path># Plugin Refactoring WorkflowStart a comprehensive plugin refactoring workflow for the specified plugin.## Arguments- `<plugin_path/>`: Path to the plugin directory to refactor (e.g., `./plugins/python3-development`)## Workflow OverviewThis command orchestrates the complete refactoring workflow:1. **Assessment** - Analyze plugin structure and identify issues2. **Design** - Create refactoring design specification3. **Planning** - Generate task file with dependencies4. **Execution** - Run tasks via specialized agents5. **Validation** - Verify refactoring quality## Instructions### Step 1: Validate InputIf no plugin path provided:```textERROR: No plugin path provided.Usage: /plugin-creator:refactor <plugin-path>Example: /plugin-creator:refactor ./plugins/python3-development```### Step 2: Verify Plugin ExistsCheck that the path contains a valid plugin:- `.claude-plugin/plugin.json` exists- OR `skills/` directory exists### Step 3: Run AssessmentInvoke the assessor skill to analyze the plugin:```textSkill(skill="plugin-creator:assessor", args="<plugin_path/>")```This generates:- Plugin Assessment Report- Refactoring Design Map at `.plugin-creator/plans/refactor-design-{slug}.md`- Task File at `.plugin-creator/plans/tasks-refactor-{slug}.md`### Step 4: Review PlanAfter assessment completes, display:```text================================================================================ REFACTORING PLAN READY FOR REVIEW================================================================================Plugin: <plugin_path/>Assessment Score: [X/100]Plan Files Created:- Design: .plugin-creator/plans/refactor-design-{slug}.md- Tasks: .plugin-creator/plans/tasks-refactor-{slug}.mdTasks Summary:- Total tasks: [N]- Skill splits: [N]- Agent optimizations: [N]- Documentation improvements: [N]Next Steps:1. Review the plan files2. Run `/plugin-creator:implement-refactor {slug}` to execute================================================================================```### Step 5: Await User DecisionAsk user:- **Continue**: Proceed to implementation- **Review**: Open plan files for review- **Abort**: Cancel refactoring## Related Commands- `/plugin-creator:implement-refactor` - Execute tasks from plan- `/plugin-creator:ensure-complete` - Validate completed refactoring- `/plugin-creator:count-lines` - Quick line count check## Example Usage```bash# Start refactoring a plugin/plugin-creator:refactor ./plugins/python3-development# Start refactoring current directory plugin/plugin-creator:refactor .```

Frequently asked questions