review-agent

Reviews code changes and returns prioritized actionable defect findings.

Updated Jul 22, 2026
One-click install
npx skills add https://github.com/Chau165/local_skill --skill review-agent-chau165
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-agent
Source: https://github.com/Chau165/local_skill/tree/main/codex/skills/.system/review-agent
Command: npx skills add https://github.com/Chau165/local_skill --skill review-agent-chau165

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 of uncommitted changes, a base-branch comparison, or a commit, flagging only regressions introduced by the change. - Correct Merge-Base Comparison: Resolves the branch upstream and uses git merge-base to review the changes that would actually merge, avoiding misleading diffs against branch tips. - Prioritized Findings: Reports each issue with a P0-P3 severity, a file and line citation, and a short explanation, followed by an overall assessment and test gaps. - Use Case: After finishing a feature branch, delegate a review before opening a pull request to catch correctness, security, or performance regressions without modifying any files. ## 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 before committing?

Delegate the review target to the review-agent skill, which inspects the full diff of your uncommitted changes plus surrounding code. It returns only concrete defects introduced by the change, ordered by severity with file and line citations.

How does the agent review a branch against its base branch?

It resolves the branch's upstream when available, runs git merge-base HEAD against that comparison ref, and reviews the resulting diff. This ensures it examines the changes that would actually merge rather than diffing against the branch tip.

What kinds of issues does an automated code review flag?

It flags discrete, actionable regressions 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 my code or post comments?

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

What happens when a code review finds no issues?

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