# deep-review

deep-review is a Claude Code skill that examines branch changes, working trees, or pull requests. It looks for defects and improvements, and can check code against project rules or a specification.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 258 installs · ★ 655 repo stars
- Author: pedronauck
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pedronauck/skills/tree/HEAD/skills/mine/deep-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/deep-review

## What it does

The skill splits selected changes into review jobs, gathers evidence for defects, and records which project rules apply. Its scripts prepare the jobs, validate their results, and assemble a report. Source files remain untouched; review artifacts go into the output directory.

A pull request has no overall file or line cap, though each job uses configurable group sizes. The skill runs available linters or reuses existing results; it does not install tools. Its scripts require `python3`. External subagent calls consume `compozy exec` credit. Product changes are outside the review, and publishing requires `--publish` or explicit session authorization.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- find defects in branch or working-tree changes
- check a pull request against project rules
- compare code changes with a specification
- produce a report of defects and improvement notes

## Example prompts
- Run a deep review of the current working tree.
- Review PR `42` for defects and compare it with `docs/spec.md`.
- Check the changes against `main` and prepare a report without editing the code.

## Similar
- [dyad:multi-pr-review](https://affpapa.org/en/nevibecode/skills/dyadmulti-pr-review.md) — skill · ★ 22348 repo stars
- [claude-deep-review](https://affpapa.org/en/nevibecode/plugins/claude-deep-review.md) — plugin · ★ 13 repo stars
- [code-review](https://affpapa.org/en/nevibecode/commands/code-review.md) — command · 5537 installs
- [review-all](https://affpapa.org/en/nevibecode/plugins/review-all.md) — plugin · ★ 45 repo stars
- [code-review-swarm](https://affpapa.org/en/nevibecode/commands/code-review-swarm.md) — command · ★ 850 repo stars
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 437600 installs

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
