jamie-bitflight/refactor-plugin
plugins/plugin-creator/skills/refactor-plugin/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add jamie-bitflight/claude_skills refactor-pluginInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 30, 2026, 1:42 PM38.5s1 file scanned
SKILL.md
- name:
- refactor-plugin
- description:
- 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.
- argument-hint:
- <plugin-path>
- user-invocable:
- true
<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.jsonexists- 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 .
Related Skills
jamie-bitflight/xdg-base-directory
development
VerifiedTrustedCommunity
When an application needs to store config, data, cache, or state files. When designing where user-specific files should live. When code writes to ~/.appname or hardcoded home paths. When implementing cross-platform file storage with platformdirs.
39SKILL.mdUpdated Apr 30, 2026
jamie-bitflight/verification-gate
testing
VerifiedTrustedCommunity
Enforce mandatory pre-action verification checkpoints to prevent pattern-matching from overriding explicit reasoning. Use this skill when about to execute implementation actions (Bash, Write, Edit) to verify hypothesis-action alignment. Blocks execution when hypothesis unverified or action targets different system than hypothesis identified. Critical for preventing cognitive dissonance where correct diagnosis leads to wrong implementation.
39SKILL.mdUpdated Apr 30, 2026
jamie-bitflight/twelve-factor-app
tools
VerifiedTrustedCommunity
Reference guide for the Twelve-Factor App methodology — 15 principles (12 original + 3 modern extensions) for building portable, resilient, cloud-native applications. Use when evaluating application architecture, designing cloud-native services, reviewing codebases for methodology compliance, advising on configuration, scaling, observability, security, and deployment patterns. Incorporates the 2025 open-source community evolution and cloud-native reinterpretations of each factor.
39SKILL.mdUpdated Apr 30, 2026
jamie-bitflight/user-docs-to-ai-skill
tools
VerifiedTrustedCommunity
Converts user-facing documentation (how-to guides, tutorials, API references, examples) in any format — Markdown, PDF, DOCX, PPTX, XLSX, AsciiDoc, RST, HTML, Jupyter notebooks, man pages, TOML/YAML/JSON configs, and plain text — into Claude Code skill directories with SKILL.md plus thematically grouped references/*.md files. Use when given a docs directory or mixed-format documentation to transform into an AI skill. Uses MCP file-reader server for binary formats.
39SKILL.mdUpdated Apr 30, 2026