code-reviewer

Reviews codebases for architecture conformance, code quality, performance, and test coverage gaps.

176|49|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/nagisanzenin/production-grade --skill code-reviewer-nagisanzenin
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: code-reviewer
Source: https://github.com/nagisanzenin/production-grade/tree/main/skills/code-reviewer
Command: npx skills add https://github.com/nagisanzenin/production-grade --skill code-reviewer-nagisanzenin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manual code reviews are inconsistent and often miss architectural drift, performance traps like N+1 queries, and untested edge cases before code reaches production. This Skill performs a structured, adversarial review across the entire codebase and produces severity-ranked findings with concrete fixes. ## Core Features & Use Cases - Architecture Conformance Audit: Compares implementation against every ADR, API contract, and data ownership boundary, flagging violations with severity levels. - Multi-Dimensional Review: Runs parallel phases covering SOLID/DRY code quality, cyclomatic complexity, performance bottlenecks (N+1, unbounded queries, missing caching), and test quality (coverage gaps, weak assertions). - Actionable Reports: Writes findings to critical/high/medium/low files, metrics to JSON, and mechanical auto-fix suggestions as before/after patch files — all read-only, never modifying source code. - Use Case: After backend, frontend, and tests are complete, run this Skill as a quality gate to catch a race condition causing double charges or an unindexed query on a high-traffic endpoint before deployment. ## Quick Start Review the services, frontend, and tests directories against the architecture docs and produce a severity-ranked review report with findings and auto-fix suggestions.

Frequently Asked Questions about code-reviewer

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

FAQPage Schema
How do I run an automated code review against architecture decision records?▼

This Skill audits every ADR in docs/architecture/ against the actual implementation, checking service boundaries, communication patterns, technology choices, and API contract adherence. It outputs a conformance table marking each decision as Conformant, Partial, or Violated with recommended fixes.

What does an adversarial code review check for?▼

It hunts for N+1 queries, unbounded selects, race conditions, swallowed exceptions, missing auth checks, dead interactive elements, and untested edge cases. Each finding includes a file location, impact statement, and a reproducible break scenario at higher engagement modes.

Does this code review skill modify my source code?▼

No, it is strictly read-only. All output goes to a dedicated code-reviewer directory containing findings, metrics, and suggested patches as before/after markdown files. Remediation is handled separately by the orchestrator.

Does this skill perform security or OWASP analysis?▼

No, security review is explicitly delegated to the separate security-engineer skill. This reviewer covers architecture conformance, code quality, performance, and test quality only, avoiding duplicated or conflicting findings.

How are code review findings prioritized by severity?▼

Findings are classified as Critical (data loss or correctness bugs), High (architecture violations, reliability risks), Medium (maintainability issues), or Low (style and minor optimizations). Reports are split into per-severity files so teams can triage blockers first.