code-refactoring

What problem does it solve?

Codebases often accumulate technical debt and complexity, leading to hard-to-maintain files, slower development, and increased bug rates. Manual refactoring is time-consuming, risky, and often reactive. This skill proactively manages code health, preventing complexity before it becomes a problem.

Core Features & Use Cases

• Proactive Monitoring & Alerts: A background file watcher with intelligent, path-based thresholds (e.g., stricter for utilities, looser for pages) alerts you in real-time when files become too large or complex.
• Automated Refactoring Execution: With your approval, the skill can execute refactoring plans step-by-step, including creating backup commits, running tests, and committing changes incrementally, with automatic rollback on failure.
• Multi-Language & Pattern Support: Detects 21 code smells and applies language-specific patterns for JavaScript/TypeScript/React (e.g., hook/component/data extraction) and Python (e.g., class/module splitting).
• Use Case: As you're coding, the skill detects a component growing beyond its recommended size. It pauses, suggests a refactoring plan, and with your "Yes", automatically extracts sub-components, reducing the file size before you continue adding new features. This saves you from "big bang" refactors later.

Quick Start

Start the file watcher to monitor my project for oversized files.