simplify

Installation
SKILL.md

Simplify: Remove Slop from Working Code

Overview

Simplify assumes the code is correct and asks whether it is as simple as it could be. It exists because models drift additively: left alone, agent-written code accumulates verbosity and structural padding that prompting alone does not prevent. This skill is the recurring corrective pass.

Ask the user which mode to use:

  • audit mode to report findings but make no changes.
  • fix mode audit, then apply safe edits and preserve behavior exactly.

Scope is configurable: the default is the current change set, but a file, a directory, or the whole repo are equally valid targets when the user names one.

Every pass ends with a report persisted to a dated file (see references/edit-ledger.md). The file matters most for deletions, because a diff shows what was removed but cannot carry why removing it was safe.

Installs
14
Repository
ahgraber/skills
GitHub Stars
5
First Seen
Apr 13, 2026
simplify — ahgraber/skills