arbe-review

Reviews code diffs against spec, correctness, and quality axes or sweeps codebases to file follow-up tasks.

Updated May 16, 2026
One-click install
npx skills add https://github.com/oskarrough/robots --skill arbe-review-oskarrough
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arbe-review
Source: https://github.com/oskarrough/robots/tree/main/skills/review
Command: npx skills add https://github.com/oskarrough/robots --skill arbe-review-oskarrough

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Code review is inconsistent: reviewers miss edge cases, flag style nits while ignoring broken invariants, or mix finding with fixing. This Skill provides a disciplined two-mode review process that checks spec compliance, correctness, and quality in a fixed order, and a codebase sweep that files findings as tasks without losing breadth. ## Core Features & Use Cases - Diff Review: Pins a comparison point (commit, branch, or files), reads whole files rather than hunks, and evaluates changes across three ordered axes: spec compliance, correctness (invariants, callers, error paths), and quality (complexity, patterns, naming). - Codebase Sweep: Breadth-first pass over all source files that finds duplication, anti-patterns, dead code, structural issues, and type-safety gaps, filing one task per finding group without proposing fixes. - Verified Findings Only: Requires confirming each claim by reading callers or reproducing the issue before flagging it; unconfirmed suspicions are raised as questions, not findings. - Use Case: After implementing a feature branch, run a diff review against main to catch a deleted validation check whose invariant is no longer re-established, with the exact file, line, and failure scenario named. ## Quick Start Review the diff of my current branch against main and report any spec, correctness, or quality findings with file and line references.

Frequently Asked Questions about arbe-review

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

FAQPage Schema
How do I review a code diff for correctness issues?▼

Pin a comparison point such as a commit or branch, capture one diff command, and read each changed file in full. For every deleted line, name the invariant it enforced and find where the new code re-establishes it; for changed functions, grep callers for broken preconditions.

What is the difference between diff review and a codebase sweep?▼

Diff review examines one change against spec, correctness, and quality axes and proposes concrete fixes. A sweep is breadth-first over all source files and only files findings as tasks, since finding and fixing in the same pass loses breadth.

When should I use a codebase sweep instead of a diff review?▼

Use a sweep when reviewing an entire codebase or module for systemic issues like duplication, dead code, and inconsistent patterns. Use diff review after finishing a specific change or when reviewing someone else's pull request.

What kinds of code quality issues does the review check for?▼

It checks unnecessary complexity such as single-use abstractions and wrapper objects, wrong patterns like type casts silencing errors and silent error swallowing, over-engineering beyond the ask, data flow legibility, and naming clarity.

Does the review skip issues already caught by linters?▼

Yes, anything tooling already enforces such as lint, typecheck, and formatter rules is skipped. Project code-style and testing docs also outrank the skill's defaults, but a doc violation is flagged only when the rule and breaking line can be quoted.