academic-manuscript-review — Claude Code skill: what it does
academic-manuscript-review runs a pre-submission review of a scholarly manuscript: flags weak theory, thin evidence and prose trouble, then returns a long candid diagnosis instead of a polite summary.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill academic-manuscript-review -a claude-codeWhat academic-manuscript-review does
The skill runs the review in 12 sections. Two verdicts come first: where the draft stands now, and whether a top-tier path exists once it is revised. Then the question that matters most — what the author claims to contribute against what the paper actually adds. Assets worth protecting in revision follow, along with the analytical blocks.
Weight sits in the analysis: contribution, mechanism, evidence. The section-by-section pass comes later and works as a net for small items, drawing on references/exhaustive_checklist.md. If that sweep ends up longer than the analysis, something is off and the material belongs back in the analytical part.
Before writing, the skill says to read references/tone_and_register.md. Skip that file and the output is competent yet reads like an AI artifact, because the file sets voice and structure. Copy-editing the manuscript, drafting the paper for the author and career advice stay out of scope.
What it helps with
- separate the claimed contribution from what the paper actually adds
- test a draft against the objections of a top-tier reviewer
- collect fixes in theory and empirics before submission
- get comments on a single dissertation chapter or working paper
- reread a revised manuscript with fresh eyes
Example prompts for the agent
- Read this draft the way a reviewer would and tell me what falls apart
- Tear apart the theory section of my working paper
- Give me a pre-submission review of this manuscript, no softening
How to install academic-manuscript-review
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill academic-manuscript-review -a claude-code2Manually: put the files in place
~/.claude/skills/academic-manuscript-review/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/academic-manuscript-review/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill academic-manuscript-review -a codex2Manually: put the files in place
.agents/skills/academic-manuscript-review/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill academic-manuscript-review -a cursor2Manually: put the files in place
.cursor/skills/academic-manuscript-review/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills review-revise/academic-manuscript-review/SKILL.md2Manually: put the files in place
.github/skills/academic-manuscript-review/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill academic-manuscript-review -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path review-revise/academic-manuscript-reviewManually: put the files in place
.devin/skills/academic-manuscript-review/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about academic-manuscript-review
How do I install academic-manuscript-review in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill academic-manuscript-review -a claude-code. The skill then sits at ~/.claude/skills/academic-manuscript-review/SKILL.md.
What does academic-manuscript-review do?
It produces a diagnostic review of a manuscript before submission: a verdict on the draft, a check of claimed versus real contribution, weak spots in the evidence, and a section-by-section pass.
Which manuscripts does it cover?
Empirical, conceptual and theoretical work in management, organization theory, strategy, entrepreneurship, OB, HR and IB. Full drafts or single sections, first versions and revised ones.