Agent skill

Academic Paper Self-Review

by lingzhi227 in lingzhi227/agent-research-skills

Reviews an academic paper in the NeurIPS review format with three reviewer personas, reflection rounds and averaged scores, and outputs an actionable report.

No licenceAuto-check passedResearch & Science

Install Academic Paper Self-Review

skills CLI
$ npx skills add lingzhi227/agent-research-skills --skill self-review -a claude-code

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

GitHub CLI
$ gh skill install lingzhi227/agent-research-skills self-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/lingzhi227/agent-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/self-review .claude/skills/self-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
self-review
GitHub stars
390
Token cost
~877 tokens
SKILL.md length
258 words
Files
4 (incl. scripts, references)
Skills in repo
31
Repo updated
First seen
Licence
None found

At a glance

Reviews an academic paper in the NeurIPS review format with three reviewer personas, reflection rounds and averaged scores, and outputs an actionable report.

  • Works in 5 steps: Load Paper → Three-Persona Review → Reflection Refinement (up to 3 rounds… → …
  • Getting a mock peer review of a paper before submission
  • SKILL.md covers Input, Scripts, Workflow and References, plus 2 more sections
  • Runs Python scripts from its folder; calls python and pip

What it does

The agent loads a paper from a PDF or a .tex file. PDF text comes from a script that tries pymupdf4llm, then pymupdf, then pypdf, and an optional parser recovers the title, section headings and section text. It then runs three independent reviews, from a harsh but fair reviewer, a harsh and critical reviewer and an open-minded one, each following the NeurIPS review JSON format in references/review-form.md.

Each review gets up to three reflection rounds that re-check accuracy and soundness. The results are combined by averaging scores with weights such as Overall 1.0, Contribution 0.4 and Presentation 0.2, plus a meta-review of the consensus, and the report gives an overall score out of 10 and an accept or reject decision. The agent must also verify that the abstract, introduction, methods, experiments and discussion are present, and lower the scores for any that are missing.

When your agent uses it

  • Getting a mock peer review of a paper before submission
  • Stress-testing a draft with critical and open-minded reviewer views
  • Checking that a manuscript has all required sections
  • Turning review feedback into a prioritized to-do list

Example prompts

  • “Review paper.pdf with the NeurIPS form before I submit it.”
  • “Run the three-reviewer pass on my LaTeX draft in ./paper/main.tex and give me an actionable report.”
  • “Extract the sections from this PDF and tell me which required section is missing.”
  • “Summarize the main weaknesses all three reviewer personas agreed on.”

Requirements

  • Python with `pymupdf4llm`, `pymupdf` and `pypdf` for PDF extraction

Workflow steps

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

  1. Load Paper
  2. Three-Persona Review
  3. Reflection Refinement (up to 3 rounds per reviewer)
  4. Aggregate
  5. Actionable Report

What it can do on your machine

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

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

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

  • Network

    No URLs in SKILL.md. Its commands use pip, 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

Academic Paper Self-Review loads about 877 tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 81 tokens; SKILL.md has 258 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~81
When it runs · the whole SKILL.md, loaded when a task matches
~877
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.8k

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 258 words (~877 tokens).

“Review an academic paper using a structured review form with multiple reviewer personas.”

— opening of SKILL.md by lingzhi227
name
self-review
argument-hint
pdf-or-tex-file

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (scripts, references) in skills/self-review of lingzhi227/agent-research-skills.

  • SKILL.md
  • references/review-form.md
  • scripts/extract_pdf_text.py
  • scripts/parse_pdf_sections.py

Open the folder on GitHubat commit 9e6c085

Compare with similar skills

Academic Paper Self-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.

Academic Paper Self-Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Academic Paper Self-Review this skilllingzhi227/agent-research-skills390—~877Automated safety check: PassNone
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Academic Paper ReviewerImbad0202/academic-research-skills51k—~11kAutomated safety check: PassCustom licence
Academic Research PipelineImbad0202/academic-research-skills51k—~15kAutomated safety check: PassCustom licence
Benchmark Paper TemplateHKUSTDial/Supervisor-Skills8.8k—~2.8kAutomated safety check: PassCC-BY-4.0
Academic Research Suite for CodexImbad0202/academic-research-skills-codex12k—~12kAutomated safety check: PassCustom licence

Similar skills

  • 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
  • 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
  • Benchmark Paper Template

    HKUSTDial/Supervisor-Skills

    Structures benchmark and evaluation papers around five pillars, with a completeness audit, an Introduction logic chain, a section skeleton and a pre-submission checklist.

    8.8k GitHub stars~2.8k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed
  • Academic Research Suite for Codex

    Imbad0202/academic-research-skills-codex

    A router skill that sends academic work such as literature reviews, drafting, citation checks, peer review and revision to the right workflow in the ARS suite.

    12k GitHub stars~12k tokensUpdated 7 days ago
    Research & ScienceAuto-check passed
  • Manuscript Statistics Audit

    Yuan1z0825/nature-skills

    Audits or rewrites the statistical reporting in a manuscript: experimental units, replication, tests, uncertainty and figure legends, without inventing missing details.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed

More from lingzhi227/agent-research-skills

All 31 skills in this repo
  • Backward Traceability

    lingzhi227/agent-research-skills

    Makes each number in a LaTeX paper link back to the code line that produced it, using hypertarget and hyperlink tags and compile-time `\num` formulas.

    390 GitHub stars~802 tokensUpdated 7 mo ago
    Auto-check passed
  • Statistical Data Analysis

    lingzhi227/agent-research-skills

    Writes statistical analysis code for experimental data, runs it through a four-round review, and reports effect sizes, p-values and confidence intervals.

    390 GitHub stars~886 tokensUpdated 7 mo ago
    Auto-check passed
  • Excalidraw Canvas Toolkit

    lingzhi227/agent-research-skills

    Draws and refines Excalidraw diagrams on a live canvas through MCP tools or a REST API, with screenshots, file import and export, snapshots and Mermaid conversion.

    390 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Research Experiment Designer

    lingzhi227/agent-research-skills

    Plans research experiments in four progressive stages, from a first working implementation through baseline tuning and creative research to ablation studies.

    390 GitHub stars~752 tokensUpdated 7 mo ago
    Auto-check passed
  • Scientific Figure Generation

    lingzhi227/agent-research-skills

    Generates publication-quality scientific figures with matplotlib or seaborn through query expansion, a run-and-retry coding loop and a visual check of the rendered PNG.

    390 GitHub stars~809 tokensUpdated 7 mo ago
    Auto-check passed
  • Research Idea Generation

    lingzhi227/agent-research-skills

    Generates and iteratively refines research ideas for a given area, checking each one's novelty against Semantic Scholar and arXiv, and scoring it on interestingness, feasibility and novelty.

    390 GitHub stars~747 tokensUpdated 7 mo ago
    Auto-check passed

Works with

Questions about Academic Paper Self-Review

What does Academic Paper Self-Review do?

Reviews an academic paper in the NeurIPS review format with three reviewer personas, reflection rounds and averaged scores, and outputs an actionable report. tex file. PDF text comes from a script that tries pymupdf4llm, then pymupdf, then pypdf, and an optional parser recovers the title, section headings and section text.

When should I use Academic Paper Self-Review?

Academic Paper Self-Review fits situations like: getting a mock peer review of a paper before submission; stress-testing a draft with critical and open-minded reviewer views; checking that a manuscript has all required sections; turning review feedback into a prioritized to-do list.

How do I install Academic Paper Self-Review in Claude Code?

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

How do I install Academic Paper Self-Review in Codex?

Run `npx skills add lingzhi227/agent-research-skills --skill self-review -a codex`. Or copy the skill folder (skills/self-review in lingzhi227/agent-research-skills) into .agents/skills/self-review in your project. Codex loads it when a task matches its description.

Can I use Academic Paper Self-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 lingzhi227/agent-research-skills --skill self-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/self-review, .gemini/skills/self-review, .github/skills/self-review and .opencode/skills/self-review in your project.

What does Academic Paper Self-Review need to run?

Going by SKILL.md and its folder, Academic Paper Self-Review needs Python for the scripts in its folder and the command-line tools its instructions call (python and pip). Our summary lists: Python with `pymupdf4llm`, `pymupdf` and `pypdf` for PDF extraction.

Does Academic Paper Self-Review access the network?

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

Is Academic Paper Self-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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Academic Paper Self-Review use?

No licence was found for Academic Paper Self-Review or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Academic Paper Self-Review use?

About 877 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 969 tokens, read only when the agent opens those files.

What are the alternatives to Academic Paper Self-Review?

Skills that share tags, products or a category with Academic Paper Self-Review: Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars), Academic Paper Reviewer (Imbad0202/academic-research-skills, 51k stars), Academic Research Pipeline (Imbad0202/academic-research-skills, 51k stars) and Benchmark Paper Template (HKUSTDial/Supervisor-Skills, 8.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Academic Paper Self-Review?

lingzhi227 (a GitHub user) maintains it in lingzhi227/agent-research-skills, which has 390 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on February 27, 2026.

Source: lingzhi227/agent-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.