Agent skill

Paper Revision

by franklee16 in franklee16/academic-research-skills

Comprehensive workflow for handling journal Revise and Resubmit (R&R) decisions.

No licenceAuto-check passedDocuments & Office

Install Paper Revision

skills CLI
$ npx skills add franklee16/academic-research-skills --skill paper-revision -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install franklee16/academic-research-skills paper-revision --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/franklee16/academic-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/review-revise/paper-revision-master .claude/skills/paper-revision && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
paper-revision
GitHub stars
223
Token cost
~3.4k tokens
SKILL.md length
1,355 words
Files
10 (incl. scripts, references, assets)
Skills in repo
1,617
Repo updated
First seen
Licence
None found

At a glance

Comprehensive workflow for handling journal Revise and Resubmit (R&R) decisions.

  • Works in 10 steps: Read the Editor's Letter → Create Revision Tracker → Extract All Comments → …
  • You receive referee reports and need to systematically track
  • SKILL.md covers When to Use This Skill, The 10-Step R&R Workflow, Workflow Integration and Resources Overview, plus 4 more sections
  • Runs Python scripts from its folder; calls python and pip

What it does

Paper Revision is an agent skill from franklee16/academic-research-skills. Comprehensive workflow for handling journal Revise and Resubmit (R&R) decisions. Use when you receive referee reports and need to systematically track, classify, and respond to reviewer comments. Triggers include R&R decisions, referee comments, response to reviewers, revision letter drafting, and handling referee reports. Provides structured 10-step workflow, revision tracking spreadsheet, LaTeX response letter template, and automated comment extraction.

Its SKILL.md is about 3.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 12 other files, including scripts, reference files and assets (for example `README.md`, `references/comment_classification.md` and `references/response_examples.md`).

It sits in Documents & Office, covering Excel spreadsheets and LaTeX. It works with LaTeX. The repository describes itself as: Comprehensive collection of Claude Code skills for academic research in economics, finance, and social sciences.

When your agent uses it

  • You receive referee reports and need to systematically track
  • Respond to reviewer comments
  • Include R&R decisions
  • Referee comments

Example prompts

  • “/paper-revision”

Requirements

  • Python 3

Workflow steps

10 steps, taken from the step headings in SKILL.md.

  1. Read the Editor's Letter
  2. Create Revision Tracker
  3. Extract All Comments
  4. Organize Comments Logically
  5. Classify Each Comment
  6. Plan Your Responses
  7. Execute the Revision
  8. Write the Response Letter
  9. Double-Check Everything
  10. Final Read and Resubmit

What it can do on your machine

Read from SKILL.md and the folder at commit 9a4b2db. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Paper Revision loads about 3.4k tokens when it runs, and up to ~8.5k if it reads all its reference files. Until then it costs about 119 tokens; SKILL.md has 1,355 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~119
When it runs · the whole SKILL.md, loaded when a task matches
~3.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,355 words (~3,428 tokens).

“A comprehensive skill for managing journal revise-and-resubmit workflows, from extracting referee comments to drafting the response letter.”

— opening of SKILL.md by franklee16
name
paper-revision

Read the full SKILL.md on GitHub

Files

SKILL.md and 9 other files (scripts, references, assets) in review-revise/paper-revision-master of franklee16/academic-research-skills.

  • SKILL.md
  • README.md
  • assets/response_letter_template.tex
  • assets/revision_tracker_template.csv
  • paper-revision.skill
  • references/comment_classification.md
  • references/response_examples.md
  • references/revision_workflow_integration.md
  • scripts/generate_response_letter.py
  • scripts/parse_referee_report.py

Open the folder on GitHubat commit 9a4b2db

Compare with similar skills

Paper Revision next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Paper Revision compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paper Revision this skillfranklee16/academic-research-skills223—~3.4kAutomated safety check: PassNone
PDFzai-org/ZCode7.7k—~18kAutomated safety check: NotesProprietary
MineruNebutra/MinerU-Skill123—~504Automated safety check: PassMIT
PDFflonat/flonat-research146—~488Automated safety check: PassProprietary
Publication Chart SkillGalaxy-Dawn/claude-scholar5.7k1 repos~3.3kAutomated safety check: PassMIT
MineruNebutra/MinerU-Skill123—~1.4kAutomated safety check: PassMIT

Similar skills

  • PDF

    zai-org/ZCode

    Professional PDF toolkit covering four production workflows: reports, creative visuals, academic LaTeX, and existing PDF processing.

    7.7k GitHub stars~18k tokensUpdated yesterday
    Documents & OfficeAuto-check: notes
  • Mineru

    Nebutra/MinerU-Skill

    An AI-Native skill for parsing PDF / Office / image files into Markdown with MinerU — a fast, zero-config document parser for AI agents.

    123 GitHub stars~504 tokensUpdated 17 days ago
    Documents & OfficeAuto-check passed
  • PDF

    flonat/flonat-research

    Read, create, combine, split, rotate, OCR, watermark, secure, or extract content from PDF files.

    146 GitHub stars~488 tokensUpdated 12 days ago
    Documents & OfficeAuto-check passed
  • Publication Chart Skill

    Galaxy-Dawn/claude-scholar

    This skill should be used when the user asks for a publication-quality scientific figure or table, wants help choosing the right chart for results, needs a paper-ready pubfig or pubtab workflow…

    5.7k GitHub starsUsed in 1 repo~3.3k tokens
    Documents & OfficeAuto-check passed
  • Mineru

    Nebutra/MinerU-Skill

    An AI-Native skill for parsing PDF / Office / image files into clean Markdown with MinerU — a fast, zero-config document parser for AI agents.

    123 GitHub stars~1.4k tokensUpdated 17 days ago
    Documents & OfficeAuto-check passed
  • Reference Verify

    brycewang-stanford/Auto-Empirical-Research-Skills

    Verify references in an academic paper: check whether each BibTeX entry is real, whether in-text citations match the cited paper's actual content, and produce a structured verification report.

    4.6k GitHub stars~5.5k tokensUpdated 6 days ago
    Documents & OfficeAuto-check: notes

More from franklee16/academic-research-skills

All 1,617 skills in this repo
  • Econometric Research Writing

    franklee16/academic-research-skills

    End-to-end econometric analysis and economics/management paper-writing workflow.

    223 GitHub stars~2.4k tokensUpdated 23 days ago
    Auto-check passed
  • Sci Ssci Polishing

    franklee16/academic-research-skills

    A skill your agent uses when researchers need Chinese academic prose translated into publication-oriented English or English manuscript paragraphs and complete sections polished for SCI, SSCI, or…

    223 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Research Defense Radar

    franklee16/academic-research-skills

    Assess and monitor an ongoing research project's competitor landscape, novelty risk, and method/data opportunities from a proposal, paper, research question, data or method notes, or a suspected…

    223 GitHub stars~4k tokensUpdated 23 days ago
    Auto-check passed
  • Academic Grant

    franklee16/academic-research-skills

    Generate or fill in academic grant application forms (project statement, education plan, pathway to impact, references) using draft research material.

    223 GitHub stars~2.8k tokensUpdated 23 days ago
    Auto-check: notes
  • Chinese Reference Formatter Skill

    franklee16/academic-research-skills

    A skill your agent uses when a user needs通用中文参考文献、GB/T 7714-style bibliography entries, Chinese academic reference formatting, or BibTeX completion from Chinese or English literature titles…

    223 GitHub stars~1.1k tokensUpdated 23 days ago
    Auto-check passed
  • Code To Notation Table

    franklee16/academic-research-skills

    A skill your agent uses when the user provides program code, scripts, or variable lists and wants a Word .docx correspondence table mapping code variables to paper-ready mathematical notation.

    223 GitHub stars~1k tokensUpdated 23 days ago
    Auto-check passed

Works with

Questions about Paper Revision

What does Paper Revision do?

Comprehensive workflow for handling journal Revise and Resubmit (R&R) decisions. Paper Revision is an agent skill from franklee16/academic-research-skills. Comprehensive workflow for handling journal Revise and Resubmit (R&R) decisions.

When should I use Paper Revision?

Paper Revision fits situations like: you receive referee reports and need to systematically track; respond to reviewer comments; include R&R decisions; referee comments.

How do I install Paper Revision in Claude Code?

Run `npx skills add franklee16/academic-research-skills --skill paper-revision -a claude-code`. Or copy the skill folder (review-revise/paper-revision-master in franklee16/academic-research-skills) into .claude/skills/paper-revision in your project. Claude Code loads it when a task matches its description.

How do I install Paper Revision in Codex?

Run `npx skills add franklee16/academic-research-skills --skill paper-revision -a codex`. Or copy the skill folder (review-revise/paper-revision-master in franklee16/academic-research-skills) into .agents/skills/paper-revision in your project. Codex loads it when a task matches its description.

Can I use Paper Revision in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add franklee16/academic-research-skills --skill paper-revision -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/paper-revision, .gemini/skills/paper-revision, .github/skills/paper-revision and .opencode/skills/paper-revision in your project.

What does Paper Revision need to run?

Going by SKILL.md and its folder, Paper Revision needs Python for the scripts in its folder and the command-line tools its instructions call (python and pip). Our summary lists: Python 3.

Does Paper Revision access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Paper Revision safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Paper Revision use?

No licence was found for Paper Revision or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Paper Revision use?

About 3.4k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.1k tokens, read only when the agent opens those files.

What are the alternatives to Paper Revision?

Skills that share tags, products or a category with Paper Revision: PDF (zai-org/ZCode, 7.7k stars), Mineru (Nebutra/MinerU-Skill, 123 stars), PDF (flonat/flonat-research, 146 stars) and Publication Chart Skill (Galaxy-Dawn/claude-scholar, 5.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paper Revision?

franklee16 (a GitHub user) maintains it in franklee16/academic-research-skills, which has 223 GitHub stars. The repository holds 1,617 skills in this directory. The repository was last updated on September 18, 2026.

Source: franklee16/academic-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.