What problem does it solve? Working code often accumulates unnecessary complexity—deep nesting, long functions, unclear names, and duplication—that makes it harder to read, maintain, and extend. This Skill provides a disciplined process for simplifying code without changing its behavior, avoiding the risks of ad-hoc refactoring. ## Core Features & Use Cases - Behavior-Preserving Refactoring: Applies five principles (preserve behavior, follow project conventions, prefer clarity, maintain balance, scope to changes) so every simplification keeps inputs, outputs, side effects, and error behavior identical. - 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. - Language-Specific Guidance: Includes before/after examples for TypeScript, JavaScript, Python, and React/JSX, plus a verification checklist covering tests, builds, linting, and diff cleanliness. - Use Case: After shipping a feature with passing tests, run a simplification pass on the modified files to flatten nested conditionals into guard clauses, rename generic variables, and extract duplicated logic—then submit the refactor as a separate, reviewable commit. ## Quick Start Ask the agent to simplify the recently modified code in this module for clarity without changing any behavior, keeping all existing tests passing.
