refactor

Plan and execute incremental code refactors across modules with documentation artifacts.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/moveonha/pixel-ai-studio --skill refactor-moveonha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor
Source: https://github.com/moveonha/pixel-ai-studio/tree/main/.claude/skills/refactor
Command: npx skills add https://github.com/moveonha/pixel-ai-studio --skill refactor-moveonha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Refactoring is often performed without a clear plan or governance, leading to risky changes that drift over time. This Skill provides a structured, agent-enabled workflow to analyze code, generate 2-3 actionable refactoring options, and produce formal planning and metrics artifacts to guide safe implementation.

Core Features & Use Cases

  • Sequential thinking-driven analysis to scope refactors and identify priorities
  • Parallel agent collaboration (refactor-advisor, architect, code-reviewer, etc.) for faster planning
  • Automated documentation artifacts (ANALYSIS.md, PLAN.md, METRICS.md) to guide implementation and validation
  • Safe, staged execution with documented rollback guidance and success criteria

Quick Start

Describe the target module and let the Skill generate 2-3 refactoring options with corresponding documents.

Frequently Asked Questions about refactor

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

FAQPage Schema
How do I plan safe incremental code refactors without altering functionality?

Automated code complexity reduction uses sequential thinking-driven analysis to scope priorities and identify dependencies. It generates metrics artifacts to measure improvements and guide safe staged execution across modules.

How do I reduce code duplication across multi-file codebases?

Code refactor execution is safe when guided by generated artifacts including PLAN.md and METRICS.md. These documents provide documented rollback guidance and success criteria to prevent risky changes from drifting over time.

What is the best way to document architectural improvements during a refactor?

The best way to document architectural improvements is through automated artifact generation. The workflow outputs ANALYSIS.md, PLAN.md, and METRICS.md files to govern implementation, validate changes, and maintain team collaboration.

Can I use an agent-driven workflow for complexity reduction in existing modules?

Yes, you can use an agent-driven workflow for complexity reduction in existing modules. The process supports sequential thinking and parallel agent collaboration to analyze code and generate actionable refactoring scoped to your specific multi-file codebase.