How alexwortega/ai-peer-review-skill works
This Claude Code skill turns an academic paper into independent reviews and consolidated outputs. The documented workflow accepts PDF, DOCX, text, or Markdown input; extracts its text; launches anonymized reviewer subagents; then synthesizes a meta-review and concerns matrix. Reviewer prompts include a standard template and an optional Alignment Forum-style critic. Reviewers can use the arXiv search helper to check novelty. The README documents the stages and artifacts; source excerpts show the subprocess launcher and search helper, but not the skill’s extraction or synthesis implementation.
Main entry points: spawn_reviewers.py Reviewer launcher · SKILL.md Skill instructions · metareview.md Meta-review synthesis · arxiv_search.py arXiv search helper
Components 15
Skill workflow
- Skill instructions
SKILL.md - Paper text
SKILL.md
Review generation
- Reviewer launcher
scripts/spawn_reviewers.py - Reviewer template
prompts/reviewer.md - Alignment critic template
prompts/reviewer_alignment_forum.md - Independent reviews
SKILL.md
Research support
- arXiv search helper
scripts/arxiv_search.py
Review artifacts
- Meta-review synthesis
prompts/metareview.md - Meta-review
SKILL.md - Concerns CSV
SKILL.md - Results bundle
SKILL.md
Other components
- Paper author
- Paper file
- Claude Code
- arXiv
Connections 17
- Paper author → Paper file: provides
README.md - Paper file → Skill instructions: submits to
README.md - Skill instructions → Paper text: extracts text
README.md - Skill instructions → Reviewer launcher: launches reviewers
README.md - Paper text → Reviewer launcher: supplies paper text
README.md - Reviewer launcher → Reviewer template: selects template
scripts/spawn_reviewers.py - Reviewer launcher → Alignment critic template: selects optionally
scripts/spawn_reviewers.py - Reviewer launcher → Claude Code: spawns subprocesses
scripts/spawn_reviewers.py - Claude Code → Independent reviews: generates
README.md - Independent reviews → arXiv search helper: searches when relevant
scripts/arxiv_search.py - arXiv search helper → arXiv: queries
scripts/arxiv_search.py - Skill instructions → Meta-review synthesis: uses for synthesis
README.md - Independent reviews → Meta-review synthesis: synthesizes
README.md - Meta-review synthesis → Meta-review: produces
README.md - Independent reviews → Concerns CSV: maps concerns
README.md - Meta-review → Results bundle: bundles with reviews
README.md - Concerns CSV → Results bundle: bundles with reviews
README.md