# spec-peer-review

spec-peer-review runs one independent review of an approved spec, RFC, design document, or detailed PRD. It returns findings for the user to select.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 161 installs · ★ 655 repo stars
- Author: Pedro Nauck
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/spec-peer-review/SKILL.md
- Updated: 2026-10-20
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/spec-peer-review

## What it does

spec-peer-review examines a saved specification, design document, RFC, or detailed PRD when the user asks for an outside review. It follows linked contracts, examples, test expectations, ADR decisions, and instructions affecting the reviewed area. Each round gets its own `peer-review-findings-roundN.md` artifact.

The skill accepts extra context, an output directory, a reviewer runtime, a model, and a reasoning setting. It then checks the findings with `scripts/validate-findings.sh`, reports the verdict and limitations, and applies only the findings the user chooses. The review does not start on its own.

Implementation reviews and automatic approval loops are outside its scope. The independent pass can use an available native reviewer, a Compozy session, or herdr TUI. It does not approve designs, publish changes, or create commits.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill spec-peer-review -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill spec-peer-review -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill spec-peer-review -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pedronauck/skills skills/mine/spec-peer-review
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pedronauck/skills --skill spec-peer-review -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pedronauck/skills --path skills/mine/spec-peer-review
```

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- review an RFC before implementation
- spot contradictions across a PRD and its contracts
- save external review findings as a separate artifact
- recheck a document after selected changes

## Example prompts
- Review `docs/payments.md` once as an independent reviewer and write the findings to `qa/`.
- Inspect `docs/api-rfc.md` with context `p1,p2`, use `reviews/` for output, and set model `model-name`.
- Run another review for the changed files with `--ide <ide> --reasoning <effort>`.

## Similar
- [peer-review](https://affpapa.org/en/nevibecode/skills/k-dense-ai-peer-review.md) — skill · 2500 installs
- [peer-review-initiator](https://affpapa.org/en/nevibecode/skills/peer-review-initiator.md) — skill · 133 installs
- [performance-review-360-peer](https://affpapa.org/en/nevibecode/skills/performance-review-360-peer.md) — skill · ★ 107 repo stars
- [gjalla-spec-review](https://affpapa.org/en/nevibecode/skills/gjalla-spec-review.md) — skill · 902 installs
- [review-harness-spec](https://affpapa.org/en/nevibecode/skills/review-harness-spec.md) — skill · 592 installs
- [flow-next-spec-completion-review](https://affpapa.org/en/nevibecode/skills/flow-next-spec-completion-review.md) — skill · ★ 730 repo stars

From the same set: [pedronauck/skills](https://affpapa.org/en/nevibecode/by/pedronauck/skills.md) — 52 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
