SkillAgentSearch skills...

review-paper

Comprehensive manuscript review covering argument structure, econometric specification, citation completeness, and potential referee objections. Make sure to use this skill whenever the user wants substantive academic feedback on a paper β€” not just surface edits.

Install / Use

npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill review-paper

Installs into whichever agent you are using.

About this skill
πŸ“„

SKILL.md

Installable skill definition

Quality Score

92/100

Supported Platforms

Universal

Our assessment of review-paper

review-paper scores 92/100 on our quality scale, 101st of 421 Education & Research skills we index (top 24%).

Its SKILL.md is 6.2 KB long, well organised into 24 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.

With 4,360 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
18/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so review-paper is actively maintained.
  • Our last check on 2026-10-05 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit β€” read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk β€” read a skill before letting an agent act on it.

review-paper compared with similar skills

All 4 of these similar skills score higher than review-paper; compare them before choosing.

SkillScoreStarsUpdatedFormat
review-paper (this skill)by brycewang-stanford924.4k54d agoSKILL.md
last30days-skillby mvanhorn10068.0ktodayCLAUDE.md
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md

Frequently asked questions

How do I install review-paper?
Run npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill review-paper. The install tabs above show the steps for each supported agent.
Which AI agents does review-paper work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is review-paper safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is review-paper still maintained?
The repository was last updated about 2 months ago, so review-paper is actively maintained.

name: review-paper description: >- Comprehensive manuscript review covering argument structure, econometric specification, citation completeness, and potential referee objections. Make sure to use this skill whenever the user wants substantive academic feedback on a paper β€” not just surface edits. Triggers include: "review my paper", "give me feedback on this draft", "what would a referee say", "anticipate referee objections", "act as a referee", "check my identification strategy", "is my argument convincing", "review this manuscript", "critique my paper", "will this pass review", or any request for deep critique of academic writing beyond typos and grammar. argument-hint: "[paper filename in manuscripts/ or path to .tex/.pdf]" allowed-tools: ["Read", "Grep", "Glob", "Write", "Task"]

Manuscript Review

Produce a thorough, constructive review of an academic manuscript β€” the kind of report a top-journal referee would write.

Input: $ARGUMENTS β€” path to a paper (.tex, .pdf, or .qmd), or a filename in manuscripts/ or references/papers/.


Steps

  1. Locate and read the manuscript. Check:

    • Direct path from $ARGUMENTS
    • manuscripts/$ARGUMENTS
    • references/papers/$ARGUMENTS
    • Glob for partial matches in manuscripts/ and references/papers/
  2. Read the full paper end-to-end. For long PDFs, read in chunks (5 pages at a time).

  3. Dispatch domain-reviewer agent via Task for deep substance review (see below).

  4. Evaluate writing quality and presentation (dimensions 5-6) β€” the skill handles these directly since the agent explicitly does not cover presentation.

  5. After the agent completes, merge its findings with your writing/presentation evaluation. Generate 3-5 "referee objections" synthesized from both.

  6. Produce the unified review report.

  7. Save to quality_reports/paper_review_[sanitized_name].md


Step 3: Dispatch Domain-Reviewer Agent

Dispatch the domain-reviewer agent via Task for the deep substance check. The agent applies 5 lenses that go deeper than broad dimensional evaluation β€” actual equation verification, derivation step checking, code-theory alignment, and backward logic tracing.

Task prompt: "You are the domain-reviewer agent. Review the manuscript at [path].
Research question: [from spec if available].

Apply all 5 review lenses:
1. Assumption stress test
2. Derivation verification
3. Citation fidelity
4. Code-theory alignment
5. Backward logic check

Also check cross-document consistency.
Follow the domain-reviewer agent instructions and return your full substance review report."

After the agent completes, collect its findings. These feed into the "Major Concerns" and "Referee Objections" sections of the final report.


Steps 4-5: Skill Evaluates Writing & Presentation, Then Merges

The skill evaluates dimensions 5-6 directly (the agent does not cover these), then merges everything into the unified report format below.


Review Dimensions

1. Argument Structure

  • Is the research question clearly stated?
  • Does the introduction motivate the question effectively?
  • Is the logical flow sound (question β†’ method β†’ results β†’ conclusion)?
  • Are the conclusions supported by the evidence?
  • Are limitations acknowledged?

2. Identification Strategy

  • Is the causal claim credible?
  • What are the key identifying assumptions? Are they stated explicitly?
  • Are there threats to identification (omitted variables, reverse causality, measurement error)?
  • Are robustness checks adequate?
  • Is the estimator appropriate for the research design?

3. Econometric Specification

  • Correct standard errors (clustered? robust? bootstrap?)?
  • Appropriate functional form?
  • Sample selection issues?
  • Multiple testing concerns?
  • Are point estimates economically meaningful (not just statistically significant)?

4. Literature Positioning

  • Are the key papers cited?
  • Is prior work characterized accurately?
  • Is the contribution clearly differentiated from existing work?
  • Any missing citations that a referee would flag?

5. Writing Quality

  • Clarity and concision
  • Academic tone
  • Consistent notation throughout
  • Abstract effectively summarizes the paper
  • Tables and figures are self-contained (clear labels, notes, sources)

6. Presentation

  • Are tables and figures well-designed?
  • Is notation consistent throughout?
  • Are there any typos, grammatical errors, or formatting issues?
  • Is the paper the right length for the contribution?

Output Format

# Manuscript Review: [Paper Title]

**Date:** [YYYY-MM-DD]
**Reviewer:** review-paper skill
**File:** [path to manuscript]

## Summary Assessment

**Overall recommendation:** [Strong Accept / Accept / Revise & Resubmit / Reject]

[2-3 paragraph summary: main contribution, strengths, and key concerns]

## Strengths

1. [Strength 1]
2. [Strength 2]
3. [Strength 3]

## Major Concerns

### MC1: [Title]
- **Dimension:** [Identification / Econometrics / Argument / Literature / Writing / Presentation]
- **Issue:** [Specific description]
- **Suggestion:** [How to address it]
- **Location:** [Section/page/table if applicable]

[Repeat for each major concern]

## Minor Concerns

### mc1: [Title]
- **Issue:** [Description]
- **Suggestion:** [Fix]

[Repeat]

## Referee Objections

These are the tough questions a top referee would likely raise:

### RO1: [Question]
**Why it matters:** [Why this could be fatal]
**How to address it:** [Suggested response or additional analysis]

[Repeat for 3-5 objections]

## Specific Comments

[Line-by-line or section-by-section comments, if any]

## Summary Statistics

| Dimension | Rating (1-5) |
|-----------|-------------|
| Argument Structure | [N] |
| Identification | [N] |
| Econometrics | [N] |
| Literature | [N] |
| Writing | [N] |
| Presentation | [N] |
| **Overall** | **[N]** |

Principles

  • Be constructive. Every criticism should come with a suggestion.
  • Be specific. Reference exact sections, equations, tables.
  • Think like a referee at a top-5 journal. What would make them reject?
  • Distinguish fatal flaws from minor issues. Not everything is equally important.
  • Acknowledge what's done well. Good research deserves recognition.
  • Do NOT fabricate details. If you can't read a section clearly, say so.

Related Skills

View on GitHub
GitHub Stars4.4k
CategoryEducation
Updated1mo ago
Forks527

Languages

Stata

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit β€” see the Safety scan above for what the skill file itself contains.

1 medium
review-paper β€” Universal Skill: Install & Safety Check | SkillAgent