manuscript-optimizer

Diagnose and repair drift across manuscript design, evidence, figures, terminology, and prose.

38|3|Updated May 7, 2026
One-click install
npx skills add https://github.com/Chanw-research/claude-code-paper-writing --skill manuscript-optimizer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: manuscript-optimizer
Source: https://github.com/Chanw-research/claude-code-paper-writing/tree/main/skills/writing-polish/manuscript-optimizer
Command: npx skills add https://github.com/Chanw-research/claude-code-paper-writing --skill manuscript-optimizer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manuscript optimization helps researchers align the top-level design, evidence chain, figures, terminology, and prose, preventing drift during revision and submission.

Core Features & Use Cases

  • Macro-level alignment: ensure the central claim, its supporting evidence, and the section structure are coherent.
  • Evidence and figure coherence: synchronize figures, captions, and paragraph references with the claims.
  • Terminology stability: canonicalize key terms, acronyms, and definitions across the document.
  • Use Case: when an abstract emphasizes a strong story but the Results section lags in supporting it, apply the workflow to restore balance.

Quick Start

Provide a macro-to-micro rewrite pass to align the manuscript's top-level design, evidence chain, figures, terminology, and prose.

Frequently Asked Questions about manuscript-optimizer

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

FAQPage Schema
How do I fix manuscript drift when my abstract outpaces the results section?

Manuscript drift is diagnosed and repaired by enforcing macro-to-micro alignment, synchronizing the central claim, evidence chain, figures, and prose to restore structural balance across all sections.

What is the best way to align manuscript terminology and figures during revision?

Align manuscript terminology and figures by canonicalizing key terms, acronyms, and definitions, while synchronizing figure captions and paragraph references with the supporting evidence chain.

How does a five-level audit preserve rigor in academic manuscript editing?

A five-level audit preserves rigor by systematically checking the top-level design, evidence chain, figures, terminology, and prose for coherence, preventing drift during journal resubmissions or adaptations.

Can I use this manuscript optimization workflow for journal adaptations across disciplines?

Yes, manuscript optimization is applicable to revisions, resubmissions, and journal adaptations across disciplines, diagnosing and repairing drift between the top-level design, evidence chain, and prose.

Why does my manuscript structure lose coherence between the introduction and downstream sections?

Manuscript structure loses coherence when the abstract or introduction outpaces downstream sections, requiring a macro-to-micro rewrite pass to realign the top-level design with the supporting evidence.

When should I not use a macro-to-micro alignment approach for editing?

Avoid macro-to-micro alignment when only localized grammatical corrections are needed, as this workflow targets structural drift, evidence chain coherence, and top-level design synchronization.