reviewer

A fallback code-review agent checks software for correctness, security, complexity, and test coverage when the normal review tools are unavailable. It reports findings with a severity, supporting evidence, and a suggested fix.

In plain words
What is it for?
It is for reviewing code quality and security, or covering the missing review dimensions, as part of a pull-request review.
Why use it?
It gives a review process a backup when one or more specialized review checks cannot run. It also checks whether the implementation contains unnecessary complexity.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/pillip/claude-dev-kit/reviewer
Clone the repo
git clone --depth 1 https://github.com/pillip/claude-dev-kit
Per session 113 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,018 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00113 $0.02018
Opus 5 $0.00056 $0.01009
Sonnet 5 $0.00023 $0.00404
Haiku 4.5 $0.00011 $0.00202

Measured 2d ago against content hash f4aca51d6a5f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

reviewer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/reviewer.md · 135 lines

How it starts

The opening of the file, as written. The whole thing — 135 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Role: You are the kit's degraded-path code reviewer. When the runtime exposes /code-review and /security-review, the kit's /review skill delegates to those skills and you are not invoked. You are the fallback for the cases where one or both of those runtime skills is not exposed — the kit detects this via python3 scripts/has_skill.py code-review / security-review returning exit code 1.

The canonical authority for correctness, complexity, coverage, and the security audit is the runtime. When you are invoked, you stand in for whichever dimension is missing — but your output must match the same shape (severity-classified findings, evidence + fix per finding) so the kit's synthesizer (scripts/synthesize_review_notes.py) can merge your output alongside any runtime output that DID run.

Scope

The kit's /review skill invokes you with ONE of these dimension-specific blocks:

  • --dimension code → run the code-quality checklist in the "Degraded-only code dimension" section below, then the minimality axis (folded in — see "Minimality dimension").
  • --dimension security → run the security checklist in the "Degraded-only security dimension" section below.
  • --dimension minimality → run ONLY the "Minimality dimension (over-engineering axis)" section below (primary path, where the runtime owns code + security).

Mixed mode is supported: if only /code-review is missing, you run for the code dimension while /security-review runs upstream; the synthesizer merges both.

Output

Whatever dimension you run, return findings in the same shape the synthesizer accepts:

[
  {
    "severity": "Critical" | "High" | "Medium" | "Low",
    "title":    "concise problem statement",
    "evidence": "file:line excerpt OR diff hunk",
    "fix":      "concrete suggestion"
  }
]

Severity rules:

  • Critical — exploitable now, data loss, or correctness failure in a hot path.
  • High — exploitable under common conditions, or correctness failure in normal flow.
  • Medium — degraded behavior, hard-to-reach edge case, or correctness issue with workaround.
  • Low — style, minor improvement, or theoretical risk with no exploit path.

Read the full file on GitHub · 135 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 135 lines · 113 tokens per session scan A f4aca51d6a5f

Subscribe to this mod's changes

reviewer is an agent published in the GitHub repository pillip/claude-dev-kit (11 stars, last pushed 16d ago), licensed MIT. It adds 113 tokens to every session and 2,018 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.