Skip to content
alyn
lingzhi227

Paper Revision skill

Revise papers based on reviewer feedback. Map reviewer concerns to specific sections, apply targeted edits, run additional experiments if needed, and verify improvements. Use after receiving peer review with revision requests.

$npx skills add lingzhi227/agent-research-skills --skill paper-revision
View this skill on GitHublingzhi227/agent-research-skills/skills/paper-revision/SKILL.md
Pack stars
462
Pack installs
60k
Alyn Score
46/99
Updated
9 months ago
– views – installs via Alyn

lingzhi227

Paper Revision

Research Code review

Install Paper Revision

Pick your agent. Every command is ready to paste.

$npx skills add lingzhi227/agent-research-skills --skill paper-revision

The open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.

01

Install it

Run the command above, or upload the folder in Claude.

02

Ask naturally

Describe the task. Your agent loads paper-revision when the request matches its description.

03

Name it if needed

If it does not trigger, say “use the paper-revision skill”. In Codex, type $paper-revision.

The skill itself

SKILL.md

FolderGitHub

Paper Revision

Systematically revise papers based on reviewer feedback.

Input

  • $0 — Reviewer comments/feedback
  • $1 — Current paper draft (main.tex or paper directory)

References

  • Revision workflow and prompts: ~/.claude/skills/paper-revision/references/revision-prompts.md

Workflow

Step 1: Parse and Prioritize Concerns

For each reviewer comment:

  1. Extract the specific concern
  2. Classify: major revision, minor revision, question, suggestion
  3. Map to affected paper section(s)
  4. Prioritize: address major concerns first

Step 2: Plan Revisions

Create a revision plan:

Concern → Affected Section → Required Action → New Content/Experiment

Categories of actions:

  • Clarification: Rewrite text for clarity
  • Additional experiment: Run new experiment, add results
  • New analysis: Add ablation, statistical test, or comparison
  • Structural change: Move, merge, or split sections
  • Citation: Add missing references

Step 3: Execute Revisions

For each planned revision:

  1. Read the current section
  2. Apply targeted edits (preserve surrounding structure)
  3. If new experiments needed: use experiment-code skill
  4. If new figures/tables needed: use figure-generation / table-generation skills
  5. Mark changes (use \textcolor{blue}{...} for revised text)

Step 4: Verify Improvements

  • Re-run self-review skill to check if scores improved
  • Verify all reviewer concerns are addressed
  • Check that revisions don't introduce new issues
  • Ensure page count still fits venue requirements

Step 5: Write Revision Summary

Generate a diff summary:

  • List all changes made with section references
  • Note any new experiments, figures, or tables added
  • Cross-reference each change to the reviewer concern it addresses

Rules

  • Address EVERY reviewer concern — do not skip any
  • Preserve paper structure unless structural change is explicitly needed
  • New results must come from actual experiments, not hallucinated
  • Mark all revised text clearly for the reviewers
  • Keep a copy of the previous version before revising
  • Compare new scores vs previous scores after revision

Tips for Paper Revision

  • • Start a fresh session after installing so your agent picks up the new skill.
  • • It bundles reference files. The agent reads them only when needed, so they cost no context until then.
  • • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
  • • If two skills overlap, mention the one you want by name.

Questions about Paper Revision

What does the Paper Revision skill do?

Revise papers based on reviewer feedback. Map reviewer concerns to specific sections, apply targeted edits, run additional experiments if needed, and verify improvements. Use after receiving peer review with revision requests.

How do I install Paper Revision?

Run "npx skills add lingzhi227/agent-research-skills --skill paper-revision" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.

Does Paper Revision work in Cursor and Codex?

Yes. Paper Revision uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.

Is Paper Revision free?

Paper Revision is open source on GitHub. It is free to install; check the license before commercial use.

Who made Paper Revision?

Paper Revision is published by lingzhi227 in the lingzhi227/agent-research-skills repository, together with 29 other skills.

Similar skills. From other creators.