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)
Installs
2
GitHub Stars
15
First Seen
Aug 23, 2026
code-simplify — helderberto/agent-skills