rust-review

Reviews Rust diffs against a severity-tiered checklist and issues Approve, Warning, or Block verdicts.

3|Updated Aug 8, 2026
One-click install
npx skills add https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer --skill rust-review-jose-polanco-oxte
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rust-review
Source: https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer/tree/main/.agents/skills/rust/sub-skills/rust-review
Command: npx skills add https://github.com/Jose-Polanco-Oxte/Echos-Live-Music-Visualizer --skill rust-review-jose-polanco-oxte

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing Rust changes consistently is hard: reviewers miss unsafe blocks without SAFETY comments, blocking calls inside async functions, or panics on production paths, and verdicts vary by reviewer. This Skill provides a rigorous, repeatable rubric that gates on cargo tooling first, then applies a severity-tiered checklist with stable rule IDs, and ends in a clear mergeable/not-mergeable verdict. ## Core Features & Use Cases - CI-aware quality gate: Consumes green CI checks for fmt, clippy, test, and build when available, otherwise runs cargo fmt, clippy, test, audit, and deny locally before any human-style review. - Severity-tiered checklist with rule IDs: Cites stable catalog IDs (SAF, ERR, OWN, CON, PER, API, MNT, INV, REC, TST, DEP) from rules.md so findings are addressable and dedup-able across review rounds. - Public-API design pass: Runs a condensed Rust API Guidelines checklist (api-design.md) when a diff changes a published pub surface. - Verification protocol: Every finding is adversarially verified, grounded in tool output and pinned file:line premises, with a false-positive exclusion catalog (fp-rules.md) governing refutations. - Use Case: Before opening a PR on a Rust branch, dispatch the rust-reviewer agent with the diff range and brief; it returns an Approve, Warning, or Block verdict with findings formatted as severity, file:line, rule ID, and fix guidance. ## Quick Start Ask the assistant to review the current Rust branch diff with the rust-review rubric and report an Approve, Warning, or Block verdict with cited findings.

Frequently Asked Questions about rust-review

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

FAQPage Schema
How do I review a Rust pull request before merging?

Run the mechanical gate first (cargo fmt --check, clippy with -D warnings, cargo test), then review the diff against the severity checklist covering safety, errors, ownership, concurrency, and performance. Finish with an Approve, Warning, or Block verdict citing findings by file:line and rule ID.

What cargo commands should run before a Rust code review?

The gate is cargo fmt --check, cargo clippy --all-targets -- -D warnings, and cargo test, plus cargo audit and cargo deny check if installed. If CI already ran an equivalent check on the PR and it is green, consume that result instead of recomputing locally.

What issues block a Rust change from merging?

Blockers include unwrap or panic on reachable production paths, unsafe blocks without SAFETY comments, injection via string interpolation, hardcoded secrets, blocking calls inside async functions, locks held across await, and any red gate check. Confirmed CRITICAL or HIGH findings force a Block verdict.

Does this review cover public Rust library APIs?

Yes, when a diff changes a public API surface, an additional pass runs a condensed Rust API Guidelines checklist covering naming, common trait impls, error types, sealing, documentation, and Cargo metadata. It is skipped for application-internal code.

How are false positives handled in Rust review findings?

Every finding goes through adversarial verification where skeptics try to refute it, and a documented exclusion catalog (FP-001 through FP-007) defines when findings drop, each requiring a specific trace. Unverifiable premises demote findings to Suspected rather than refuted.

When should I not rely on this review rubric alone?

The rubric judges code but does not rewrite it, and it does not write missing tests; those belong to separate testing and refactoring skills. Security-sensitive changes with unsafe code or new dependencies should also dispatch a dedicated security scanner and Miri checks.