review
Installation
SKILL.md
Review
Run all review dimensions against the current branch and produce one unified review. Approve when a change improves overall code health, even if it isn't perfect.
Three modes: Self (no argument) — current branch diff against main; PR (URL or number) — someone else's PR; Path (file or directory) — full-file audit of code already on main.
Scope
Self / PR: review only the diff, but read enough surrounding code and docs to understand conventions and boundaries. Path: review the enumerated files in full — there is no diff.
Do not duplicate the same issue across categories.
Change sizing
Self and PR modes only — Path has no diff. Before reviewing, check the diff size:
- ~100 lines: good, reviewable in one pass.
- ~300 lines: acceptable if one logical change.
- ~1000 lines: too large — ask the author to split before reviewing.