code-simplify
Installation
SKILL.md
Code Simplify
Make working code clearer without changing what it does. Clarity over cleverness. Behavior is frozen — the test suite is the contract. Applies to frontend and backend equally.
Target: $ARGUMENTS (file, directory, or module — if blank, use unstaged changes)
Guardrails
- Chesterton's Fence — before removing anything, explain why it's there. If you can't, leave it and flag it. Never delete guards, checks, or branches you don't understand.
- Behavior is frozen — no functional changes. Green test suite before and after; if a test's meaning has to change, you've gone too far.
- Clarity over cleverness — a junior should read it without decoding. Prefer boring and obvious.
Workflow
1. Baseline
- Identify target files (blank → unstaged changes)
- Run the test suite. If red, stop — don't simplify broken code
- If a target has no tests, flag it: simplification is unverifiable without them (offer
/fortify)