/review — Manuscript Review

SkillDev tools

Review a manuscript or chapter as an external reviewer, or run an own-work self-review in a fresh-context clean room, producing anchored findings and a recommendation.

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 /review — Manuscript Review skill

What this skill tells your AI

The instructions your AI receives, as published by yha9806/academic-writing-toolkit in .claude/skills/review/SKILL.md and read by ahel’s review.

Modes

  • external (default): review another author's work as submitted.
  • own-work: review the user's own draft. The clean room is real, not declared: spawn ONE fresh-context subagent whose prompt contains only the manuscript text (and explicitly listed evidence files), and relay its findings. Never present a same-session read-through as a clean-room review — the drafting conversation is context contamination by definition.

Evidence boundary

Judge the manuscript as submitted. Do not use prior chat memory, unstated author intentions, or model background knowledge as evidence for or against a claim. If a claim cannot be assessed from the manuscript and its cited sources, say so — that is itself a finding.

Findings format

Every finding is anchored (section/paragraph or quoted span) and typed:

#TypeAnchorFindingSeverity

Types: claim-exceeds-evidence | gap-contribution-mismatch | method | structure | clarity | citation. Split findings three ways: defects that block the recommendation, improvements that would strengthen it, and questions the author must answer. Consult references/argument-checklist.md for the interrogation checklist and examiner-attack pre-mortem when the review targets argument quality.

Recommendation vocabulary

Exactly one of: accept | minor_revision | major_revision | reject_resubmit | reject | no_recommendation.

Stop conditions

Stop and report a blocker instead of continuing if asked to: fabricate reviewer consensus, citation support, or experimental findings; review text that is not available as submitted; or convert this review into a rewrite — /review never edits the manuscript.

Constraints

  1. Never rewrite or patch the manuscript; output findings only.
  2. No emoji. British English.
  3. Own-work mode without a subagent available: state plainly that the review is NOT clean-room and label the output accordingly.

Signals

GitHub stars
38
Forks
7
Last commit
Sep 2026
Hacker News mentions
20
Advanced
Catalog kind
skill
Gateway key
review-yha9806
Source
github.com/yha9806/academic-writing-toolkit