deep-review — Claude Code skill: code review and setup
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.
no license 258 installs ★ 655 updated 2026-10-20
npx skills add pedronauck/skills --skill deep-review -a claude-codeWhat deep-review 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.
What it helps with
- 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 for the agent
- Run a deep review of the current working tree.
- Review PR
42for defects and compare it withdocs/spec.md. - Check the changes against
mainand prepare a report without editing the code.
How to install deep-review
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill deep-review -a claude-code2Manually: put the files in place
~/.claude/skills/deep-review/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/deep-review/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill deep-review -a codex2Manually: put the files in place
.agents/skills/deep-review/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill deep-review -a cursor2Manually: put the files in place
.cursor/skills/deep-review/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/mine/deep-review2Manually: put the files in place
.github/skills/deep-review/SKILL.md1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill deep-review -a gemini-cli2Platform CLI
gemini skills install https://github.com/pedronauck/skills --path skills/mine/deep-reviewManually: put the files in place
.devin/skills/deep-review/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pedronauck/skills --skill deep-review -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about deep-review
How do I install deep-review in Claude Code?
Run npx skills add pedronauck/skills --skill deep-review -a claude-code. The skill file is at ~/.claude/skills/deep-review/SKILL.md.
What does deep-review do?
It examines branch changes, a working tree, or a pull request, looking for defects and improvements while accounting for project rules. It can also compare code with a specification and produce a report; it does not make product fixes.
What does deep-review need to run?
The scripts require python3. External subagent calls consume compozy exec credit.