modularize

What problem does it solve?

Large, monolithic files and tangled module boundaries make code hard to maintain, reason about, and scale. This Skill analyzes structural issues, identifies splitting candidates, detects circular dependencies, and produces a stepwise, verifiable plan to reorganize a codebase into clear modules or packages while minimizing disruption.

Core Features & Use Cases

• Structural analysis: Detects file size violations, complexity hotspots, god classes, coupling patterns, and circular dependency chains across Rust, Python, and JS/TS projects.
• Prioritized triage and planning: Filters findings by aggressiveness, ranks P1–P3 issues, collects user decisions, and produces incremental refactoring steps that compile and pass verification at each commit.
• Execution guidance and verification: Provides language-specific patterns, verification commands (cargo check, tsc --noEmit, ruff, pytest), and checks public API stability after changes.
• Uses: Split a 1000-line module into focused packages, remove barrel files and import cycles in a TypeScript app, or extract crates and compose structs in a Rust workspace.

Quick Start

Ask the modularize skill to analyze the src directory with moderate aggressiveness and produce a prioritized, verifiable refactoring plan.