What problem does it solve?
Codebases accumulate complexity through deep nesting, duplication, dead code, and premature abstractions, making them hard to maintain and extend. This Skill enforces an analysis-first workflow that diagnoses complexity sources and produces an approved simplification plan before any code changes.
Core Features & Use Cases
- Complexity Analysis: Identifies nesting, duplication, coupling, over-engineering, and magic values, then applies an existence check to determine whether code can be deleted, delegated to the standard library, or replaced by platform features.
- Prioritized Simplification Patterns: Applies extract, consolidate, flatten, decouple, remove, replace, defer, and redesign patterns ranked by impact and risk, with before/after snippets requiring user approval.
- Readability Validation: Uses a bundled readability guide and a four-question Reading Test to ensure simplified code stays understandable for new team members.
- Use Case: When a legacy module has grown into deeply nested conditionals with duplicated logic, use this Skill to analyze the complexity sources, propose a prioritized refactoring plan, and only modify code after you approve the approach.
Quick Start
Ask the agent to analyze the complexity of a specific module and propose a prioritized simplification plan without changing any code yet.
