academic-reviser

$npx mdskill add joshua-zyy/academic-paper-writer/academic-reviser

Self-review CS/AI/ML paper drafts as a critical reviewer

  • Identifies incomplete input materials and declares bounded assessment before proceeding.
  • Deploys evidence compliance checks, argument validation, and style analysis tools for review.
  • Decides on verification status based on evidence compliance, argument strength, and stylistic quality.
  • Delivers results in the form of a Verification Status report with debt tracking to the user.

SKILL.md

.github/skills/academic-reviserView on GitHub ↗
---
name: academic-reviser
description: "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."
---

# Academic Reviser

将此 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

| 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

| Input | Mode | Priority | Behavior |
|---|---|---|---|
| Section draft | full-section-review | 2 (path trigger) | Full 3-round review |
| Multiple sections | cross-section-review | 2 (path trigger) | Consistency only |
| "只用 verdict" | verification-only | 1 (explicit) | Verdict only |
| Specific issue | targeted-review | 1 (explicit) | Targeted check |
| Evidence focus | targeted-evidence-mode | 1 (explicit) | Evidence compliance |
| "审稿包" / pre-submission | mock-reviewer-package | 1 (explicit) | Optional reviewer package |

| Scenario | Recommended |
|---|---|
| Just reviewing a draft | This skill (standalone) |
| During paper drafting | academic-paper-writer orchestrator |
| After polishing pass | academic-polishing → this skill |

More from joshua-zyy/academic-paper-writer

SkillDescription
academic-citationSearch, verify, and map citations for CS/AI/ML papers. Produces VERIFIED/UNVERIFIED reference lists with Citation-to-Claim maps and Exemplar Sets. Use when: finding references for a paper section, verifying citation accuracy, building exemplar sets for introduction/related work learning, checking if existing citations are real and accurate, supplementing local literature library. Triggers on: 找引用, 文献检索, citation pass, find references, reference check, 补文献, citation verification, Exemplar Set, search papers, verify citation, 核验文献, 查引用, literature search, reference verification, citation verification with reading, 引用确认, 全文阅读验证.
academic-experimentsAudit, run, or verify experimental evidence for CS/AI/ML papers. Produces Evidence Inventory with evidence_type annotations (newly_run/preexisting_artifact/user_claim) and Protocol Risk assessments. Use when: checking if experiment results are reproducible, auditing existing experiment artifacts, running minimal reproducible commands, evaluating checkpoints without full retraining, documenting protocol risks like data leakage or missing baselines. Triggers on: 复核实验, run experiments, 实验结果, experiment evidence, verify results, 实验验证, evidence inventory, protocol risk, 跑实验, check results, reproduce experiments, 实验审计.
academic-figureCreate, revise, or audit academic data/result figures for CS/AI/ML papers. Data/result plots default to Python-generated editable SVG with CS/AI/ML-specific design rules for benchmarks, ablations, training dynamics, robustness, diagnostics, distributions, confusion matrices, and efficiency tradeoffs. Use when: generating plots from experiment results or numeric data, auditing publication figures, suggesting data-driven figure types, revising chart colors/layouts/labels, or preparing figure QA reports. Model framework diagrams, architecture diagrams, overview diagrams, and complex mechanism schematics are outside this skill's automatic drawing scope; provide only manual figure requirements or caption/blueprint notes when needed. Triggers on: 绘图, figure, chart, 画图, 实验图, 训练曲线, 消融实验, 对比图, 混淆矩阵, 结果图, 性能图, 鲁棒性图, 效率图, plot, publication figure, 数据可视化, generate plot, figure blueprint, 建议图表类型, figure audit, 审查图表, figure revision, 修改图表.
academic-latex-layoutUse when working on academic paper LaTeX layout, figure/table float placement, draft-to-template LaTeX generation, existing .tex project layout repair, figures piling up, figures far from text, large blank areas, two-column figure/table placement, page-limit layout cleanup, or compiled PDF layout review.
academic-paper-writerUse when writing or revising CS/AI/ML papers from research notes, code repositories, local literature libraries, target venue requirements, or section-level drafting requests. Triggers include 写论文, 初稿, paper draft, write introduction, write method, full paper outline, section-by-section drafting, 证据闭环, 论文起草, 从零写论文, 逐节写作.
academic-polishingPolish academic prose, de-AI-ify text, control claim strength, or rewrite method sections for CS/AI/ML papers. Executes Prose Quality Gate, Claim Strength Audit, and de-AI pass. Use when: removing AI writing patterns from paper text, adjusting claim strength to match evidence level, rewriting method sections with proper narrative flow, improving academic writing quality, checking for overclaiming. Triggers on: 润色, polish, improve writing, 去AI, de-AI, claim strength, 改写, rewrite method, prose quality, 降级表述, remove AI patterns, academic writing polish, 学术润色, 去AI化, 降级结论, improve prose.
academic-venue-researchResearch target venue requirements and writing style for CS/AI/ML papers. Produces venue-brief.md with submission requirements and detailed writing style analysis. Use when: researching target journal/conference requirements, analyzing writing style of target venue, generating venue brief for paper writing, checking submission guidelines. Triggers on: venue research, 期刊调研, 目标期刊, writing style analysis, 写作风格分析, venue requirements, submission guidelines, 投稿要求, journal style, conference format.