Skip to main content
skill CX Codex

spec-peer-review — Claude Code skill: review specs

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.

no license 161 installs ★ 655 updated 2026-10-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add pedronauck/skills --skill spec-peer-review -a claude-code
Open on GitHub

What spec-peer-review 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.

What it helps with

  • 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 for the agent

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

How to install spec-peer-review

1Skills CLI (Vercel)

npx skills add pedronauck/skills --skill spec-peer-review -a claude-code

2Manually: put the files in place

~/.claude/skills/spec-peer-review/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/spec-peer-review/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about spec-peer-review

How do I install spec-peer-review in Claude Code?

Run npx skills add pedronauck/skills --skill spec-peer-review -a claude-code, then check ~/.claude/skills/spec-peer-review/SKILL.md.

What does spec-peer-review do?

It performs one independent pass over an approved planning document and produces findings for the user to accept selectively. The result is validated before the verdict is reported.

Does spec-peer-review inspect implementation code?

No. Its scope is specifications, design documents, RFCs, and detailed PRDs; implementation reviews are excluded.

Similar skills

All skills for Science and research →

From the same set52

The whole set →
herdr-orchestration herdr-orchestration controls interactive Claude and Codex worker TUIs in dedicated herdr tabs using socket CLI commands. CX Codex +1 210installs writing-tech-post writing-tech-post — a skill for writing and editing engineering posts with supported claims. Use it to draft new articles, rework existing drafts, or review content before publication. CX Codex +1 182installs ship-pr ship-pr delivers finished work with documentation audits, release note grouping, compliant commits, and a pull request. CX Codex +1 181installs kb-yt-channel kb-yt-channel — a skill that builds Karpathy KB topics from YouTube channels: the agent fetches transcripts, organizes them into topic folders, validates structure, and creates search indexes. CX Codex +1 175installs yc-apply yc-apply is a skill for preparing and checking Y Combinator applications, founder-video notes, interview practice, and reapplication materials based on verified facts. CX Codex +1 158installs autoresearch autoresearch runs another skill through repeated test cycles, grades each output against pass/fail checks, and rewrites its prompt until the score stops climbing. CX Codex +1 152installs insta-master insta-master is a Claude Code skill for planning Instagram content, refining profiles, diagnosing reach, and designing growth or monetization experiments. CX Codex +1 131installs yt-master yt-master — a skill for YouTube work: sharpens the idea, title, thumbnail concept and script, then reads the metrics when views or CTR slip. CX Codex +1 128installs

Project sponsors

Companies that keep this analytics open