Skip to content
Back to search

paper-review

MarketplaceWorks with Claude CodeGitHub

Claude Code skill for critical, approval-gated review and paraphrasing of academic writing

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mrtarantoga--paper-review/badge.svg)](/listings/mrtarantoga--paper-review)

HTML

<a href="/listings/mrtarantoga--paper-review"><img src="/api/listings/mrtarantoga--paper-review/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

As a plugin (recommended)

In Claude Code:

/plugin marketplace add MrTarantoga/paper-review
/plugin install paper-review@paper-review

Manually

Download the zip from the latest [release](https://github.com/MrTarantoga/paper-review/releases/latest), or copy the skill folder into your personal or project skills directory:

git clone https://github.com/MrTarantoga/paper-review.git
cp -r paper-review/skills/paper-review ~/.claude/skills/        # all projects
# or
cp -r paper-review/skills/paper-review <project>/.claude/skills/ # one project

The citation checker needs only Python 3 (standard library).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 11 lines
  1. {
  2. "name": "paper-review",
  3. "owner": { "name": "Goetz" },
  4. "plugins": [
  5. {
  6. "name": "paper-review",
  7. "source": "./",
  8. "description": "Critical, approval-gated review and paraphrasing of academic writing."
  9. }
  10. ]
  11. }
README.md · README · 140 lines
  1. # paper-review
  2. [![CI](https://github.com/MrTarantoga/paper-review/actions/workflows/ci.yml/badge.svg)](https://github.com/MrTarantoga/paper-review/actions/workflows/ci.yml)
  3. A [Claude Code](https://claude.com/claude-code) skill for critical review,
  4. proofreading and meaning-preserving paraphrasing of academic writing: research
  5. papers, exposés and research proposals, thesis chapters, abstracts. It works on
  6. LaTeX, Markdown, plain text and pasted paragraphs.
  7. It acts as a demanding but fair editor. It points out weaknesses honestly, keeps
  8. the author's voice and exact meaning, and **never changes your text without your
  9. approval of each specific change**.
  10. ## What it does
  11. - **Paraphrase (QuillBot-style):** academic, formal, fluent, concise, simplified
  12. or expanded rewrites, with two or three genuinely different alternatives per
  13. passage and a warning wherever a rephrase could shift the meaning.
  14. - **Grammar and style:** articles, prepositions, tense, nominal style, filler,
  15. inconsistent terminology. It includes specific checks for German-influenced
  16. English (false friends such as *actual*/*aktuell* or *eventually*/*eventuell*,
  17. "on the other side", sentence-initial "Also,").
  18. - **Structural review:** checklists for exposés and proposals, research papers,
  19. abstracts and thesis chapters
  20. ([`references/review-checklist.md`](skills/paper-review/references/review-checklist.md)).
  21. - **Citation check:** a bundled script
  22. ([`scripts/check_citations.py`](skills/paper-review/scripts/check_citations.py))
  23. reports cite keys missing from the `.bib`, unused entries, duplicate keys and
  24. entries lacking common fields. It follows `\input`/`\include`. The skill
  25. also flags uncited claims and never invents references.
  26. - **Reviewer feedback:** a concise peer-review report covering summary,
  27. strengths, major and minor issues, hard-to-follow passages, questions, and an
  28. overall assessment.
  29. - **Unclear passages** are marked separately, with an explanation of *why* a
  30. reader would stumble, and the skill asks instead of guessing what you meant.
  31. ## How it works
  32. 1. **Scope:** clarifies which mode and which part of the text you want.
  33. 2. **Analyse and report:** numbered findings, ordered by importance (meaning and
  34. logic first, nitpicks last).
  35. 3. **Discuss:** goes through every issue with you **one question per
  36. decision**, using Claude Code's multiple-choice question dialog, with a
  37. recommended option and the consequences of each choice.
  38. 4. **Apply:** rewrites section by section, again one question per change, with
  39. an `OLD:`/`NEW:` preview. It applies only what you approved, then compiles
  40. LaTeX into a scratch directory to check for broken references or citations,
  41. and re-reads the result for problems its own edits introduced.
  42. If you say "just apply everything", it does so, except for changes that would
  43. alter meaning or that depend on an unanswered question.
  44. LaTeX stays intact: commands, `\cite`/`\ref`/`\label`, math, comments, `~`, and
  45. line structure. If you prefer annotations to edits, it can insert `\todo{}`
  46. notes (`todonotes`).
  47. ## Installation
  48. ### As a plugin (recommended)
  49. In Claude Code:
  50. ```
  51. /plugin marketplace add MrTarantoga/paper-review
  52. /plugin install paper-review@paper-review
  53. ```
  54. ### Manually
  55. Download the zip from the latest
  56. [release](https://github.com/MrTarantoga/paper-review/releases/latest), or copy the skill folder into your personal or project skills directory:
  57. ```bash
  58. git clone https://github.com/MrTarantoga/paper-review.git
  59. cp -r paper-review/skills/paper-review ~/.claude/skills/ # all projects
  60. # or
  61. cp -r paper-review/skills/paper-review <project>/.claude/skills/ # one project
  62. ```
  63. The citation checker needs only Python 3 (standard library).
  64. ## Usage
  65. The skill triggers on its own for requests such as:
  66. - "Review my exposé"
  67. - "Can you look over section 2?"
  68. - "Paraphrase this paragraph, more concise"
  69. - "Check my citations"
  70. - "Give me reviewer feedback on the introduction"
  71. - "Is this sentence OK?"
  72. You can also run the citation checker on its own:
  73. ```bash
  74. python3 skills/paper-review/scripts/check_citations.py main.tex [--bib refs.bib]
  75. ```
  76. ## How it differs from similar skills
  77. Several community skills cover academic proofreading and peer review, for
  78. example [JakobThumm/proofreading](https://github.com/JakobThumm/proofreading),
  79. `flonat/claude-research` (proofread), `jkitchin/skillz` (scientific-reviewer),
  80. `K-Dense-AI/claude-scientific-writer` (peer-review) and
  81. `bahayonghang/academic-writing-skills`. Most of them either produce a
  82. report only or rewrite in bulk. This skill aims for the middle ground:
  83. - an **interactive, approval-gated workflow**: one decision per question, edits
  84. applied only after explicit approval, section by section;
  85. - **strict meaning and voice preservation**: no strengthened or weakened
  86. claims, no added facts, hedges or citations, and none of the generic
  87. "AI prose" vocabulary;
  88. - review, paraphrasing, structural checklists and citation checking **in one
  89. skill**;
  90. - attention to the typical errors of **German native speakers** writing in
  91. English.
  92. ## Development
  93. CI ([`.github/workflows/ci.yml`](.github/workflows/ci.yml)) runs on every push
  94. and pull request. To run the same checks locally:
  95. ```bash
  96. python3 tests/validate_skill.py # SKILL.md frontmatter, manifests, file references
  97. python3 -m unittest discover -s tests -v # citation checker tests
  98. ruff check . # lint
  99. ```
  100. ### Releasing
  101. 1. Bump `version` in [`.claude-plugin/plugin.json`](.claude-plugin/plugin.json) and commit.
  102. 2. Tag and push: `git tag v1.0.1 && git push origin v1.0.1`.
  103. The [release workflow](.github/workflows/release.yml) checks that the tag
  104. matches `plugin.json`, runs validation and tests, and publishes a GitHub release
  105. with generated notes and a zipped skill folder (`paper-review-vX.Y.Z.zip`).
  106. ## Licence
  107. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.