proofreading

Diagnoses manuscript flow issues simulating a first-time reader across academic drafts.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/shusuke-ioku/r2 --skill proofreading-shusuke-ioku
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proofreading
Source: https://github.com/shusuke-ioku/r2/tree/main/src/r2/template/.claude/skills/proofreading
Command: npx skills add https://github.com/shusuke-ioku/r2 --skill proofreading-shusuke-ioku

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Simulates a first-time reader to identify where manuscript structure, continuity, or pacing breaks reader understanding. Flags issues such as unclear transitions, missing context, undefined terms, abrupt topic shifts, buried key claims, redundancy, and pacing problems, and suggests concrete improvements.

Core Features & Use Cases

  • Simulates reader state across the manuscript to identify flow gaps and logical gaps.
  • Flags undefined terms, expectation violations, and pacing problems, with prioritized fixes.
  • Provides actionable, section-aware recommendations to improve reader comprehension in research papers and reports.

Quick Start

Load a manuscript and run the reader-state analysis to identify flow issues.

Frequently Asked Questions about proofreading

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

FAQPage Schema
How do I identify flow and logic gaps in an academic manuscript?

To identify flow and logic gaps in an academic manuscript, this analysis simulates a first-time reader to detect continuity issues, expectation violations, and pacing problems, providing actionable recommendations for improved structure.

How do I evaluate the readability and pacing of a research paper?

Evaluating the readability and pacing of a research paper involves simulating a first-time reader across the full text to diagnose pacing problems and structural breaks, producing a final overall flow assessment with prioritized fixes.

Can I check if my APSR or AJPS-style manuscript meets reader expectations?

Yes, you can check if your APSR or AJPS-style manuscript meets reader expectations by applying a structured analysis that tags issues like forward references and logical gaps, assigning severity ratings to prioritize improvements.

What is the best way to find undefined terms and expectation violations in a draft?

The best way to find undefined terms and expectation violations in a draft is to simulate a first-time reader, which automatically flags missing context and buried key claims to enhance reader comprehension.

Does this manuscript proofreading process provide section-aware recommendations?

Yes, the manuscript proofreading process provides section-aware recommendations by simulating reader state across the document, diagnosing structural continuity breaks, and delivering actionable fixes tailored to specific sections of your research paper.

When should I use an automated reader simulation for manuscript proofreading?

You should use an automated reader simulation for manuscript proofreading when you need to diagnose complex flow issues in academic drafts, such as identifying logical gaps, abrupt shifts, and redundancy before finalizing the structure.