Academic Reviser

joshua-zyy/academic-reviser

Self-review, audit, or verify CS/AI/ML paper drafts as a critical peer reviewer. Three-round review (evidence→argument→style) with Verification Status and debt tracking. Use when: reviewing a paper draft before submission, checking evidence compliance of claims, simulating peer reviewer feedback, verifying citation closure and evidence debts, performing cross-section consistency checks. Triggers on: self review, 自查, verification, 审稿, evidence compliance, peer review, 论文审查, draft audit, 验证论文, 检查引用, cross-section review, 审修, draft verification.

10k tokens

context cost

the whole folder, loaded on every use

files

ships runnable scripts

copies elsewhere

how many repositories repackaged it

104

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/joshua-zyy/academic-paper-writer --skill academic-reviser

What comes with it

36 308 bytes besides the instruction

agents/reviser_agent.md

manifest.yaml

references/common-pitfalls.md

references/examples/reviser-output-examples.md

references/reviewer-package.md

references/revision-checklist.md

references/templates/section-critique.md

references/verification-checklists.md

references/verification-status.md

scripts/placeholder_audit.py

static/core/anti-patterns.md

static/core/output-contract.md

static/core/red-lines.md

static/core/stance.md

What it tells the agent to use

found in the instruction text

Task spawns other agents

The instruction itself

5 sections, as written by the author

Academic Reviser

将此 skill 视为"挑剔审稿人代理"——像 peer reviewer 一样审查草稿，按证据→论证→风格三轮顺序执行。

Router Protocol

Read manifest.yaml. It declares always_load files, axes, and references.on_demand.
Read every file listed under always_load. These are the skill's binding rules — not reference material.
Apply the loaded material as constraints:
stance.md defines non-negotiable rules, bounded assessment, termination conditions, and scope.
red-lines.md defines absolute prohibitions. Do not negotiate these.
output-contract.md defines deliverables, debt types, and Verification Status format.
anti-patterns.md defines known failure modes, correct alternatives, and self-deception signals.
Detect the mode using the manifest's mode axis. When input materials are incomplete, declare a Bounded Assessment before proceeding.
Echo the selected mode to the user before executing.
Reach for references/ only when the manifest's references.on_demand condition is satisfied.

Debt types tracked: prose_debt, section_contract_debt, citation_debt, evidence_debt, figure_debt, protocol_debt, result_debt, rationale_debt. Schema: skills/shared/schemas/verification-report.md.

Modes

| Mode | Use when |

|---|---|

| full-section-review | Complete 3-round review + Verification for a single section |

| cross-section-review | Cross-section consistency check |

| verification-only | Verdict only, no re-review |

| targeted-review | Specific issue (e.g. citation closure only) |

| targeted-evidence-mode | Evidence compliance only (orchestrator Step 9.5) |

| mock-reviewer-package | Optional pre-submission 3-reviewer package |

Agent Dispatch

agents/reviser_agent.md dispatched by orchestrator at Step 9.5 or Step 9.8. Subagent returns structured review content; must not modify project files or invent reviewer identities, experiments, citations, or unprovided evidence.

Independent Use

|---|---|---|---|

| Scenario | Recommended |

|---|---|

| Just reviewing a draft | This skill (standalone) |

| During paper drafting | academic-paper-writer orchestrator |

| After polishing pass | academic-polishing → this skill |

How to use it

Copy the folder

Take joshua-zyy/academic-reviser from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.