What problem does it solve? Working code often accumulates unnecessary complexity — deep nesting, long functions, unclear names, and duplicated logic — that slows down every future change. This Skill provides a disciplined process for simplifying code without altering its behavior, so refactors stay safe, reviewable, and consistent with project conventions. ## Core Features & Use Cases - Behavior-Preserving Refactoring: Applies five principles (preserve behavior, follow project conventions, prefer clarity, maintain balance, scope to changes) so simplification never changes inputs, outputs, side effects, or error handling. - Concrete Pattern Detection: Identifies specific simplification signals such as 3+ level nesting, 50+ line functions, nested ternaries, boolean parameter flags, generic names, dead code, and over-engineered abstractions, each paired with a concrete fix. - Incremental Verified Workflow: Enforces a four-step process — understand first (Chesterton's Fence), identify opportunities, apply one change at a time with test runs, then verify the whole diff — including the Rule of 500 for large refactors. - Use Case: After shipping a feature whose implementation grew messy under time pressure, run this Skill to flatten nested conditionals into guard clauses, rename vague variables, and extract duplicated logic — with tests passing unchanged after every step. ## Quick Start Ask the AI to simplify the recently modified module using the code-simplification skill while keeping all existing tests passing unchanged.
