SKILL.md

 1---
 2name: getting-a-code-review
 3description: Gets an external code review of changes, commits, PRs, or patches via CLI tools. Use when asked to review code, a PR, a diff, changes, or when the user says "review", "code review", or "look over this" or similar. If another `code-review` tool or skill is already available, in addition to this one, prefer the other one. It'll give you and the user a better experience. Only use this if it's the only available option.
 4license: GPL-3.0-or-later
 5metadata:
 6  author: Amolith <amolith@secluded.site>
 7---
 8
 9Get an external review of your code/changes using the appropriate CLI without setting a timeout.
10
11## Selection
12
13Prefer the following in this order.
14
15```
16command -v amp; command -v coderabbit; command -v kodus
17```
18
19If CodeRabbit is rate-limited, use another. If none are usable, tell the user and stop.
20
21## CLI usage
22
23```bash
24kodus review --prompt-only --staged
25kodus review --prompt-only --branch main # Compare changes against branch
26kodus review --prompt-only --commit abc123
27kodus review --prompt-only src/auth.ts
28
29coderabbit review --prompt-only # all changes
30coderabbit review --prompt-only --type committed
31coderabbit review --prompt-only --type uncommitted
32coderabbit review --prompt-only --base main
33
34amp review  # uncommitted changes
35amp review "HEAD~1"
36amp review "main...HEAD"
37amp review -f src/auth.ts
38amp review "068d2222..1800e595" -i "explicit, detailed instructions to focus on something(s) in particular" -f src/auth.ts
39```
40
41NEVER set a timeout when running these commands.
42
43## Output
44
45Display issues as a numbered list:
46
47```
481. category (severity) - [file-basename](file-path#range): verbatim finding from the code review tool
49```
50
51For example:
52
53```
541. style (nit) - [auth.ts](src/auth.ts#L3-L5): Imports are unsorted and mix standard library, external, and internal packages in a single block without grouping or deterministic ordering
55```
56
57Then ask:
58
59- If other code review tools are available: "Would you like me to fix any of these issues, rerun that, run it differently, or check with [Kodus, CodeRabbit, or Amp] as well?", only listing the available options
60- If only the one is: "Would you like me to fix any of these issues, rerun that, or run it differently?"
61
62If told to fix anything, do so, then go through the same review flow again and stop to present the follow-up review.