Review uncommitted code changes using parallel Claude sub-agents (Bug Hunter, Rules Auditor, optional Architect).

MITAuto-check passedAgent Workflows

Install Review Work

skills CLI
$ npx skills add peterkrueck/Claude-Code-Development-Kit --skill review-work -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install peterkrueck/Claude-Code-Development-Kit review-work --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/peterkrueck/Claude-Code-Development-Kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/review-work .claude/skills/review-work && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
review-work
GitHub stars
1.4k
Token cost
~3.3k tokens
SKILL.md length
875 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Review uncommitted code changes using parallel Claude sub-agents (Bug Hunter, Rules Auditor, optional Architect).

  • Works in 6 steps: Capture the Diff (+ Tests) → Triage → Decide Reviewers — Judgment Rubric → …
  • Tasks that involve Subagents
  • SKILL.md covers Process and Important Rules
  • Calls git

What it does

Review Work is an agent skill from peterkrueck/Claude-Code-Development-Kit. Review uncommitted code changes using parallel Claude sub-agents (Bug Hunter, Rules Auditor, optional Architect). The invoking agent triages the diff by file path into impacted modules and risk surfaces, then spawns reviewers scaled to the change. Each reviewer self-primes via /prime, verifies any API/library claim via Context7 (mandatory — unverified claims are auto-discarded), and reports an intent verdict against progress.md before its findings. Catches bugs, security issues, CLAUDE.md compliance, and…

Its SKILL.md is about 3.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Subagents, Test coverage and Agent instruction files. It works with Git. The repository describes itself as: Claude Code Workflow for beginners & intermediate users. Tutorial and Installer included. The licence is MIT.

When your agent uses it

  • Tasks that involve Subagents
  • Tasks that involve Test coverage
  • Tasks that involve Agent instruction files

Example prompts

  • “/review-work”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Capture the Diff (+ Tests)
  2. Triage
  3. Decide Reviewers — Judgment Rubric
  4. Spawn Reviewers (Parallel, Single Message)
  5. Judge Findings
  6. Output to User

What it can do on your machine

Read from SKILL.md and the folder at commit ba85375. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Review Work loads about 3.3k tokens when it runs. Until then it costs about 174 tokens; SKILL.md has 875 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~174
When it runs · the whole SKILL.md, loaded when a task matches
~3.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from peterkrueck/Claude-Code-Development-Kit at commit ba85375, republished under its MIT licence (© peterkrueck). 875 words, ~3,290 tokens.

Download SKILL.mdSave it as .claude/skills/review-work/SKILL.md (or your agent's skills folder).
name
review-work
description
Review uncommitted code changes using parallel Claude sub-agents (Bug Hunter, Rules Auditor, optional Architect). The invoking agent triages the diff by file path into impacted modules and risk surfaces, then spawns reviewers scaled to the change. Each reviewer self-primes via /prime, verifies any API/library claim via Context7 (mandatory — unverified claims are auto-discarded), and reports an intent verdict against progress.md before its findings. Catches bugs, security issues, CLAUDE.md compliance, and test-coverage gaps. Skip for trivial typos/formatting. Use after substantive implementation work, or when the Stop hook requests it. Also invocable manually with /review-work.
user_invocable
true

Review Work — Automated Code Review

Review uncommitted code changes using Claude sub-agents as independent reviewers. The invoking agent (you) triages the diff and decides who reviews; reviewers self-prime via /prime, verify API/library claims via Context7, and report against progress.md intent.

This skill is run by an AI, not by a human — use judgment about the change you just made. Don't apply a fixed rubric mechanically. Zero external dependencies: reviewers are Claude sub-agents.

Process

Step 1: Capture the Diff (+ Tests)

Run these and save the output:

bash
git diff --stat HEAD
bash
git diff HEAD

git diff HEAD captures uncommitted work — the normal pre-commit flow. If the work was already committed (e.g. direct-to-main), review the last commit instead: git diff HEAD~1 HEAD (or git show HEAD).

If the project has a test command configured and relevant source changed, run it and capture the output:

bash
# Use whatever test/build command is appropriate for this project's stack.
# e.g. npm test · pytest · cargo test · go test ./... · the test_command in
# hooks/config/pipeline.json if set.

Test/build failures are the #1 finding for every reviewer — include the failure output in each reviewer's prompt verbatim.

Step 2: Triage

Look at the changed file paths and produce two lists.

Impacted modules — by default the whole project is one scope (one project per repo). Only split into modules/components when the diff clearly spans distinct top-level areas (e.g. api/ vs web/, backend/ vs frontend/). If it's all one area, that's a single scope — don't manufacture splits.

Risk surfaces — flag the presence of any of these generic surfaces. For each one that fires, inject the matching focus-area line into reviewer prompts in Step 4:

SurfaceInject this focus-area line
Authentication / authorization"Auth code touched — check for privilege escalation, missing access checks, and tokens/sessions handled correctly."
Database / schema migration"Schema migration touched — check locking, backfills, NOT NULL on existing rows, and that access rules/constraints are preserved."
Configuration / secrets"Config or secrets touched — confirm no secrets are hardcoded or logged, and environment-specific values aren't baked into source."
Dependency manifest"Dependency manifest changed — confirm new deps are pinned, sourced legitimately, and not duplicating existing functionality."
Critical-path / user-facing flow"Critical-path or user-facing flow touched — check error handling, input validation at boundaries, and that the happy path plus failure modes are covered."

Omit the focus-areas section entirely if no surfaces fire.

Step 3: Decide Reviewers — Judgment Rubric

Skip the skill entirely when the change is genuinely trivial:

  • Comment-only / formatting / typo-only
  • Single-line fix with no logic or contract effect
  • Pure doc edits with no code references

If you skip, tell the user once: "Change is trivial, skipping review." Then continue.

For non-trivial changes, scale reviewers to the diff:

  • Under ~50 lines changed → one reviewer with the combined Bug Hunter + Rules Auditor checklist (Step 4, single-reviewer template).
  • ~50+ lines, or 2+ modules → parallel specialists: a Bug Hunter (correctness + security) and a Rules Auditor (project rules + tests). When the diff splits into distinct modules, give each specialist the scope note for the modules it covers.

Add an OPTIONAL Architect reviewer when ANY of these is true:

  • Changes span 2+ modules/components
  • New abstraction or API contract introduced (not just a config tweak)
  • A refactor / migration is left unfinished, or files were renamed/moved
  • The diff shows scope creep — more than the active task called for

Most changes need 1 reviewer. Larger or multi-module changes get 2. The Architect appears only when the change is design-significant — don't pre-spawn it.

Show full SKILL.md (344 more words)Show less
Step 4: Spawn Reviewers (Parallel, Single Message)

Use the Agent tool with subagent_type: "Explore" (read-only). Send all reviewers in a single message so they run in parallel. Inline the role — no custom sub-agent files needed.

Every reviewer prompt includes these shared blocks. Define them once, paste into each template:

## Required reading (self-prime)
Before reviewing, run /prime — read .claude/commands/prime.md and follow its
file-loading instructions to load this project's core docs (spec,
project-structure, progress). Skip the acknowledgement step — load the files,
then review.

## The diff
{full `git diff HEAD` output}

## Test results
{Step 1 test/build output, or "n/a — no testable files in this diff"}

## Focus areas flagged by triage
{relevant lines from the Step 2 catalogue; omit this section if none fired}

## Mandatory verification (Context7)
If you flag a finding about an API signature, library usage, deprecation, or
SDK version behavior, you MUST first call the Context7 query-docs tool to
verify it. If that tool isn't directly callable, load it via ToolSearch first
(`select:mcp__context7__query-docs`) — don't skip verification just because the
tool wasn't preloaded. Tag every finding:
- [verified]   — Context7 confirmed the issue.
- [unverified] — you couldn't or didn't check. AUTO-DISCARDED by the judge.
                 Don't bother reporting these.
- [n/a]        — finding is not an API/library claim (most bugs and rules).

## Intent verification (required, output FIRST)
Before your findings, output exactly one line:

    INTENT: [yes | partial | no | n/a] — <one-line reason referencing progress.md>

- yes     — diff fulfills the active task in docs/ai-context/progress.md.
- partial — fulfills part of it, or fulfills it but adds unrelated changes (scope creep).
- no      — diff doesn't match anything in progress.md's active scope.
- n/a     — there is no progress.md, or no active task to verify against.

## Output format
INTENT line first, then one finding per line:

    [high|medium|low] [verified|unverified|n/a] path/to/file:line — Description. Reason: <why this is a problem>.

Check ONLY for real issues. Don't nitpick style, naming, or formatting unless
it causes a bug. If a category is clean, omit it. Don't invent issues to seem
thorough — only report what you can point to in the diff.

Template: Single Reviewer (small diffs)
You are a code reviewer for an uncommitted-diff code review. Cover both
correctness/security AND project-rule/test compliance.

{shared blocks}

## Checklist
**BUGS** — Logic errors, null/undefined handling, off-by-one, race conditions,
async/await mistakes, state-machine violations, wrong return types, unreachable
code, missing error handling, incorrect boolean logic.

**SECURITY** — Secrets or PII logged or exposed, missing input validation at
system boundaries, internals leaked in error messages, hardcoded secrets,
injection vulnerabilities, broken access checks.

**PROJECT RULES** — Violations of the loaded CLAUDE.md and ai-context docs:
architecture decisions, coding conventions, wrong storage/transport layer, any
documented project-specific constraint.

**TESTS** — If this touches shared modules or critical paths, do corresponding
tests exist? Are assertions structural rather than exact-string matches?

Template: Bug Hunter (correctness + security)
You are the Bug Hunter for an uncommitted-diff code review. Your ONLY job is
logic errors and security vulnerabilities. Ignore style, naming, and project
rules — the Rules Auditor handles those.

{shared blocks}

## Checklist
**BUGS** — Logic errors, null/undefined handling, off-by-one, race conditions,
async/await mistakes, state-machine violations, wrong return types, unreachable
code, missing error handling, incorrect boolean logic.

**SECURITY** — Secrets or PII logged or exposed, missing input validation at
system boundaries, internals leaked in error messages, hardcoded secrets,
injection vulnerabilities, unsafe deserialization, broken access checks.

Template: Rules Auditor (project rules + test coverage)
You are the Rules Auditor for an uncommitted-diff code review. Your ONLY job is
compliance with this project's rules and test coverage. Ignore general
correctness and security — the Bug Hunter handles those.

{shared blocks}

## Checklist
**PROJECT RULES** — Violations of the loaded CLAUDE.md and ai-context docs:
architecture decisions, coding conventions, wrong storage/transport layer, any
documented project-specific constraint.

**TESTS** — If this touches shared modules or critical paths, do corresponding
tests exist? Are assertions structural rather than exact-string matches?

Template: Architect (optional — design-significant changes)
You are the Architect reviewer for an uncommitted-diff code review. You look at
the diff AS A WHOLE — design coherence, structural soundness, invariants. You do
NOT report line-level bugs or style; the other reviewers handle that.

{shared blocks}

## What to check
- **Premature abstraction** — a new abstraction wrapping one caller, or where a
  few inline lines would have been clearer.
- **Half-finished migrations** — files renamed inconsistently, removed code
  still referenced, dual code paths left after a rewrite.
- **Cross-file invariants** — type renames, signature/contract changes: are all
  call sites updated?
- **Cross-module impact** — when a shared module changes, do its consumers still
  hold conceptually? Are public APIs preserved, or the break noted?
- **Dead code** — branches, parameters, or files no longer reachable.
- **Scope creep** — does the diff do more than progress.md's active task called
  for? Refactor mixed into feature work?

Architect findings tend to be MEDIUM/HIGH because they're structural. Be
precise — point to specific files and behaviors, not vibes.
Step 5: Judge Findings

Combine output from all reviewers and evaluate each finding. Reviewers have fresh eyes but lack your conversation context — they don't know WHY you made certain choices.

Auto-discard unconditionally:

  • Findings tagged [unverified] about API/library/SDK claims. Context7 is mandatory — no verification, no finding.

For everything else:

VerdictAction
Valid (high/medium) — real issue, agreedFix it now
Valid (low) — real but minorNote to user, don't fix unless asked
False positive — reviewer misread context or flagged an intentional choiceReject with a one-line reason

Lead with INTENT if any reviewer reported partial or no — that's the headline, not the line findings. Code can be locally clean but solving the wrong problem.

Step 6: Output to User
## Code Review Results

Reviewers: <list, e.g. "Bug Hunter + Rules Auditor (parallel)" or "single reviewer">
Modules touched: <list, or "whole project">
Tests: <pass | fail | n/a>
**Intent: <yes | partial | no | n/a>** — <one-line reason>

### Blockers
- [high] file:line — <description>. **Action:** Fixed | Rejected (reason) | Noted

### Mediums
- [med] file:line — <description>. **Action:** …

### Lows
<N findings — expand if you want details>

If everything is clean: a single line — "No blockers. N low-severity items (expand if interested). Intent: <verdict>."

Important Rules

  1. Never skip review for non-trivial work. Self-review is not review.
  2. Trivial means trivial. Comments, formatting, typos, no-logic-effect single-line fixes. Anything that changes behavior is non-trivial.
  3. Never blindly accept findings. Reviewers can hallucinate file paths, misread logic, or flag intentional choices. You're the judge.
  4. Auto-discard [unverified] API/library findings. Context7 is mandatory — no verification, no finding. Don't relax this.
  5. Lead with INTENT. A diff that's clean but off-target is worse than a diff with fixable bugs.
  6. Reviewers are read-only. Use subagent_type: "Explore". They never edit code — only the judge (you) applies fixes.
  7. Test failures dominate. If tests failed, that's finding #1; everything else is secondary.
  8. Don't pre-spawn the Architect. Use the rubric — most changes don't need it.
  9. Spawn in parallel. Multiple reviewers → single message with multiple Agent calls.
    </content>
    </invoke>

© peterkrueck, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/review-work of peterkrueck/Claude-Code-Development-Kit.

Open the folder on GitHubat commit ba85375

Compare with similar skills

Review Work next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Review Work compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Review Work this skillpeterkrueck/Claude-Code-Development-Kit1.4k—~3.3kAutomated safety check: PassMIT
Review SwarmDimillian/Skills4k—~1.6kAutomated safety check: PassMIT
Review Swarmsickn33/agentic-awesome-skills47k1 repos~1.9kAutomated safety check: PassMIT
Ad ReviewCorridorTech/PoseCap224—~2.4kAutomated safety check: NotesApache-2.0
Base Comparisonstylelint-stylistic/stylelint-stylistic106—~2.2kAutomated safety check: PassCustom licence
Do Issueathola/claude-night-market341—~1.5kAutomated safety check: PassMIT

Similar skills

  • Review Swarm

    Dimillian/Skills

    Parallel read-only multi-agent review of a current git diff or explicit file scope to find behavioral regressions, security or privacy risks, performance or reliability issues, and contract or test…

    4k GitHub stars~1.6k tokensUpdated 6 mo ago
    Agent WorkflowsAuto-check passed
  • Review Swarm

    sickn33/agentic-awesome-skills

    Parallel read-only multi-agent review of a current git diff or explicit file scope to find behavioral regressions, security or privacy risks, performance or reliability issues, and contract or test…

    47k GitHub starsUsed in 1 repo~1.9k tokens
    Agent WorkflowsAuto-check passed
  • Ad Review

    CorridorTech/PoseCap

    Two-axis fresh-context code review per WORKFLOW §10. An agent skill from CorridorTech/PoseCap.

    224 GitHub stars~2.4k tokensUpdated 2 days ago
    DevelopmentAuto-check: notes
  • Base Comparison

    stylelint-stylistic/stylelint-stylistic

    Measure a branch against the commit it stands on — extract the base instead of flipping the working tree, pick the base by hash, and prove a new test case red on it.

    106 GitHub stars~2.2k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Do Issue

    athola/claude-night-market

    Implements GitHub or GitLab issues via parallel subagents with review gates between task batches.

    341 GitHub stars~1.5k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed

More from peterkrueck/Claude-Code-Development-Kit

All 9 skills in this repo
  • Image Edit

    peterkrueck/Claude-Code-Development-Kit

    Edit images with precision — crop, resize, mirror, rotate, trim, and reframe.

    1.4k GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Image Gen

    peterkrueck/Claude-Code-Development-Kit

    Generate character art and image variations using AI image generation (Google Gemini) with reference images for style and character consistency.

    1.4k GitHub stars~1.4k tokensUpdated 2 mo ago
    Auto-check passed
  • Bg Remove

    peterkrueck/Claude-Code-Development-Kit

    Remove backgrounds from images using local AI (rembg). An agent skill from peterkrueck/Claude-Code-Development-Kit.

    1.4k GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Context7 Guidance

    peterkrueck/Claude-Code-Development-Kit

    Fetch CURRENT library/framework/API/CLI documentation via Context7 instead of relying on training data.

    1.4k GitHub stars~671 tokensUpdated 2 mo ago
    Auto-check passed
  • Second Opinion

    peterkrueck/Claude-Code-Development-Kit

    Get a second opinion from OpenAI's Codex CLI running locally.

    1.4k GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check: warnings
  • Deploy

    peterkrueck/Claude-Code-Development-Kit

    Test and deploy changes safely. An agent skill from peterkrueck/Claude-Code-Development-Kit.

    1.4k GitHub stars~3.3k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Questions about Review Work

What does Review Work do?

Review uncommitted code changes using parallel Claude sub-agents (Bug Hunter, Rules Auditor, optional Architect). Review Work is an agent skill from peterkrueck/Claude-Code-Development-Kit. Review uncommitted code changes using parallel Claude sub-agents (Bug Hunter, Rules Auditor, optional Architect).

When should I use Review Work?

Review Work fits situations like: tasks that involve Subagents; tasks that involve Test coverage; tasks that involve Agent instruction files.

How do I install Review Work in Claude Code?

Run `npx skills add peterkrueck/Claude-Code-Development-Kit --skill review-work -a claude-code`. Or copy the skill folder (skills/review-work in peterkrueck/Claude-Code-Development-Kit) into .claude/skills/review-work in your project. Claude Code loads it when a task matches its description.

How do I install Review Work in Codex?

Run `npx skills add peterkrueck/Claude-Code-Development-Kit --skill review-work -a codex`. Or copy the skill folder (skills/review-work in peterkrueck/Claude-Code-Development-Kit) into .agents/skills/review-work in your project. Codex loads it when a task matches its description.

Can I use Review Work in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add peterkrueck/Claude-Code-Development-Kit --skill review-work -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/review-work, .gemini/skills/review-work, .github/skills/review-work and .opencode/skills/review-work in your project.

What does Review Work need to run?

Going by SKILL.md and its folder, Review Work needs the command-line tools its instructions call (git).

Does Review Work access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Review Work safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Review Work use?

Review Work is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Review Work use?

About 3.3k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Review Work?

Skills that share tags, products or a category with Review Work: Review Swarm (Dimillian/Skills, 4k stars), Review Swarm (sickn33/agentic-awesome-skills, 47k stars), Ad Review (CorridorTech/PoseCap, 224 stars) and Base Comparison (stylelint-stylistic/stylelint-stylistic, 106 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Review Work?

peterkrueck (a GitHub user) maintains it in peterkrueck/Claude-Code-Development-Kit, which has 1,386 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on July 22, 2026.

Source: peterkrueck/Claude-Code-Development-Kit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.