# review-loop

A skill that runs a worker-reviewer loop: a separate critic subagent scores the work 1-10 and hands back notes, and the agent revises until the gate is met.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 104100 installs · ★ 6
- Author: 2dmurali
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/2dmurali/review-loop-skill/tree/HEAD/review-loop/SKILL.md
- Updated: 2026-05-08
- HTML: https://affpapa.org/en/nevibecode/skills/review-loop

## What it does

You finish the task the way you normally would. Then the skill hands the result to a critic subagent, which sees only the work product — files and diffs, not your reasoning — and returns a score from 1 to 10 with pointed feedback. The agent revises against those notes and the cycle repeats.

Defaults are 2 loops minimum, 4 maximum, quality gate 8/10. All three can be changed in the request itself: "quality gate 9", "max 5 loops", "reasoning reviewer". The reviewer has to be at least as capable as the worker, otherwise subtle regressions slip past it. If the score stalls across two rounds on the same feedback, the worker model is the bottleneck — swap it or split the task.

The skill assumes the platform can spawn subagents. Where it cannot, the review step is faked by hand: open a fresh chat, paste the work product alone, ask for a score and specific notes. Quick edits and tasks gated by tests are a poor fit.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add 2dmurali/review-loop-skill --skill review-loop -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/review-loop/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/review-loop/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add 2dmurali/review-loop-skill --skill review-loop -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/review-loop/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add 2dmurali/review-loop-skill --skill review-loop -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/review-loop/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install 2dmurali/review-loop-skill review-loop
```

2. **Manually: put the files in place**
- File: `.github/skills/review-loop/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add 2dmurali/review-loop-skill --skill review-loop -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/2dmurali/review-loop-skill --path review-loop
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/review-loop/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add 2dmurali/review-loop-skill --skill review-loop -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/2dmurali/review-loop-skill/tree/HEAD/review-loop/SKILL.md

## When to use it
- turn a rough spec draft into something readable
- get a second agent's read on code instead of grading your own work
- set a quality gate and loop count per task
- harden an implementation where reliability beats speed
- catch regressions across a multi-file change

## Example prompts
- Implement report export, use review-loop
- Run review-loop on the file I just wrote
- Polish this spec, quality gate 9, max 5 loops

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md