# peer-review-initiator

peer-review-initiator builds a review request for your agent: commit SHAs, what changed, what it should do. Then hands it to a reviewer subagent.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 133 installs · ★ 50 repo stars
- Author: qodex-ai
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qodex-ai/ai-agent-skills/tree/HEAD/skills/peer-review-initiator/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/peer-review-initiator

## What it does

The skill fixes the order of a review handoff. The agent resolves a base and a head commit with `git rev-parse`, then fills the `code-reviewer.md` template: what was built, the requirements behind it, the diff range, a short summary. That request goes to the `superpowers:code-reviewer` subagent.

Triggers are spelled out. Every task in subagent-driven work, a finished feature, a merge to main. Two optional cases too: you are stuck, or you are about to refactor. Feedback gets sorted — critical fixed right away, important before the next step, minor noted for later. If the reviewer is wrong, the skill says push back with technical reasoning.

It expects the `superpowers:code-reviewer` subagent and the template at `requesting-code-review/code-reviewer.md` to be in place. Without them there is nothing to dispatch, and placeholders like `{BASE_SHA}` or `{HEAD_SHA}` have nowhere to go. The license is proprietary, terms in `LICENSE.txt`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qodex-ai/ai-agent-skills skills/peer-review-initiator
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/peer-review-initiator
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -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/qodex-ai/ai-agent-skills/tree/HEAD/skills/peer-review-initiator/SKILL.md

## When to use it
- assemble a review request with SHAs and a change summary
- hand the diff to a reviewer subagent instead of retelling it
- sort reviewer feedback into fix-now and fix-later
- keep review in the loop after every task in subagent work
- push back on a wrong review with reasoning and tests

## Example prompts
- Request review for this branch: base `origin/main`, head is HEAD.
- Run a review before I merge to main and triage the findings.
- I'm stuck on this bug — get a fresh review pass on the current diff.

## Similar
- [peer-review](https://affpapa.org/en/nevibecode/skills/prathamdby-peer-review.md) — skill · 723 installs
- [review](https://affpapa.org/en/nevibecode/skills/rudolf-s-review.md) — skill · ★ 587 repo stars
- [squad-review](https://affpapa.org/en/nevibecode/skills/squad-review.md) — skill · ★ 114 repo stars
- [claude-review](https://affpapa.org/en/nevibecode/skills/claude-review.md) — skill · 148 installs
- [cursor-review](https://affpapa.org/en/nevibecode/skills/cursor-review.md) — skill · ★ 3219 repo stars
- [pull-request-review](https://affpapa.org/en/nevibecode/skills/pull-request-review.md) — skill · ★ 219 repo stars

From the same set: [qodex-ai/ai-agent-skills](https://affpapa.org/en/nevibecode/by/qodex-ai/ai-agent-skills.md) — 42 cards

---
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
