joshua-zyy/academic-paper-writer / skills/academic-reviser
academic-reviser
VerifiedSelf-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
- Read
manifest.yaml. It declaresalways_loadfiles,axes, andreferences.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.mddefines non-negotiable rules, bounded assessment, termination conditions, and scope.red-lines.mddefines absolute prohibitions. Do not negotiate these.output-contract.mddefines deliverables, debt types, and Verification Status format.anti-patterns.mddefines known failure modes, correct alternatives, and self-deception signals.
- Detect the mode using the manifest's
modeaxis. 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'sreferences.on_demandcondition 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 |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |