paper-review

Name: paper-review
Author: neuromechanist

37stars7forks

How to install paper-review?

neuromechanist/research-skills/paper-review

$npx -y skills add neuromechanist/research-skills --skill paper-review

Installs into the current project.

Summary

Use this skill for \"review this paper\", \"review this manuscript\", \"peer review\", \"review my paper\", \"critique this manuscript\", \"review this submission\", \"give me feedback on my paper\", \"check my methods\", \"review my statistics\", \"review as a peer reviewer\", \

Files · 1

View on GitHub

SKILL.md

1	# Academic Manuscript Review
2
3	Routes a manuscript to an independent, fresh-context reviewer that evaluates it for methodological soundness, statistical validity, logical consistency, and reproducibility, and returns a structured peer review. This skill is a thin dispatcher: it decides how to run the reviewer and in which mode. The review procedure, checklists, statistical and figure guides, principles, and output template all live in `references/` and are loaded by the reviewer, not duplicated here.
4
5	## When to use
6
7	Activate when the user wants peer-review feedback on a manuscript (journal article, conference paper, preprint).
8
9	## Why a fresh-context reviewer
10
11	Review validity depends on independence: a reviewer that shares the conversation that produced the manuscript is biased toward it. Run the reviewer in a separate context and pass only framing (manuscript path, target journal, manuscript type, revision status), never the authoring rationale. This is why the reviewer is a subagent on tools that support one, and an inline procedure where they do not.
12
13	## Modes (user decides each run)
14
15	- Single (default): one independent reviewer applies the full procedure end to end.
16	- Panel (opt-in): spawn independent reviewers in parallel on complementary lenses, then a synthesis pass. Trigger on "review panel", "multiple reviewers", or an explicit request. Lenses: methods/design, statistics, and novelty/significance (add reproducibility for methods-heavy or hardware papers). Each reviewer reads the whole manuscript but weights its lens and scores independently from `references/`; a final synthesis pass merges them into one Critical/Major/Minor review and surfaces genuine disagreement rather than averaging it away.
17
18	## Dispatch
19
20	Pick the branch for the current tool. In every branch the reviewer follows `references/review-procedure.md`.
21
22	- Claude Code: `Task(subagent_type: "paper-review", ...)` passing the manuscript path, target journal/type, and mode. For panel mode, launch one `Task` per lens in parallel, then a final synthesis `Task`.
23	- Codex CLI: plugin installation exposes this skill, not a Codex subagent. To use a fresh-context Codex reviewer, first copy `agents/templates/paper-review.toml` to `~/.codex/agents/` or `.codex/agents/`, then invoke that configured agent if the current Codex surface supports `/agent`. For panel mode, ensure `max_threads` covers the lens count. If no Codex subagent is configured or available, use the fallback branch.
24	- Copilot CLI: plugin installation exposes this skill and, through `.github/plugin/plugin.json`, the `.agent.md` reviewer in `agents/templates/`. Invoke that configured agent when the current Copilot surface supports custom agents; use `/fleet` for panel mode when available. If running outside a plugin install, copy `agents/templates/paper-review.agent.md` to `.github/agents/` or `~/.copilot/agents/`. If no custom agent is available, use the fallback branch.
25	- Fallback (no subagent support, or the user wants an interactive in-thread review): first locate the rubric (`$CLAUDE_PLUGIN_ROOT/skills/paper-review/references`, else `find . -type d -path '*/skills/paper-review/references' \| head -1`); if it cannot be found, stop and tell the user to install the manuscript plugin rather than reviewing from memory. Then follow `references/review-procedure.md` directly in this context.
26
27	## The brain (do not duplicate into dispatch or agent shells)
28
29	- `references/review-procedure.md` -- step-by-step procedure: intake, read, methodology, logic, literature, reproducibility, figures, writing, output.
30	- `references/methodology-checklist.md`, `references/statistical-review-guide.md`, `references/figure-review-guide.md` -- the assessment checklists and guides.
31	- `references/review-principles.md` -- review philosophy and severity calibration.
32	- `references/review-output-template.md` -- the Synopsis / Critical / Major / Minor / References / Editor Note format.
33	- `examples/sample-manuscript-review.md` -- worked review for calibration; `examples/sample-manuscript-excerpt.md` -- sample manuscript input for testing.
34	- Sister skill `manuscript:humanizer` -- AI-writing patterns to flag in the prose-quality pass.

People who liked this also viewed

6 picks

Type

paper-review

37stars7forks

View on GitHub

How to install paper-review?

neuromechanist/research-skills/paper-review

$npx -y skills add neuromechanist/research-skills --skill paper-review

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Academic Manuscript Review
2
3	Routes a manuscript to an independent, fresh-context reviewer that evaluates it for methodological soundness, statistical validity, logical consistency, and reproducibility, and returns a structured peer review. This skill is a thin dispatcher: it decides how to run the reviewer and in which mode. The review procedure, checklists, statistical and figure guides, principles, and output template all live in `references/` and are loaded by the reviewer, not duplicated here.
4
5	## When to use
6
7	Activate when the user wants peer-review feedback on a manuscript (journal article, conference paper, preprint).
8
9	## Why a fresh-context reviewer
10
11	Review validity depends on independence: a reviewer that shares the conversation that produced the manuscript is biased toward it. Run the reviewer in a separate context and pass only framing (manuscript path, target journal, manuscript type, revision status), never the authoring rationale. This is why the reviewer is a subagent on tools that support one, and an inline procedure where they do not.
12
13	## Modes (user decides each run)
14
15	- Single (default): one independent reviewer applies the full procedure end to end.
16	- Panel (opt-in): spawn independent reviewers in parallel on complementary lenses, then a synthesis pass. Trigger on "review panel", "multiple reviewers", or an explicit request. Lenses: methods/design, statistics, and novelty/significance (add reproducibility for methods-heavy or hardware papers). Each reviewer reads the whole manuscript but weights its lens and scores independently from `references/`; a final synthesis pass merges them into one Critical/Major/Minor review and surfaces genuine disagreement rather than averaging it away.
17
18	## Dispatch
19
20	Pick the branch for the current tool. In every branch the reviewer follows `references/review-procedure.md`.
21
22	- Claude Code: `Task(subagent_type: "paper-review", ...)` passing the manuscript path, target journal/type, and mode. For panel mode, launch one `Task` per lens in parallel, then a final synthesis `Task`.
23	- Codex CLI: plugin installation exposes this skill, not a Codex subagent. To use a fresh-context Codex reviewer, first copy `agents/templates/paper-review.toml` to `~/.codex/agents/` or `.codex/agents/`, then invoke that configured agent if the current Codex surface supports `/agent`. For panel mode, ensure `max_threads` covers the lens count. If no Codex subagent is configured or available, use the fallback branch.
24	- Copilot CLI: plugin installation exposes this skill and, through `.github/plugin/plugin.json`, the `.agent.md` reviewer in `agents/templates/`. Invoke that configured agent when the current Copilot surface supports custom agents; use `/fleet` for panel mode when available. If running outside a plugin install, copy `agents/templates/paper-review.agent.md` to `.github/agents/` or `~/.copilot/agents/`. If no custom agent is available, use the fallback branch.
25	- Fallback (no subagent support, or the user wants an interactive in-thread review): first locate the rubric (`$CLAUDE_PLUGIN_ROOT/skills/paper-review/references`, else `find . -type d -path '*/skills/paper-review/references' \| head -1`); if it cannot be found, stop and tell the user to install the manuscript plugin rather than reviewing from memory. Then follow `references/review-procedure.md` directly in this context.
26
27	## The brain (do not duplicate into dispatch or agent shells)
28
29	- `references/review-procedure.md` -- step-by-step procedure: intake, read, methodology, logic, literature, reproducibility, figures, writing, output.
30	- `references/methodology-checklist.md`, `references/statistical-review-guide.md`, `references/figure-review-guide.md` -- the assessment checklists and guides.
31	- `references/review-principles.md` -- review philosophy and severity calibration.
32	- `references/review-output-template.md` -- the Synopsis / Critical / Major / Minor / References / Editor Note format.
33	- `examples/sample-manuscript-review.md` -- worked review for calibration; `examples/sample-manuscript-excerpt.md` -- sample manuscript input for testing.
34	- Sister skill `manuscript:humanizer` -- AI-writing patterns to flag in the prose-quality pass.

People who liked this also viewed

6 picks

Type