| name | review |
| description | Code review of an open PR or local diff. Surfaces issues with severity tags; no scope creep, no praise. |
| argument-hint | [<PR# | commit-range>] |
| user-invocable | true |
| disable-model-invocation | false |
/review
Canonical algorithm
- Resolve target: PR number โ
gh pr diff <PR>; commit range โ git diff <range>; default โ git diff main...HEAD.
- Walk the diff hunk by hunk. For each hunk, read enough surrounding context to make a judgment.
- Apply rules in order: correctness > security > clarity > style.
- Tag findings: ๐ด blocker, ๐ must-fix, ๐ก should-fix, ๐ต nit.
- Check artifact chassis and dense references when reviewing docs or promoted artifacts.
Pre-flight checklist
Decision surfaces
When the final verdict is ambiguous (e.g. one ๐ finding the operator might choose to defer), surface approve | request-changes | comment-only through AskUserQuestion rather than picking silently.
Output contract
Skill envelope with a flat findings list grouped by file and an aggregate verdict (approve | request-changes | comment-only).