coding-review-simplify

Installation
SKILL.md

Coding Review Simplify

Tighten a completed diff while its context is fresh. Every change this pass makes is behavior-preserving: the observable behavior (outputs, errors, side effects, ordering) stays exactly as it was. Success is a simpler change, not fewer lines.

Audit mode, on request, searches a repository or named paths for dead code and slop.

Workflow

  1. Read the diff, the changed files, the task's acceptance contract, and the verification already captured. Expand past the changed surface only across a real boundary.
  2. Check the change against its intended observable behavior. Report a concern only when it can cause a bug, regression, data risk, weak verification, or maintenance trap.
  3. Run the reuse, quality, and efficiency passes. Run them inline, or as parallel read-only seats with one pass each, whichever suits the diff's size. When the diff changes stored state or asynchronous behavior, also apply data-systems-coding-lens.
  4. Run the Connascence Pass when the diff crosses a boundary or feels tangled.
  5. Turn each accepted finding into a fix, a test, or an explicit follow-up. As the implementer, apply fixes and re-run the verification they touch. As an independent reviewer, report and leave files unchanged. A design concern that spans a boundary is escalated, not refactored here.

Guards for every pass

Installs
82
GitHub Stars
2
First Seen
Jun 10, 2026