code-review

Reviews git diffs against coding standards and spec requirements using parallel sub-agents.

20|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reddb-io/red-skills --skill code-review-reddb-io
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-review
Source: https://github.com/reddb-io/red-skills/tree/main/plugins/dev/skills/engineering/code-review
Command: npx skills add https://github.com/reddb-io/red-skills --skill code-review-reddb-io

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Code reviews often conflate two separate questions — is the code well-written, and does it do what was asked — letting one axis mask failures in the other. This Skill separates them into independent parallel reviews so standards violations and spec gaps are each visible on their own. ## Core Features & Use Cases - Two-axis review: Runs a Standards review (repo conventions plus the twelve-smell Fowler baseline) and a Spec review (requirements coverage, scope creep, wrong implementations) as parallel sub-agents that don't pollute each other's context. - Fixed-point diffing: Compares HEAD against any user-supplied commit, branch, or tag using three-dot merge-base diffs, so you can review a branch, a PR, or work-in-progress since any point. - Automatic source discovery: Locates the originating spec from issue references in commit messages, user-provided paths, or docs/specs files, and collects standards sources like CLAUDE.md, CONTRIBUTING.md, ADRs, and lint configs. - Use Case: Before merging a feature branch, ask for a review against main and receive separate Standards and Spec reports with cited rules, quoted spec lines, and a one-line summary of the worst finding. ## Quick Start Ask the agent to review the current branch against main, for example: review my changes since main and check them against our coding standards and the original issue.

Frequently Asked Questions about code-review

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

FAQPage Schema
How do I review a git branch against coding standards automatically?▼

Provide a fixed point such as a branch, commit SHA, or tag, and the review compares HEAD against it using a three-dot merge-base diff. A Standards sub-agent reads your repo's documented conventions and the Fowler smell baseline, then reports violations per file with cited rules.

How to check if code implements what the issue asked for?▼

A Spec sub-agent reads the originating issue or spec file, then compares it against the diff to find missing requirements, unrequested scope creep, and incorrect implementations. Each finding quotes the relevant spec line so you can verify it directly.

What happens if there is no spec for the changes being reviewed?▼

The review first looks for issue references in commit messages, user-provided paths, and spec files under docs/ or specs/. If none exists and the user confirms it, the Spec axis is skipped and the final report notes that no spec was available.

Does the review work when a repo has no written coding standards?▼

Yes. A universal Fowler baseline of twelve code smells, including Duplicated Code, Feature Envy, and Shotgun Surgery, applies to every review even without standards docs. Repo-specific standards override or extend the baseline when present.

Why run standards and spec reviews as separate sub-agents?▼

Running them in parallel as separate sub-agents keeps each review's context clean and prevents one axis from masking the other. Code can pass standards while failing the spec, or vice versa, and separate reports make both outcomes visible.