Code review
Plug-and-play skills and prompts for every AI coding agent
npx -y skills add Amey-Thakur/AI-SKILLS --skill code-reviewAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 19 days oldThe repository was created 19 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Review code changes for correctness, security, and maintainability with severity-ranked, evidence-based findings. Use when asked to review a diff, a pull request, or a file before merge.
SKILL.md
2.5 KB, as published. Nobody here has run it
Code review
Review the change, not the author, and report only what you can defend with evidence from the code in front of you.
Method
- Understand the intent first. Read the description, the tests, and the shape of the diff before judging a line. A "bug" that is deliberate behavior wastes everyone's time; state the intent back in one sentence before your first finding.
- Read in execution order, not file order. Follow a request, event, or call from entry to exit through the changed code. Bugs live on the paths between hunks, not inside them.
- Hunt in this priority order:
- Correctness: logic inversions, off-by-one, unhandled error and
nullpaths, race conditions, resource leaks, broken invariants. - Security: unvalidated input reaching queries, paths, URLs, or shell; secrets in code; authz checks missing on new surfaces.
- Reliability: what happens when the network call fails, the file is missing, the input is empty, the list has one item, or two callers arrive at once.
- Maintainability: misleading names, dead code, duplication of an existing helper, missing tests for the risky branch.
- Correctness: logic inversions, off-by-one, unhandled error and
- Verify before you report. For each candidate finding, construct the concrete failing scenario: the input or state that triggers it and the wrong result that follows. If you cannot construct one, it is a question, not a finding: ask it as a question.
- Rank by severity, worst first. Blocker (data loss, security, crash), Major (wrong behavior on realistic input), Minor (confusing but correct), Nit (style). Never bury a Blocker under ten Nits.
Reporting format
For each finding: file:line: one-sentence defect: the failing scenario , a suggested fix. Lead with the verdict: "N findings, worst is X" so the reader knows the stakes in the first line. If the change is good, say so plainly and stop; inventing findings to look thorough is a defect in the review, not the code.
Boundaries
- Do not review style a formatter or linter already enforces.
- Do not demand rewrites of working code that is merely not how you would write it; that is preference, and it goes at Nit level or not at all.
- If the diff is too large to follow execution paths, say that first: "this needs splitting to review honestly" is a legitimate top finding.