Agent skill

General Peer Review

by learningmatter-mit in learningmatter-mit/AtomisticSkills

Act as a reviewer to critically review research plans, manuscripts, or task summaries, pointing out missing baselines, statistical flaws, and weak assumptions.

MITAuto-check passedResearch & Science

Install General Peer Review

skills CLI
$ npx skills add learningmatter-mit/AtomisticSkills --skill general-peer-review -a claude-code

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

GitHub CLI
$ gh skill install learningmatter-mit/AtomisticSkills general-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/learningmatter-mit/AtomisticSkills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/general-peer-review .claude/skills/general-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
general-peer-review
GitHub stars
176
Token cost
~1.3k tokens
SKILL.md length
571 words
Files
2
Skills in repo
129
Repo updated
First seen
Licence
MIT

At a glance

Act as a reviewer to critically review research plans, manuscripts, or task summaries, pointing out missing baselines, statistical flaws, and weak assumptions.

  • Works in 5 steps: Review Initialization → Literature-Based Validation → Methodological & Reproducibility Critique → …
  • Tasks that involve Peer review
  • SKILL.md covers Goal, Prerequisites, Instructions and Document-Specific Workflows, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

General Peer Review is an agent skill from learningmatter-mit/AtomisticSkills. Act as a reviewer to critically review research plans, manuscripts, or task summaries, pointing out missing baselines, statistical flaws, and weak assumptions.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `examples/workflow-review/README.md`).

It sits in Research & Science, covering Peer review. The repository describes itself as: Integrating AtomisticSkills into Agentic IDEs (Cursor, Claude Code, Codex, Google Antigravity, Hermes Agent, etc). The licence is MIT.

When your agent uses it

  • Tasks that involve Peer review

Example prompts

  • “/general-peer-review”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Review Initialization
  2. Literature-Based Validation
  3. Methodological & Reproducibility Critique
  4. Baseline & Validation Requirements
  5. Constructive Feedback Generation

What it can do on your machine

Read from SKILL.md and the folder at commit 6257444. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    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

General Peer Review loads about 1.3k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 571 words of instructions outside code blocks.

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

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 learningmatter-mit/AtomisticSkills at commit 6257444, republished under its MIT licence (© learningmatter-mit). 571 words, ~1,311 tokens.

Download SKILL.mdSave it as .claude/skills/general-peer-review/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
general-peer-review
description
Act as a reviewer to critically review research plans, manuscripts, or task summaries, pointing out missing baselines, statistical flaws, and weak assumptions.
metadata.category
general

General Peer Review

Goal

To rigorously evaluate a research plan, manuscript, or simulation workflow prior to execution or publication. This skill acts as an adversarial reviewer, ensuring scientific rigor by identifying methodological gaps, demanding adequate statistical sampling, highlighting weak assumptions, and suggesting necessary baseline comparisons.

Prerequisites

  • A completed or drafted piece of scientific writing (e.g., research_plan.md, manuscript draft, or experimental summary).
  • Sufficient contextual knowledge regarding the specific simulation or machine-learning methodology being proposed.

Instructions

  1. Review Initialization The agent initializes the review process by loading the target document into memory. This can be done by standard reading tools like view_file.

  2. Literature-Based Validation The agent utilizes skills like general-query-literature-database or general-deep-research to ground the review in established scientific facts.

    • Perform a literature search regarding the specific materials, methodologies, or baseline properties stated in the text.
    • Point out discrepancies between the proposed approach and standard practices found in high-impact journals.
  3. Methodological & Reproducibility Critique The agent systematically analyzes the methodology for common theoretical and computational pitfalls:

    • Ensemble & Sampling: Verify if MD simulations are long enough to reach equilibration and if the number of samples is statistically significant.
    • Level of Theory: Question if the chosen MLIP or DFT functional is adequate for the specific property being computed (e.g., PBE vs. r2SCAN, dispersion corrections for molecular systems).
    • System Size: Check if the supercell size is large enough to avoid finite-size effects and self-interaction (e.g., in defect or dopant studies).
    • Hyperparameters: Ensure critical hyperparameter choices (e.g., $k$-point grid density, energy cutoffs, learning rates) are justified.
    • Reproducibility: Are all protocols, scripts, and model checkpoints adequately specified to allow independent reproduction? Have data availability standards been met?
  4. Baseline & Validation Requirements The agent identifies whether the document includes proper validation checks:

    • Are there missing benchmark/control experiments?
    • Should a preliminary convergence test or standard reference calculation (e.g., bulk defect-free relaxation) be performed first?
    • How does the expected output compare to known literature values?
  5. Constructive Feedback Generation The agent outputs a set of formatted comments, structurally divided into:

    • Summary Statement: Brief synopsis of the research, overall recommendation (accept, revisions, reject), and key strengths/weaknesses.
    • Major Concerns: Fundamental methodological flaws that could invalidate findings. Number these sequentially. For each concern: state the issue, explain why it's problematic, and suggest actionable solutions.
    • Minor Concerns: Suggestions to strengthen clarity, formatting, data presentation, or typographical errors (e.g., "Add error bars on ionic conductivity plots").
    • Questions for Authors: Specific points requiring clarification that must be addressed to fully evaluate the work.
Show full SKILL.md (163 more words)Show less

Document-Specific Workflows

original Research Manuscripts
  • Emphasize methodological rigor, proper validation, and significance.
  • Evaluate the comprehensiveness of literature coverage and appropriateness of citations.
Scientific Presentations (PowerPoint / PDF)

[!WARNING] MANDATORY: For presentations, NEVER attempt to read the PDF text directly. ALWAYS use visual inspection.

  • Process: First convert the PDF to images (e.g., via standard Python PDF-to-image libraries) and use a Vision-Language Model (VLM) for visual inspection slide by slide.
  • Evaluation Criteria: Check for text overflow, overlapping elements, unreadable font sizes (< 18pt), unlabelled axes, and poor color contrast.
  • Reporting: Note visual formatting issues by specific slide number.

Examples

To see how the reviewer evaluates a proposed Action Plan for scientific methodology and reproducibility, see the Workflow Review Discussion example.

Constraints

  • Scope: Keep feedback strictly focused on scientific rigor, theoretical methodology, and validity of conclusions. Avoid purely stylistic copy-editing unless clarity is severely compromised.
  • Tone: Critical, objective, and scientifically rigorous (emulating a stringent peer review process).

See Also


Author: Bowen Deng Contact: GitHub @learningmatter-mit

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

Files

SKILL.md and 1 other file in skills/general-peer-review of learningmatter-mit/AtomisticSkills.

  • SKILL.md
  • examples/workflow-review/README.md

Open the folder on GitHubat commit 6257444

Compare with similar skills

General 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.

General Peer Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
General Peer Review this skilllearningmatter-mit/AtomisticSkills176—~1.3kAutomated safety check: PassMIT
Peer Reviewspacering-net/codeg3.8k18 repos~5.9kAutomated safety check: NotesMIT
Scholar Evaluationspacering-net/codeg3.8k12 repos~3.2kAutomated safety check: PassMIT
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
LLM Counciltenfoldmarc/llm-council-skill8192 repos~4.2kAutomated safety check: PassNone
Academic Paper ReviewerImbad0202/academic-research-skills51k—~11kAutomated safety check: PassCustom licence

Similar skills

  • Peer Review

    spacering-net/codeg

    Structured manuscript/grant review with checklist-based evaluation.

    3.8k GitHub starsUsed in 18 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.8k GitHub starsUsed in 12 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 5 days ago
    Research & ScienceAuto-check passed
  • LLM Council

    tenfoldmarc/llm-council-skill

    Run any question, idea, or decision through a council of 5 AI advisors who independently analyze it, peer-review each other anonymously, and synthesize a final verdict.

    819 GitHub starsUsed in 2 repos~4.2k tokens
    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 5 days ago
    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

More from learningmatter-mit/AtomisticSkills

All 129 skills in this repo
  • Drug Binding Site Definition

    learningmatter-mit/AtomisticSkills

    Define a docking search box (center coordinates + box dimensions in Angstroms) from a co-crystal ligand, binding-site residues, or a saved JSON specification.

    176 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Drug Complex System Builder

    learningmatter-mit/AtomisticSkills

    Build a solvated, charge-neutralized protein-ligand complex for OpenMM molecular dynamics simulation.

    176 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Drug Pocket Detection

    learningmatter-mit/AtomisticSkills

    Identify and rank ligandable pockets on a protein structure or model using geometry (fpocket) or an ML predictor (P2Rank).

    176 GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Chem Bond Dissociation

    learningmatter-mit/AtomisticSkills

    Calculate homolytic and heterolytic bond dissociation energies (BDEs) for all single bonds in a molecule using MLIPs with RDKit fragmentation.

    176 GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Chem Conformer Search

    learningmatter-mit/AtomisticSkills

    Generate molecular conformers with RDKit ETKDG, relax with MLIPs, and rank by energy with Boltzmann weighting.

    176 GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Chem DB Mof

    learningmatter-mit/AtomisticSkills

    Query multiple MOF databases (QMOF via MPContribs; ARC-MOF DB7/Majumdar et al.

    176 GitHub stars~1.9k tokensUpdated today
    Auto-check passed

Questions about General Peer Review

What does General Peer Review do?

Act as a reviewer to critically review research plans, manuscripts, or task summaries, pointing out missing baselines, statistical flaws, and weak assumptions. General Peer Review is an agent skill from learningmatter-mit/AtomisticSkills. Act as a reviewer to critically review research plans, manuscripts, or task summaries, pointing out missing baselines, statistical flaws, and weak assumptions.

When should I use General Peer Review?

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

How do I install General Peer Review in Claude Code?

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

How do I install General Peer Review in Codex?

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

Can I use General 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 learningmatter-mit/AtomisticSkills --skill general-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/general-peer-review, .gemini/skills/general-peer-review, .github/skills/general-peer-review and .opencode/skills/general-peer-review in your project.

What does General Peer Review need to run?

SKILL.md names no scripts, command-line tools or credentials: General Peer Review is instructions for the agent only. Our summary lists: Python 3.

Does General Peer Review access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is General 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 General Peer Review use?

General 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 General Peer Review use?

About 1.3k tokens (SKILL.md is roughly 5.2k 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 General Peer Review?

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

Who maintains General Peer Review?

learningmatter-mit (a GitHub organization) maintains it in learningmatter-mit/AtomisticSkills, which has 176 GitHub stars. The repository holds 129 skills in this directory. The repository was last updated on October 7, 2026.

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