review-guide
Installation
SKILL.md
review-guide
When to use
Use when the user asks for a code review of a remote pull request link or local branch changes versus the default branch.
Instructions
- Get the diff:
- If PR link provided: fetch remote diff + existing PR comments. If fetch fails (auth, network, bad link), STOP and ask user to unblock.
- If no link: diff current branch against default branch (usually
main, sometimesdevelopormaster). Ask if unclear.
- If the PR references a ticket (Jira, Linear, GitHub issue), fetch it for context. If none, proceed.
- Review only changed lines plus direct impacts. For each finding, give
filepath:line_number. Use Conventional Comments format (see https://conventionalcomments.org/): labelspraise:,nitpick:,suggestion:,issue:,question:with decorations(blocking),(non-blocking),(if-minor)to signal merge impact. Cover bugs, logic, architecture, testing gaps, AC mismatch, security, and so on. - Verdict:
Approve= non-blocking comments only.Comment= needs clarification but don't block for churn.Request Changes= blocking bug or harmful pattern. When in doubt, favorRequest Changes. - Provide a guide: group related files in logical read order (feature before tests), explain what each group does and what to focus on.
- Render both artifacts directly in chat concisely: short sentences, bullets/lists, ASD-STE100 plain language. No paragraphs unless necessary. Do not create files unless the user explicitly requests file output.