Skip to content
Skillpedia
Writing51k · #1932

peer-review

Has your agent prepare constructive scientific review drafts and manuscript assessments. It helps review articles, protocols, or research proposals in a detailed and organized way.

What it does

Helps review scientific papers, research proposals, or other documents. It checks if the information presented is sufficient and follows the rules, but it does not decide if the work is good or bad.

When to use it

  • ✓When reviewing a scientific paper for a journal.
  • ✓When evaluating a research proposal.
  • ✓When checking if a document follows writing guidelines.

Example of what to ask your AI

“Review this scientific paper on the use of AI in medicine, focusing on the clarity of methods and the presentation of results.”

Want more? Open the sections below.

How to use

The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.

Skill link

https://github.com/K-Dense-AI/scientific-agent-skills/blob/main/skills/peer-review/SKILL.md

Ready-to-paste message

Use this skill to help me: https://github.com/K-Dense-AI/scientific-agent-skills/blob/main/skills/peer-review/SKILL.md Read the SKILL.md file at that link and follow its instructions for my task.
How it works

The AI analyzes the provided document and checks if the information is complete and organized according to the rules. It points out what is missing or what can be improved, but the final decision always rests with the human reviewer.

Installation

Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.

In the terminal (Claude Code, Codex, Cursor), in your project folder:

npx skills add K-Dense-AI/scientific-agent-skills --skill peer-review

Or download just the file:

curl -L https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/main/skills/peer-review/SKILL.md -o SKILL.md
Technical content (original SKILL.md)

Original text by the author, straight from GitHub.

Peer Review

Support an accountable human reviewer with a rigorous, fair, actionable assessment. Treat every unpublished submission and review as confidential.

Mandatory safety boundary

Before reading or analyzing unpublished content:

  1. Confirm the user is authorized by the publisher, editor, author, or other material owner.
  2. Check the target venue’s review, confidentiality, co-review, retention, and AI/tool policies.
  3. Record conflicts, competence limits, requested scope, and specialist-review needs.
  4. Default to local-only processing.

If authorization is unclear, do not inspect or quote the manuscript. Clarify only the unresolved authorization; existing documented authorization need not be requested again. Until resolved, use only the intake validator or synthetic/public fixtures. Local processing of the manuscript also requires authorization.

Running a bundled CLI locally does not make the surrounding assistant session local. Treat any manuscript content read into a hosted assistant as external processing when evaluating venue policy and authorization.

Never:

  • Send unpublished manuscript, supplement, review, or editorial text to an external service without specific publisher/author authorization and venue permission
  • Upload confidential content to a public model, search engine, citation service, grammar tool, plagiarism checker, or image service
  • Reuse content for training, benchmarking, product improvement, or unrelated research
  • Read broad environment state, .env files, API keys, or credentials
  • Call a network, LLM, or image API from bundled tools
  • Invoke another skill or a PDF/image pipeline automatically
  • Impersonate an assigned reviewer, editor, journal, funder, or author
  • Fabricate manuscript details, review findings, citations, analyses, experiments, reproduction, or an editorial outcome
  • Announce a decision that belongs to an editor or panel

Delete local copies and derivatives when policy requires; otherwise retain only what the controlling policy authorizes. Record deletion or retention without copying confidential content into the record.

Read references/ethical_review_practice.md before handling confidential material.

Human accountability

Label generated text as a working draft. The accountable human must:

  • Read the complete authorized submission and relevant supplements
  • Verify every factual statement, calculation, citation, and manuscript location
  • Resolve conflicts and disclose assistance as required
  • Rewrite comments in their own expert judgment
  • Submit through the authorized channel

Automated coverage, consistency, or lint results are not peer review and do not establish manuscript merit.

Intake gate

Copy and complete assets/review_intake_template.json, then run:

python3 scripts/validate_review_intake.py completed-intake.json

Proceed only when status is READY_FOR_LOCAL_REVIEW.

The validator blocks:

  • Undocumented authorization
  • Missing human accountability
  • Unassessed or unresolved conflicts
  • Unknown review model or unchecked venue policy
  • Unauthorized AI assistance
  • External service use
  • Data reuse
  • Missing deletion/retention planning

It validates declarations, not their truth.

A conflict marked disclosed_to_editor remains blocked. Use editor_cleared only after actual editor clearance, or none_identified when no conflict exists. Do not clear a conflict merely to pass the validator.

Review workflow

1. Establish scope and available evidence

Record:

  • Submission type and stage
  • Review question and requested focus
  • Target venue and review model
  • Materials actually available: manuscript, supplements, protocol, registration, analysis plan, data/code statement, prior decision, or response letter
  • Competence areas and limits
  • Missing material that prevents assessment

Do not infer absent content. Use “not reported” or “not available for review.”

2. Orient without deciding

Create a short neutral map:

  • Research question
  • Population or system
  • Design and unit
  • Intervention, exposure, test, or model
  • Comparator/reference
  • Outcomes and timing
  • Principal claims

Do not write an acceptance/rejection recommendation. Identify what evidence would be needed to evaluate each claim.

3. Select reporting guidance

Copy assets/study_profile_template.json and run:

python3 scripts/select_reporting_guidelines.py local-profile.json

For checklist coverage:


…
FAQ

Will the AI write the review for me?

No, the AI generates a draft and points out areas for the human reviewer to check. The human reviewer is ultimately responsible for the review.

Can the AI decide if a paper is accepted or rejected?

No, the AI does not make publication decisions. It only helps organize and check information for the human reviewer.

Can I use the AI to review any document?

No, the AI should only be used to review documents for which you have authorization, such as scientific papers or research proposals, and always respecting confidentiality policies.

Details

Original description by the author

Prepares evidence-bounded, constructive peer-review drafts and structured manuscript assessments. Supports authorized review of scientific manuscripts, protocols, preprints, or research proposals; reporting-guideline selection; claim–evidence checks; methods, statistics, reproducibility, ethics, figure/table, and citation critique; or revision-response planning.

repo: K-Dense-AI/scientific-agent-skills

Popularity

GitHub stars
51k
Ranking position
#1932
License
MIT
Updated
10/15/2026

Is this skill useful?

0

Sign in to vote.

Comments

  • …

More skills from this repository

Similar skills