paper-reviewer

Generate reviewer annotations for Word or PDF academic manuscripts.

265|23|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/yipng05-max/-skills --skill paper-reviewer-yipng05-max
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-reviewer
Source: https://github.com/yipng05-max/-skills/tree/main/paper-reviewer
Command: npx skills add https://github.com/yipng05-max/-skills --skill paper-reviewer-yipng05-max

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-docx, lxml, pdf2docx, and includes scripts (resource) components.

What problem does it solve?

This Skill turns Word (.docx) or PDF academic manuscripts into structured, reviewer-style feedback with visible revision markers, so you can quickly see what to change and why.

Core Features & Use Cases

  • Paragraph-level extraction: Extracts numbered paragraph text from .docx or automatically converts .pdf to .docx before processing.
  • Two output modes: Generates either a visual review (delete/insert/annotate styling) or tracked-changes style suitable for Word (WPS compatibility limited).
  • Reviewer-grade critique: Produces feedback across structure, language, and academic norm dimensions (e.g., thesis clarity, literature review quality, method transparency, argumentation, citation practices).
  • Deterministic application via JSON: Requires a Python-generated revisions JSON to precisely locate and apply replacements, comments, and deletions.

Quick Start

Ask the assistant to review the paper you uploaded and produce a visual annotated Word document highlighting suggested deletions, additions, and reviewer comments.

Frequently Asked Questions about paper-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add tracked changes and reviewer comments to an academic paper PDF?

To add tracked changes to an academic paper PDF, the tool first converts the PDF to DOCX using pdf2docx, then applies a revisions JSON with exact old_text matching to generate tracked-changes OOXML output with comment insertion.

What is the best way to generate structured reviewer annotations for a Word document?

Generating structured reviewer annotations for a Word document requires a Python-based revisions JSON to precisely locate text, applying replace, comment, and delete operations to produce either visual markups or tracked-changes output.

Does python-docx support inserting tracked changes and visual review markups?

Yes, python-docx combined with lxml supports generating tracked-changes OOXML output and visual review markups by applying structured revision instructions to extract paragraphs and insert comments or deletions.

Can I apply specific delete and insert operations to paragraphs in a docx manuscript?

You can apply delete and insert operations to paragraphs in a docx manuscript by providing a revisions JSON containing exact old_text matching and paragraph indices extracted from the document.

Why does my PDF to DOCX conversion matter for academic paper review workflows?

PDF to DOCX conversion matters for academic paper review because the tool uses pdf2docx to transform PDF manuscripts into editable Word documents before extracting paragraphs and applying reviewer annotations.

What are the limitations of using tracked changes output with WPS Office?

The tracked changes output generated via OOXML has limited WPS Office compatibility, meaning the visual review mode with delete and insert styling may be more reliable for WPS users.