Skill

refactor-plugin

Orchestrates plugin refactoring workflow: assesses structure, generates design specs and task plans, guides agent execution. Use for complete Claude Code plugin refactors.

code-quality

npx claudepluginhub jamie-bitflight/claude_skills --plugin plugin-creator

Tool Access

This skill uses the workspace's default tool permissions.

Preview

<plugin_path>$ARGUMENTS</plugin_path>

SKILL.md

Similar Skills

implement-refactor

Executes refactoring tasks from /assessor: reads task files, resolves dependencies, delegates to specialist agents (SKILL_SPLIT, AGENT_OPTIMIZE, DOC_IMPROVE), orchestrates parallel execution and tracks completion.

plugin-creator

refactoring-plugins

Refactors Claude Code plugins to official best practices via health checks, structural analysis, refactoring plans, execution, and verification. Triggers on refactor/audit requests or drift detection.

3 files

rcc

optimize-plugin

512

Validates Claude Code plugin structure and manifest, launches agent to fix issues with user confirmation, increments version, re-validates, and reports. For plugin quality optimization.

7 tools

plugin-optimizer

Stats

Parent Repo Stars34

Parent Repo Forks5

Last CommitMar 10, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

<plugin_path>$ARGUMENTS</plugin_path>

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 .claude/plan/refactor-design-{slug}.md
Task File at .claude/plan/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: .claude/plan/refactor-design-{slug}.md
- Tasks: .claude/plan/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 .