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
- 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.
- 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.
- 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. - Run the Connascence Pass when the diff crosses a boundary or feels tangled.
- 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.