CODE QUALITY

Code Review

Reviews diffs and pull requests for correctness bugs, unsafe patterns, and needless complexity before a human ever has to.

SIMURAI Verifiedv3.2.0Claude · Codex · Cursor

Install Skill View Source

What It Does

Flags correctness bugs, not just style nits
Distinguishes must-fix issues from optional suggestions
Understands diff context, not just isolated files
Suggests concrete fixes with inline code, not vague warnings
Skips noise: no bikeshedding on formatting a linter already owns

When To Use It

Reviewing a pull request before requesting human review
Auditing an unfamiliar codebase for risky patterns
Catching off-by-one and null-handling bugs in a diff
Pre-merge sanity check on CI before a release branch cuts

When Not To Use It

Does not replace a security-focused audit for high-risk surfaces
Best on diffs under ~800 lines; very large diffs get summarized, not line-by-line
Cannot verify runtime behavior — static reasoning only

How It Works

Read the diff and surrounding file context
Classify each change by risk: correctness, safety, style
Cross-reference call sites affected by signature changes
Produce a ranked list: must-fix, should-fix, nit
Attach a suggested patch for each must-fix finding

See It In Action

Before & After

Before

function getUser(id) {
  const user = users.find(u => u.id === id);
  return user.name;
}

SIMURAI Analysis

getUser will throw if no user matches, because user.name is accessed on a possibly-undefined value. The parameter and return type are also untyped, hiding the failure mode from callers.

Add explicit typing and use optional chaining so a missing user resolves to undefined instead of throwing at runtime.

After

function getUser(id: string): string | undefined {
  const user = users.find((u) => u.id === id);
  return user?.name;
}

Installation

Install This Skill

npx simurai install code-review --client claude

Skill Contents

What's Inside

File Tree

code-review/
  SKILL.md
  references/
    risk-classification.md
    patch-format.md
  examples/
    typescript-diff.md
    python-diff.md

SKILL.md preview

---
name: code-review
description: Review diffs for correctness bugs and needless complexity, ranked by risk.
---

# Code Review

Read the diff. Classify each hunk as correctness, safety, or style.
Never report a style nit as though it were a bug. Attach a concrete
patch to every must-fix finding — a warning without a fix is noise.

View SKILL.md View Source

Mastery

94/ 100

Precision96

Coverage91

Reliability95

Maintainability92

History

Changelog

v3.2.02026-06-14
- — Adds risk ranking (must-fix/should-fix/nit)
- — Improves cross-file call-site detection
v3.0.02025-11-02
- — Rewritten diff-context reasoning
- — Drops false positives on generated files
v2.1.02025-05-20
- — Initial public release
- — Supports TypeScript, Python, Go