What problem does it solve? Working code often accumulates unnecessary complexity—deep nesting, long functions, unclear names, and duplication—that makes it hard to read, maintain, and extend. This Skill provides a disciplined, behavior-preserving process for simplifying code without introducing regressions. ## Core Features & Use Cases - Five Guiding Principles: Preserve behavior exactly, follow project conventions, prefer clarity over cleverness, avoid over-simplification, and scope changes to what changed. - Four-Step Process: Understand the code first (Chesterton's Fence), identify concrete simplification patterns, apply changes incrementally with test runs, and verify the result against the original. - Language-Specific Guidance: Includes concrete before/after examples for TypeScript/JavaScript, Python, and React/JSX, plus pattern tables for structural complexity, naming, and redundancy. - Use Case: After shipping a feature with passing tests, run a simplification pass to flatten nested conditionals into guard clauses, rename generic variables like data and temp, and extract duplicated logic—each change verified by the test suite. ## Quick Start Ask the agent to simplify the recently modified module using the code-simplification skill while keeping all existing tests passing unchanged.
