peer-review-initiator — Claude Code skill
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.
LicenseRef-Proprietary 133 installs ★ 50 updated 2026-01-05
npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -a claude-codeWhat peer-review-initiator 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.
What it helps with
- 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 for the agent
- 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.
How to install peer-review-initiator
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -a claude-code2Manually: put the files in place
~/.claude/skills/peer-review-initiator/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/peer-review-initiator/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -a codex2Manually: put the files in place
.agents/skills/peer-review-initiator/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -a cursor2Manually: put the files in place
.cursor/skills/peer-review-initiator/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install qodex-ai/ai-agent-skills skills/peer-review-initiator2Manually: put the files in place
.github/skills/peer-review-initiator/SKILL.md1Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -a gemini-cli2Platform CLI
gemini skills install https://github.com/qodex-ai/ai-agent-skills --path skills/peer-review-initiatorManually: put the files in place
.devin/skills/peer-review-initiator/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -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 peer-review-initiator
How to install peer-review-initiator in Claude Code?
Run npx skills add qodex-ai/ai-agent-skills --skill peer-review-initiator -a claude-code. The skill lands in ~/.claude/skills/peer-review-initiator/SKILL.md.
What does peer-review-initiator do?
It assembles a code review request with commit SHAs and a description of the changes and requirements, sends it to the superpowers:code-reviewer subagent, then helps you work through the answer.
What does it need to run?
The superpowers:code-reviewer subagent and the requesting-code-review/code-reviewer.md template, whose placeholders the skill fills in.