# alexwortega/ai-peer-review-skill architecture

> Architecture diagram of the GitHub repository alexwortega/ai-peer-review-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alexwortega/ai-peer-review-skill
- Repository: https://github.com/alexwortega/ai-peer-review-skill

## Overview

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: [`scripts/spawn_reviewers.py`](https://github.com/alexwortega/ai-peer-review-skill/blob/main/scripts/spawn_reviewers.py) (Reviewer launcher), [`SKILL.md`](https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md) (Skill instructions), [`prompts/metareview.md`](https://github.com/alexwortega/ai-peer-review-skill/blob/main/prompts/metareview.md) (Meta-review synthesis), [`scripts/arxiv_search.py`](https://github.com/alexwortega/ai-peer-review-skill/blob/main/scripts/arxiv_search.py) (arXiv search helper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Skill workflow"]
  node_skill["Skill instructions<br/>[SKILL.md]"]
  node_text["Paper text<br/>[SKILL.md]"]
end

subgraph group_review["Review generation"]
  node_launcher["Reviewer launcher<br/>[spawn_reviewers.py]"]
  node_standard["Reviewer template<br/>[reviewer.md]"]
  node_critic["Alignment critic template"]
  node_reviews["Independent reviews<br/>[SKILL.md]"]
end

subgraph group_research["Research support"]
  node_arxiv_helper["arXiv search helper<br/>[arxiv_search.py]"]
end

subgraph group_outputs["Review artifacts"]
  node_synthesis["Meta-review synthesis<br/>[metareview.md]"]
  node_meta["Meta-review<br/>[SKILL.md]"]
  node_concerns["Concerns CSV<br/>[SKILL.md]"]
  node_bundle["Results bundle<br/>[SKILL.md]"]
end

node_author(("Paper author"))
node_paper["Paper file"]
node_claude["Claude Code"]
node_arxiv["arXiv"]

node_author -->|"provides"| node_paper
node_paper -->|"submits to"| node_skill
node_skill -->|"extracts text"| node_text
node_skill -->|"launches reviewers"| node_launcher
node_text -->|"supplies paper text"| node_launcher
node_launcher -->|"selects template"| node_standard
node_launcher -->|"selects optionally"| node_critic
node_launcher -->|"spawns subprocesses"| node_claude
node_claude -->|"generates"| node_reviews
node_reviews -->|"searches when relevant"| node_arxiv_helper
node_arxiv_helper -->|"queries"| node_arxiv
node_skill -->|"uses for synthesis"| node_synthesis
node_reviews -->|"synthesizes"| node_synthesis
node_synthesis -->|"produces"| node_meta
node_reviews -->|"maps concerns"| node_concerns
node_meta -->|"bundles with reviews"| node_bundle
node_concerns -->|"bundles with reviews"| node_bundle

click node_skill "https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md"
click node_text "https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md"
click node_launcher "https://github.com/alexwortega/ai-peer-review-skill/blob/main/scripts/spawn_reviewers.py"
click node_standard "https://github.com/alexwortega/ai-peer-review-skill/blob/main/prompts/reviewer.md"
click node_critic "https://github.com/alexwortega/ai-peer-review-skill/blob/main/prompts/reviewer_alignment_forum.md"
click node_reviews "https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md"
click node_arxiv_helper "https://github.com/alexwortega/ai-peer-review-skill/blob/main/scripts/arxiv_search.py"
click node_synthesis "https://github.com/alexwortega/ai-peer-review-skill/blob/main/prompts/metareview.md"
click node_meta "https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md"
click node_concerns "https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md"
click node_bundle "https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_skill,node_text toneBlue
class node_launcher,node_standard,node_critic,node_reviews toneAmber
class node_arxiv_helper toneMint
class node_synthesis,node_meta,node_concerns,node_bundle toneRose
class node_author,node_paper,node_claude,node_arxiv toneIndigo
```

## Components

### Skill workflow

- [Skill instructions](https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md): `SKILL.md`
- [Paper text](https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md): `SKILL.md`

### Review generation

- [Reviewer launcher](https://github.com/alexwortega/ai-peer-review-skill/blob/main/scripts/spawn_reviewers.py): `scripts/spawn_reviewers.py`
- [Reviewer template](https://github.com/alexwortega/ai-peer-review-skill/blob/main/prompts/reviewer.md): `prompts/reviewer.md`
- [Alignment critic template](https://github.com/alexwortega/ai-peer-review-skill/blob/main/prompts/reviewer_alignment_forum.md): `prompts/reviewer_alignment_forum.md`
- [Independent reviews](https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md): `SKILL.md`

### Research support

- [arXiv search helper](https://github.com/alexwortega/ai-peer-review-skill/blob/main/scripts/arxiv_search.py): `scripts/arxiv_search.py`

### Review artifacts

- [Meta-review synthesis](https://github.com/alexwortega/ai-peer-review-skill/blob/main/prompts/metareview.md): `prompts/metareview.md`
- [Meta-review](https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md): `SKILL.md`
- [Concerns CSV](https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md): `SKILL.md`
- [Results bundle](https://github.com/alexwortega/ai-peer-review-skill/blob/main/SKILL.md): `SKILL.md`

### Other components

- **Paper author**
- **Paper file**
- **Claude Code**
- **arXiv**

## Connections

- Paper author → Paper file: provides (evidence: `README.md`)
- Paper file → Skill instructions: submits to (evidence: `README.md`)
- Skill instructions → Paper text: extracts text (evidence: `README.md`)
- Skill instructions → Reviewer launcher: launches reviewers (evidence: `README.md`)
- Paper text → Reviewer launcher: supplies paper text (evidence: `README.md`)
- Reviewer launcher → Reviewer template: selects template (evidence: `scripts/spawn_reviewers.py`)
- Reviewer launcher → Alignment critic template: selects optionally (evidence: `scripts/spawn_reviewers.py`)
- Reviewer launcher → Claude Code: spawns subprocesses (evidence: `scripts/spawn_reviewers.py`)
- Claude Code → Independent reviews: generates (evidence: `README.md`)
- Independent reviews → arXiv search helper: searches when relevant (evidence: `scripts/arxiv_search.py`)
- arXiv search helper → arXiv: queries (evidence: `scripts/arxiv_search.py`)
- Skill instructions → Meta-review synthesis: uses for synthesis (evidence: `README.md`)
- Independent reviews → Meta-review synthesis: synthesizes (evidence: `README.md`)
- Meta-review synthesis → Meta-review: produces (evidence: `README.md`)
- Independent reviews → Concerns CSV: maps concerns (evidence: `README.md`)
- Meta-review → Results bundle: bundles with reviews (evidence: `README.md`)
- Concerns CSV → Results bundle: bundles with reviews (evidence: `README.md`)
