How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/ammuench/ammuench_skills --skill review-guideBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
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.