review-agent

Reviews code changes and returns prioritized, actionable defect findings.

5|1|Updated Jun 26, 2026
One-click install
npx skills add https://github.com/looooonk/better-codex --skill review-agent-looooonk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-agent
Source: https://github.com/looooonk/better-codex/tree/main/codex-rs/skills/src/assets/samples/review-agent
Command: npx skills add https://github.com/looooonk/better-codex --skill review-agent-looooonk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Code reviews often miss real defects or get buried in style nitpicks and speculative concerns. This Skill performs a disciplined, read-only review of a specified change and returns only concrete, actionable findings that the author would likely fix. ## Core Features & Use Cases - Defect-first review: Inspects the full diff and surrounding code to identify regressions affecting correctness, security, performance, or maintainability. - Base-branch awareness: Resolves merge-base comparisons against upstream branches so reviews reflect what would actually merge. - Prioritized findings: Reports issues ordered by severity using P0–P3 priorities with file and line references, plus an overall assessment and test-gap notes. - Use Case: A delegating agent asks for a review of uncommitted changes before merging; this Skill inspects the diff, verifies each finding against tests and call sites, and returns a concise list of real defects. ## Quick Start Use the review-agent skill to review my uncommitted changes and return all actionable findings.

Frequently Asked Questions about review-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review uncommitted changes with an AI agent?▼

Delegate the review to this Skill with the target specified as uncommitted changes. It inspects the full diff plus surrounding code, verifies each issue against tests and call sites, and returns prioritized findings without modifying any files.

How does the review handle base-branch diffs?▼

For base-branch reviews it resolves the comparison ref to the branch's upstream when ahead, runs git merge-base HEAD against that ref, and inspects the diff from the merge base. This ensures the review covers what would actually merge.

What kinds of issues does a code review agent flag?▼

It flags discrete, actionable defects affecting correctness, security, performance, or maintainability that were introduced by the reviewed change. It skips speculative concerns, pre-existing problems, intentional behavior changes, and style nits.

Can the review agent modify files or post comments?▼

No. The Skill is strictly read-only: it does not modify files, create commits, push branches, post review comments, or delegate to another agent. It only inspects the target and returns findings.

What happens when a code review finds no issues?▼

The Skill reports "No findings." rather than inventing issues to fill the result. It still adds a brief overall assessment and notes any material test gaps or residual risks.