local-code-review

Reviews pull-request diffs with severity-graded findings and a machine-parseable verdict line.

Updated Jul 19, 2026
One-click install
npx skills add https://github.com/forhas/pure-dev --skill local-code-review-forhas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-code-review
Source: https://github.com/forhas/pure-dev/tree/main/plugins/notion-dev/skills/local-code-review
Command: npx skills add https://github.com/forhas/pure-dev --skill local-code-review-forhas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When the Codex review bot is unavailable during the notion-dev review-and-merge flow, teams lose their automated code review gate. This Skill provides a fallback review rubric so a fresh, independent-context reviewer agent can still evaluate pull-request or branch diffs with consistent standards. ## Core Features & Use Cases - Severity-graded findings: Classifies issues as Critical, Required, Optional, Nit, or FYI, ordered by leverage so real defects are not buried under nits. - Machine-parseable verdict: Emits a strict output contract ending in VERDICT: CLEAN or VERDICT: NOT-CLEAN, enabling automated merge gating. - Selective review axes: Applies only relevant axes (correctness, readability, architecture, security, performance/robustness) based on the actual change, avoiding speculative or cosmetic findings. - Use Case: During a notion-dev feature flow, the Codex bot times out. A fresh reviewer agent applies this rubric to the PR diff, reports two Required findings with concrete fixes, and emits VERDICT: NOT-CLEAN so the orchestrator blocks the merge until fixed. ## Quick Start Ask the reviewer agent to review the current pull-request diff using the local code review rubric and report findings with a final verdict line.

Frequently Asked Questions about local-code-review

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

FAQPage Schema
How do I review a pull request diff with an AI agent?

Provide the reviewer agent with the PR diff and HEAD commit SHA, then apply the review rubric covering correctness, readability, architecture, security, and performance. The agent returns severity-graded findings with concrete fixes and a final verdict line.

What is a fallback code review when Codex is unavailable?

It is a local review rubric applied by a fresh independent-context reviewer agent when the Codex review bot cannot run during the notion-dev flow. It produces the same style of severity-graded findings and a machine-parseable VERDICT line so the merge gate still functions.

Can this review rubric be used outside the notion-dev plugin?

Yes, the rubric is repo-agnostic and works on any pull-request or branch diff. It applies only the review axes that fit the change, so docs-only diffs skip performance checks and scripts without external input skip injection checks.

When does the review verdict return NOT-CLEAN?

The verdict is NOT-CLEAN only when at least one Critical or Required finding exists. Optional, Nit, and FYI findings never block the verdict, and a diff with no findings returns VERDICT: CLEAN.

Does the reviewer agent fix the issues it finds?

No, the reviewer is review-only and never edits files, commits, or pushes. It reports each finding with a concrete suggested fix, and the calling workflow triages and applies the changes.