paper-self-review

Applies rule-tagged prose and math-typesetting corrections to LaTeX or docx manuscripts before submission.

Updated Oct 7, 2022
One-click install
npx skills add https://github.com/tamagusko/linux-cfg --skill paper-self-review-tamagusko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-self-review
Source: https://github.com/tamagusko/linux-cfg/tree/main/dotfiles/claude/skills/paper-self-review
Command: npx skills add https://github.com/tamagusko/linux-cfg --skill paper-self-review-tamagusko

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Final pre-submission passes on a finished manuscript often drift into rewriting, introducing new errors or changing meaning. This Skill constrains the last review round to corrections and refinements only, with every edit tagged to a named rule and every meaning-touching issue downgraded to a comment. ## Core Features & Use Cases - Math typesetting sweep: Runs scripts/math_sweep.py to list candidates for inline \frac, ambiguous slashes, differential spacing, number-unit spacing, and Knuth-style rules (K1-K10), each adjudicated against references/math-typesetting.md. - Prose pass: Applies eight prose rules (P1-P8) covering modal padding, metadiscourse, acronym expansion, nominalizations, hedges, and sentence structure from references/prose-rules.md. - Settledness check: Read-only verification that abstract numbers match the body, citations resolve, and contributions are delivered, reported as blocking or non-blocking comments. - Use Case: Before submitting a journal paper, run the final pass on main.tex to receive a change log of applied micro-edits, comments on issues that would alter meaning, and a list of rules that did not fire. ## Quick Start Ask the assistant to run the final pre-submission pass on main.tex using the paper self-review rules and produce the tagged change log.

Frequently Asked Questions about paper-self-review

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

FAQPage Schema
How do I do a final proofreading pass on a LaTeX paper before submission?

Run the math sweep script on main.tex to list typesetting candidates, adjudicate each against the math-typesetting reference, then apply the prose rules paragraph by paragraph. Finish with the settledness check and compile to confirm no new warnings.

What LaTeX math typesetting errors does the sweep script detect?

The script flags inline \frac usage, ambiguous slashes with more than two atoms, footnote markers beside math, missing thin spaces before differentials and between numbers and units, italic multi-letter operators, logic symbols in prose, and sentences starting with symbols.

Can this review pass be used on a Word docx manuscript?

Yes, docx sources are supported by analogy: math rules apply to equation objects while LaTeX-specific mechanics are skipped with a note. Meaning-touching issues become document comments instead of edits.

When should I not use this final-pass review?

Do not use it on first drafts, for restructuring or drafting abstracts, for reviewing someone else's paper, for answering peer reviewers, or for originality checks. It assumes the science is settled and only the delivery needs refinement.

Why does the review produce comments instead of fixing some issues?

Any fix that would change meaning, move text across paragraphs, or alter numbers becomes a tagged comment rather than an edit. This prevents the final pass from silently changing the paper's claims or results.