paper-revision · franklee16 — Claude Code skill for journal revisions
paper-revision is a Claude Code skill that organizes referee feedback, plans manuscript changes, and drafts a response letter for journal revision.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill paper-revision -a claude-codeWhat paper-revision does
The skill turns referee feedback into a revision tracker. It groups comments by manuscript section and sorts them into new analysis, clarification, disagreement, or minor edits. The scripts/parse_referee_report.py utility can extract comments from a PDF or text report and create the initial tracker.
Use the completed tracker to prepare a letter with replies to reviewers and the editor. A LaTeX template is provided at assets/response_letter_template.tex, and scripts/generate_response_letter.py creates a draft from the tracker. Disagreement needs user approval; the skill is not meant to reject a referee request on its own. For requests requiring new analysis, the workflow calls for code in R, Stata, or Python and updated manuscript results.
What it helps with
- turn referee reports into a structured comment tracker
- sort reviewer feedback by manuscript section and response type
- plan a manuscript change for each reviewer comment
- draft a response letter from the completed tracker
Example prompts for the agent
- Extract the comments from
referee_report.pdfand createrevision_tracker.csv. - Group the referee comments by manuscript section and assign a response category to each.
- Draft a response letter from
revision_tracker.csvfor the paper titled “Your Paper Title”.
How to install paper-revision
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-revision -a claude-code2Manually: put the files in place
~/.claude/skills/paper-revision-master/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/paper-revision-master/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-revision -a codex2Manually: put the files in place
.agents/skills/paper-revision-master/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-revision -a cursor2Manually: put the files in place
.cursor/skills/paper-revision-master/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills review-revise/paper-revision-master/SKILL.md2Manually: put the files in place
.github/skills/paper-revision-master/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-revision -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path review-revise/paper-revision-masterManually: put the files in place
.devin/skills/paper-revision-master/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 paper-revision
How do I install paper-revision in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill paper-revision-master -a claude-code. The skill file is at ~/.claude/skills/paper-revision-master/SKILL.md.
What does paper-revision do?
It organizes referee comments into response categories, helps plan manuscript edits, and drafts a letter to the editor and reviewers. It includes utilities for extracting comments and generating a letter draft.
Does the skill decide on reviewer disagreements by itself?
No. A user must approve responses classified as DISAGREE before they are finalized.
Similar skills
All skills for Science and research →paper-revision by other authors comes first.