Academic Reviser

SkillDev tools

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.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Academic Reviser skill

What this skill tells your AI

The instructions your AI receives, as published by joshua-zyy/academic-paper-writer in skills/academic-reviser/SKILL.md and read by ahel’s review.

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

Router Protocol

  1. Read manifest.yaml. It declares always_load files, axes, and references.on_demand.
  2. Read every file listed under always_load. These are the skill's binding rules — not reference material.
  3. 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.
  4. Detect the mode using the manifest's mode axis. When input materials are incomplete, declare a Bounded Assessment before proceeding.
  5. Echo the selected mode to the user before executing.
  6. 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

ModeUse when
full-section-reviewComplete 3-round review + Verification for a single section
cross-section-reviewCross-section consistency check
verification-onlyVerdict only, no re-review
targeted-reviewSpecific issue (e.g. citation closure only)
targeted-evidence-modeEvidence compliance only (orchestrator Step 9.5)
mock-reviewer-packageOptional 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

InputModePriorityBehavior
Section draftfull-section-review2 (path trigger)Full 3-round review
Multiple sectionscross-section-review2 (path trigger)Consistency only
"只用 verdict"verification-only1 (explicit)Verdict only
Specific issuetargeted-review1 (explicit)Targeted check
Evidence focustargeted-evidence-mode1 (explicit)Evidence compliance
"审稿包" / pre-submissionmock-reviewer-package1 (explicit)Optional reviewer package
ScenarioRecommended
Just reviewing a draftThis skill (standalone)
During paper draftingacademic-paper-writer orchestrator
After polishing passacademic-polishing → this skill

Signals

GitHub stars
110
Forks
1
Last commit
Jun 2026
Advanced
Catalog kind
skill
Gateway key
academic-reviser
Source
github.com/joshua-zyy/academic-paper-writer