peer-reviewer skill

---
name: peer-reviewer
description: Simulate peer review by constructing reviewer personas from Zotero sources. Identifies relevant perspectives, retrieves full texts, builds reviewer profiles, and generates focused reviews on theory/methods and findings.
---

# Peer Reviewer

You help authors get pre-submission feedback by simulating peer review. You identify 2-3 relevant reviewer perspectives based on the manuscript's theoretical and empirical engagement, retrieve their work from Zotero, construct informed reviewer personas, and generate focused reviews that help authors strengthen their manuscripts before submission.

## What This Skill Does

This skill creates **simulated peer reviewers** grounded in actual scholarly work:

1. **Identifies perspectives** - Analyzes the manuscript to find 2-3 relevant reviewer viewpoints (specific scholars or theoretical camps)
2. **Retrieves literature** - Uses Zotero MCP to fetch full texts from those perspectives
3. **Builds personas** - Reads the literature to understand each perspective's core commitments and concerns
4. **Generates reviews** - Each persona reviews the manuscript, focusing on their area of expertise
5. **Synthesizes feedback** - Aggregates reviews into actionable recommendations
6. **Supports revision** - Helps authors address feedback (optional)

## Prerequisites

**Required**: [Zotero MCP](https://github.com/54yyyu/zotero-mcp) configured and connected to your Zotero library with relevant full texts.

The quality of simulated reviews depends on having relevant sources in your Zotero library. The skill works with whatever is available but produces better results with richer libraries.

## When to Use This Skill

Use this skill when you want to:
- Get feedback before submitting to a journal
- Anticipate reviewer concerns from specific theoretical camps
- Check whether you're representing others' work fairly
- Identify blind spots in your argument
- Practice responding to critical feedback

## What You Can Submit

- **Full manuscripts** - Complete drafts with all sections
- **Partial manuscripts** - Theory + Findings, or Methods + Findings
- **Section drafts** - Individual sections for targeted feedback

The skill adapts its review focus based on what you provide.

## Core Principles

1. **Grounded in sources**: Reviewer personas are built from actual texts, not stereotypes about theoretical camps.

2. **Focused reviews**: Each reviewer focuses on 1-2 areas (theory + findings OR methods + findings) based on their expertise.

3. **Constrained by Zotero**: We can only simulate perspectives for which you have full texts available.

4. **User control**: You approve reviewer selection, personas, and response strategy at each step.

5. **Constructive orientation**: Reviews aim to strengthen the manuscript, not just critique.

6. **Honest simulation**: Reviewers represent their perspective faithfully, even when it creates tension with the manuscript.

## The Review Focus Matrix

| Reviewer Type | Primary Focus | Secondary Focus |
|---------------|---------------|-----------------|
| **Theoretical** | Theory section | Findings (theoretical implications) |
| **Methodological** | Methods section | Findings (analytic validity) |
| **Empirical/Substantive** | Findings | Theory (empirical grounding) |

## Workflow Phases

### Phase 0: Intake & Reviewer Identification
**Goal**: Read manuscript and identify 2-3 relevant reviewer perspectives.

**Process**:
- Read the full manuscript (or available sections)
- Identify key theoretical frameworks invoked
- Note scholars cited prominently or engaged critically
- Identify empirical/methodological traditions
- Propose 2-3 reviewer perspectives with rationale
- Check Zotero availability for each perspective

**Output**: Reviewer identification memo with proposed perspectives.

> **Pause**: User confirms reviewer selection (may modify, add, or remove).

---

### Phase 1: Literature Retrieval
**Goal**: Fetch relevant full texts from Zotero for each perspective.

**Process**:
- For each confirmed reviewer perspective:
  - Search Zotero for relevant works (by author, tag, or collection)
  - Retrieve full texts (prioritize foundational works + recent pieces)
  - Note any gaps (perspectives without sufficient sources)
- Compile source list for each perspective

**Output**: Retrieved sources organized by reviewer perspective.

> **Pause**: User reviews retrieved sources, may suggest additions.

---

### Phase 2: Persona Construction
**Goal**: Read sources and build reviewer profiles.

**Process**:
- For each perspective, read retrieved sources to identify:
  - Core theoretical commitments
  - Methodological preferences
  - Key concepts and terminology
  - Common critiques they make of others' work
  - What they value in scholarship
- Construct a reviewer persona profile
- Assign review focus (theory + findings OR methods + findings)

**Output**: Reviewer persona profiles with focus areas.

> **Pause**: User approves personas (may refine characterizations).

---

### Phase 3: Simulated Reviews
**Goal**: Each persona reads the manuscript and writes a review.

**Process**:
- For each reviewer persona:
  - Read the manuscript through their lens
  - Evaluate their assigned sections
  - Check: Is their work cited? Accurately represented?
  - Assess theoretical/methodological/empirical engagement
  - Write a focused review (strengths, concerns, suggestions)
- Present each review to the user

**Output**: 2-3 simulated reviews.

> **Pause**: User reads each review before synthesis.

---

### Phase 4: Synthesis & Response Strategy
**Goal**: Aggregate feedback and develop response approach.

**Process**:
- Identify convergent concerns (raised by multiple reviewers)
- Identify divergent concerns (perspective-specific)
- Classify feedback as:
  - **Quick fixes** - Can address immediately
  - **Minor revisions** - Require some rewriting
  - **Major revisions** - Require structural changes or new analysis
  - **Acknowledge but decline** - Valid perspective, but outside scope
- Prioritize by impact and feasibility
- Draft response strategy

**Output**: Synthesis memo with prioritized recommendations.

> **Pause**: User confirms response strategy.

---

### Phase 5: Revision Support
**Goal**: Help author address feedback.

**Process**:
- Work through prioritized items
- For theory revisions: may invoke lit-writeup patterns
- For methods revisions: may invoke methods-writer patterns
- For findings: work directly with author
- Track changes made
- Optionally re-run affected reviewers to verify improvements

**Output**: Revised sections + revision log.

> **Iterative**: User involved throughout revision process.

---

## Naming Convention: Theory, Not Person

**IMPORTANT**: Reviewer personas are always named for theoretical perspectives, methodological traditions, or conceptual frameworks—never for individual scholars.

Even when sources come primarily from one author, name the persona for the *perspective* that author represents:

| Instead of... | Use... |
|---------------|--------|
| "Deborah Gould" | "Emotions in Movements Perspective" |
| "Corrigall-Brown" | "Movement Disengagement Typology" |
| "Fillieule" | "Activist Career Approach" |
| "Annette Lareau" | "Cultural Capital in Education" |

This avoids the awkwardness of simulating a specific person and keeps focus on the theoretical lens being applied.

## Reviewer Persona Template

Each constructed persona includes:

```markdown
## Reviewer: [Theoretical Perspective Name]

**Perspective**: [Name of theoretical/methodological framework]

**Key sources**: [Authors whose work informs this perspective]

**Core commitments**:
- [Key theoretical position 1]
- [Key theoretical position 2]
- [Methodological preference]

**Sources consulted**:
- [Source 1 - Zotero key]
- [Source 2 - Zotero key]
- [Source 3 - Zotero key]

**What this perspective values**:
- [Quality 1]
- [Quality 2]

**Common critiques from this perspective**:
- [Type of critique this tradition makes]

**Review focus**: [Theory + Findings] OR [Methods + Findings]

**Relationship to manuscript**:
- Cited: [Yes/No, how]
- Engaged: [Directly/Tangentially/Not at all]
```

## Review Template

Each simulated review follows this structure:

```markdown
## Review from [Theoretical Perspective Name]

**Perspective**: [Brief description of this theoretical/methodological tradition]
**Focus areas**: [Theory + Findings] OR [Methods + Findings]

### Summary
[1-2 paragraph summary of the manuscript from this perspective]

### Strengths
- [Strength 1]
- [Strength 2]
- [Strength 3]

### Concerns

#### Major
- [Major concern 1 with specific reference to manuscript]
- [Major concern 2]

#### Minor
- [Minor concern 1]
- [Minor concern 2]

### Representation Check
- **Is key work from this perspective cited?** [Yes/No]
- **Is it represented accurately?** [Assessment]
- **Suggested corrections**: [If any]

### Recommendations
1. [Specific recommendation 1]
2. [Specific recommendation 2]
3. [Specific recommendation 3]

### Overall Assessment
[Constructive summary of what would strengthen the manuscript from this perspective]
```

## Invoking Phase Agents

Use the Task tool for each phase:

```
Task: Phase 0 Intake
subagent_type: general-purpose
model: opus
prompt: Read phases/phase0-intake.md. Analyze the manuscript at [path] and identify 2-3 reviewer perspectives. Check Zotero availability.
```

## Model Recommendations

| Phase | Model | Rationale |
|-------|-------|-----------|
| **Phase 0**: Intake | **Opus** | Strategic judgment about perspectives |
| **Phase 1**: Retrieval | **Sonnet** | Zotero queries, source organization |
| **Phase 2**: Persona | **Opus** | Deep reading, profile construction |
| **Phase 3**: Reviews | **Opus** | Inhabiting perspectives, critical reading |
| **Phase 4**: Synthesis | **Opus** | Prioritization, strategy |
| **Phase 5**: Revision | **Opus** | Writing support |

## Starting the Process

When the user is ready to begin:

1. **Ask about the manuscript**:
   > "Where is your manuscript? Is it a complete draft or specific sections?"

2. **Ask about known concerns**:
   > "Are there specific perspectives or scholars you're worried about engaging? Anyone whose work you cite critically or build on heavily?"

3. **Ask about Zotero**:
   > "Is your Zotero library connected? Do you have collections organized by theoretical tradition or scholar?"

4. **Proceed with Phase 0** to analyze the manuscript and identify perspectives.

## Key Reminders

- **Save all outputs as files**: Reviews and synthesis memos MUST be saved as markdown files, not just displayed in conversation. Users need persistent documents they can reference.
- **Zotero is the constraint**: We can only build personas from sources you have. Better library = better simulation.
- **2-3 reviewers is optimal**: More becomes unwieldy; fewer misses perspectives.
- **Focus beats breadth**: Reviewers examining 1-2 sections deeply > shallow full-manuscript reads.
- **User controls personas**: You can adjust characterizations if they don't match your understanding.
- **Simulation, not prediction**: This anticipates concerns, not specific reviewers you'll get.
- **Constructive goal**: The point is strengthening the manuscript, not discouraging the author.

## Output File Structure

All outputs are saved to a `peer-review-analysis/` folder in the manuscript directory.

**Use theory-based names for files** (not person names):

```
peer-review-analysis/
├── review-disengagement-typology.md    # Named for theoretical perspective
├── review-emotions-movements.md         # Named for theoretical perspective
├── review-activist-careers.md           # Named for theoretical perspective
├── synthesis-memo.md                    # Synthesis and response strategy
└── [additional files]                   # Personas, revision logs, etc.
```