# referee-report

Draft or audit referee reports for economics and finance papers. Use it to assess a paper’s contribution and distinguish publication-critical issues from optional suggestions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 240 repo stars
- Author: franklee16
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franklee16/academic-research-skills/tree/HEAD/review-revise/referee-report-improve/SKILL.md
- Updated: 2026-09-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/referee-report

## What it does

The skill supports two tasks: preparing a new report and reviewing a finished or near-finished draft. For a first-round report, it lays out a summary and assessment of importance, essential issues, and optional suggestions. That distinction helps editors see which points affect the publication decision.

Before drafting, it prompts the reviewer to consider conflicts of interest, prior reviews of the paper, anonymity, and subject fit. For a second-round report, it advises against adding essential demands that could have been raised earlier. An R&R recommendation also carries a commitment: once the authors address the essential concerns, the reviewer should recommend acceptance.

Install it in Claude Code with the command below. If the request does not make clear whether you want help drafting or auditing a report, the skill asks you to choose a mode.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill referee-report -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/referee-report-improve/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/referee-report-improve/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill referee-report -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/referee-report-improve/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill referee-report -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/referee-report-improve/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franklee16/academic-research-skills review-revise/referee-report-improve/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/referee-report-improve/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill referee-report -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path review-revise/referee-report-improve
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/referee-report-improve/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franklee16/academic-research-skills/tree/HEAD/review-revise/referee-report-improve/SKILL.md

## When to use it
- structure a referee report for a paper
- assess a paper’s contribution to a journal
- separate publication-critical issues from optional suggestions
- audit a draft against reviewing principles
- review a paper’s revisions in a second round

## Example prompts
- Help me draft a referee report for this economics paper; first check for conflicts of interest and subject fit.
- Audit my referee report and separate publication-critical issues from optional suggestions.
- I recommended R&R. Check that my second-round comments do not add new essential demands.

## Similar
- [top5-framing](https://affpapa.org/en/nevibecode/skills/top5-framing.md) — skill · ★ 165 repo stars
- [edmans-audit](https://affpapa.org/en/nevibecode/skills/edmans-audit.md) — skill · ★ 165 repo stars
- [project-referee](https://affpapa.org/en/nevibecode/skills/project-referee.md) — skill · 1 install
- [paper-audit](https://affpapa.org/en/nevibecode/skills/paper-audit.md) — skill · 3600 installs
- [academic-paper-writer](https://affpapa.org/en/nevibecode/skills/academic-paper-writer.md) — skill · 522 installs
- [academic-research-suite](https://affpapa.org/en/nevibecode/skills/academic-research-suite.md) — skill · 2200 installs

From the same set: [franklee16/academic-research-skills](https://affpapa.org/en/nevibecode/by/franklee16/academic-research-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
