Agent skill

Peer Review

by poemswe in poemswe/co-researcher

You must use this when critiquing academic manuscripts, evaluating methodological rigor, or providing structured reviewer feedback.

MITAuto-check passedResearch & Science

Install Peer Review

skills CLI
$ npx skills add poemswe/co-researcher --skill peer-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install poemswe/co-researcher peer-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/poemswe/co-researcher.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/peer-review .claude/skills/peer-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
peer-review
GitHub stars
130
Token cost
~1.1k tokens
SKILL.md length
507 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

You must use this when critiquing academic manuscripts, evaluating methodological rigor, or providing structured reviewer feedback.

  • Works in 3 steps: Dimensional Evaluation → Structural Critique → Decision Logic
  • Tasks that involve Peer review
  • SKILL.md covers 1. Dimensional Evaluation, 2. Structural Critique and 3. Decision Logic
  • Calls uv

What it does

Peer Review is an agent skill from poemswe/co-researcher. You must use this when critiquing academic manuscripts, evaluating methodological rigor, or providing structured reviewer feedback.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Research & Science, covering Peer review. The repository describes itself as: A professional research suite for conducting rigorous academic research using specialized agents and multi-platform CLI commands. Compatible with Claude Code, Gemini CLI, OpenAI… The licence is MIT.

When your agent uses it

  • Tasks that involve Peer review

Example prompts

  • “/peer-review”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Dimensional Evaluation
  2. Structural Critique
  3. Decision Logic

What it can do on your machine

Read from SKILL.md and the folder at commit 28c966f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Peer Review loads about 1.1k tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 507 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from poemswe/co-researcher at commit 28c966f, republished under its MIT licence (© poemswe). 507 words, ~1,116 tokens.

Download SKILL.mdSave it as .claude/skills/peer-review/SKILL.md (or your agent's skills folder).
name
peer-review
description
You must use this when critiquing academic manuscripts, evaluating methodological rigor, or providing structured reviewer feedback.
tools
WebSearch, WebFetch, Bash, Read, Grep, Glob
<role>
You are a PhD-level specialist in academic peer review with extensive experience editing for high-impact journals. Your goal is to provide constructive, rigorous, and clinical evaluations of research manuscripts to ensure they meet the highest global standards for contribution, methodology, and scholarly communication.
</role>
<principles>
- **Constructive Rigor**: Identify fatal flaws while providing actionable pathways for improvement.
- **Evidentiary Support**: Every critique point must be backed by specific evidence from the text or known methodological standards.
- **Contribution Assessment**: Focus heavily on whether the work provides a "significant original contribution" to the field.
- **Factual Integrity**: Never invent weaknesses or reference non-existent foundational papers.
- **Tone Professionalism**: Maintain a high-academic, clinical, and unbiased tone (the "Third Voice").
- **Quality Calibration**: Grade the manuscript based on its target venue (e.g., Nature/Science vs. specialized journals).
</principles>
<competencies>

1. Dimensional Evaluation

  • Significance/Novelty: Does it move the needle?
  • Methodological Soundness: Is the design appropriate and flawlessly executed?
  • Presentation/Clarity: Is the narrative arc cohesive and the data visualization professional?
  • Ethical Compliance: Are there concerns with sampling, COIs, or data reporting?

2. Structural Critique

  • Abstract/Introduction: Clear problem statement and stated contribution.
  • Results/Discussion: Correct interpretation and grounding in existing literature.
  • References: Identification of missing seminal works or over-citation of self.

3. Decision Logic

  • Accept: Rare, minor formatting only.
  • Major/Minor Revision: Path to publication exists.
  • Reject: Fatal flaws in methodology or lack of original contribution.
</competencies>
<protocol>
1. **Initial Reading**: Assess the core claim and the stated "Significance".
2. **Methodology Audit**: Systematically test the study's validity and reliability.
3. **Evidence Alignment**: Check if the results actually support the discussion's claims.
4. **Contribution Mapping**: Position the work within the current landscape of the field. Use the `literature-review` backends here (see `<source_resolution>`) to check the manuscript's key references and to search for missed seminal or contradicting work.
5. **Reference Audit**: Spot-check the manuscript's load-bearing citations — resolve each through OpenAlex or Europe PMC. A reference that cannot be resolved, or whose actual findings differ from how it is characterized, becomes a Major Point.
6. **Report Generation**: Synthesize findings into a formal Reviewer Report.
</protocol>
Show full SKILL.md (169 more words)Show less

<source_resolution> Verify references and survey the field through the database backends owned by the literature-review skill, not web search alone: uv run <literature-review-dir>/scripts/openalex_cli.py (resolve DOIs/titles, citation counts, related work), europepmc_api.py (life-science full text and citation graphs), search_arxiv.py (preprints), read_paper.py (full text for any DOI/arXiv/PMCID — use it to read a cited paper before asserting it was mischaracterized). Prerequisite uv: see the literature-review skill's <search_backend> section for setup and invocation details. </source_resolution>

<output_format>

Peer Review Report: [Title/Subject]

Recommendation: [Accept/Minor Rev/Major Rev/Reject]

Executive Summary: [2-3 sentences on core contribution and primary concern]

Dimensional Scores (1-5):

  • Novelty: [S] | Rigor: [S] | Impact: [S] | Clarity: [S]

Detailed Comments:

  • Major Points:
    1. [Point] | [Evidence] | [Actionable Change]
  • Minor Points:
    1. [Formatting, Citations, Typos]

Final Verdict Justification: [Detailed PhD-level reasoning for the recommendation] </output_format>

<checkpoint>
After the review, ask:
- Should I check for specific "Seminal Works" that might have been missed?
- Would you like me to refine the "Response to Reviewers" strategy?
- Should I analyze the manuscript's fit for a specific target journal (e.g., CVPR, Nature, NEJM)?
</checkpoint>

© poemswe, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/peer-review of poemswe/co-researcher.

Open the folder on GitHubat commit 28c966f

Compare with similar skills

Peer Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Peer Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Peer Review this skillpoemswe/co-researcher130—~1.1kAutomated safety check: PassMIT
Peer Reviewspacering-net/codeg3.9k17 repos~5.9kAutomated safety check: NotesMIT
Scholar Evaluationspacering-net/codeg3.9k11 repos~3.2kAutomated safety check: PassMIT
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Academic Paper ReviewerImbad0202/academic-research-skills51k—~11kAutomated safety check: PassCustom licence
Peer ReviewK-Dense-AI/claude-scientific-writer2.4k2 repos~3.1kAutomated safety check: NotesMIT

Similar skills

  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.9k GitHub starsUsed in 17 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Scholar Evaluation

    spacering-net/codeg

    Systematically evaluate scholarly work using the ScholarEval framework, providing structured assessment across research quality dimensions including problem formulation, methodology, analysis, and…

    3.9k GitHub starsUsed in 11 repos~3.2k tokens
    Research & ScienceAuto-check passed
  • Academic Paper Writing Pipeline

    Imbad0202/academic-research-skills

    Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.

    51k GitHub stars~16k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Academic Paper Reviewer

    Imbad0202/academic-research-skills

    Simulates a journal peer review of a manuscript with a five-seat reviewer panel, an editorial synthesizer and several review modes.

    51k GitHub stars~11k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Peer Review

    K-Dense-AI/claude-scientific-writer

    Prepare evidence-bounded, constructive peer-review drafts and structured manuscript assessments.

    2.4k GitHub starsUsed in 2 repos~3.1k tokens
    Research & ScienceAuto-check: notes
  • Academic Research Pipeline

    Imbad0202/academic-research-skills

    Orchestrates a ten-stage academic workflow from research to finished manuscript, including integrity checks, two rounds of peer review and revision.

    51k GitHub stars~15k tokensUpdated yesterday
    Research & ScienceAuto-check passed

More from poemswe/co-researcher

All 15 skills in this repo
  • Literature Review

    poemswe/co-researcher

    You must use this when synthesizing existing knowledge, identifying research gaps, or tracing the evolution of scientific ideas.

    130 GitHub stars~3.6k tokensUpdated today
    Auto-check: notes
  • Research Manager

    poemswe/co-researcher

    Use this when starting a new research project or managing a complex, multi-step research workflow.

    130 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Academic Writing

    poemswe/co-researcher

    You must use this when producing any research prose — literature reviews, syntheses, analyses, methodology descriptions, discussion sections, abstracts, or any written output intended for an…

    130 GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Critical Analysis

    poemswe/co-researcher

    You must use this when analyzing claims, evaluating evidence, or Identifying logical fallacies in research.

    130 GitHub stars~781 tokensUpdated today
    Auto-check passed
  • Ethics Review

    poemswe/co-researcher

    You must use this when identifying ethical risks, ensuring participant privacy, or preparing IRB applications.

    130 GitHub stars~809 tokensUpdated today
    Auto-check passed
  • Grant Writing

    poemswe/co-researcher

    You must use this when drafting grant proposals, refining research aims, or aligning projects with agency priorities.

    130 GitHub stars~815 tokensUpdated today
    Auto-check passed

Questions about Peer Review

What does Peer Review do?

You must use this when critiquing academic manuscripts, evaluating methodological rigor, or providing structured reviewer feedback. Peer Review is an agent skill from poemswe/co-researcher. You must use this when critiquing academic manuscripts, evaluating methodological rigor, or providing structured reviewer feedback.

When should I use Peer Review?

Peer Review fits situations like: tasks that involve Peer review.

How do I install Peer Review in Claude Code?

Run `npx skills add poemswe/co-researcher --skill peer-review -a claude-code`. Or copy the skill folder (skills/peer-review in poemswe/co-researcher) into .claude/skills/peer-review in your project. Claude Code loads it when a task matches its description.

How do I install Peer Review in Codex?

Run `npx skills add poemswe/co-researcher --skill peer-review -a codex`. Or copy the skill folder (skills/peer-review in poemswe/co-researcher) into .agents/skills/peer-review in your project. Codex loads it when a task matches its description.

Can I use Peer Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add poemswe/co-researcher --skill peer-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/peer-review, .gemini/skills/peer-review, .github/skills/peer-review and .opencode/skills/peer-review in your project.

What does Peer Review need to run?

Going by SKILL.md and its folder, Peer Review needs the command-line tools its instructions call (uv).

Does Peer Review access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Peer Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Peer Review use?

Peer Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Peer Review use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Peer Review?

Skills that share tags, products or a category with Peer Review: Peer Review (spacering-net/codeg, 3.9k stars), Scholar Evaluation (spacering-net/codeg, 3.9k stars), Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars) and Academic Paper Reviewer (Imbad0202/academic-research-skills, 51k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Peer Review?

poemswe (a GitHub user) maintains it in poemswe/co-researcher, which has 130 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 10, 2026.

Source: poemswe/co-researcher on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.