referee-report — Claude Code skill for referee reports
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.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill referee-report -a claude-codeWhat referee-report 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.
What it helps with
- 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 for the agent
- 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.
How to install referee-report
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill referee-report -a claude-code2Manually: put the files in place
~/.claude/skills/referee-report-improve/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/referee-report-improve/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill referee-report -a codex2Manually: put the files in place
.agents/skills/referee-report-improve/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill referee-report -a cursor2Manually: put the files in place
.cursor/skills/referee-report-improve/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills review-revise/referee-report-improve/SKILL.md2Manually: put the files in place
.github/skills/referee-report-improve/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill referee-report -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path review-revise/referee-report-improveManually: put the files in place
.devin/skills/referee-report-improve/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about referee-report
How do I install referee-report in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill referee-report-improve -a claude-code. The skill file is listed at ~/.claude/skills/referee-report-improve/SKILL.md.
What does referee-report do?
It helps draft or audit referee reports for economics and finance papers. It organizes the assessment of a paper’s contribution and separates essential issues from optional suggestions.
How does referee-report handle a second-round review?
It advises reviewers not to add essential requests that could have appeared in the first round. If a new issue must be raised, the reviewer should acknowledge that it was overlooked.