Home
cd ../playbooks
Academic ResearchIntermediate

Scientific Manuscript Editor

Five focused editing passes for scientific manuscripts: verb tense conventions by section, topic-sentence structure, line-by-line grammar, substantive clarity editing, and a pre-submission compliance check.

10 minutes
By Matsen GroupSource
#scientific-writing#manuscript-editing#latex#academic-writing#grammar-checking#journal-submission#peer-review-prep#verb-tense

Your co-author points out the Methods section is in present tense, the Introduction shifts tense mid-paragraph, and a reviewer's first comment is that your repository link 404s — because generic grammar checkers don't know scientific writing has its own tense conventions, and nothing checks whether your GitHub repo is actually public before you hit submit.

Who it's for: PhD students and postdocs preparing a manuscript for journal submission, PIs doing a final pass before co-authors sign off, research groups standardizing writing quality across a lab's publications, anyone who's had a paper bounced by an editor for an inaccessible repository or incomplete citation, non-native English speakers wanting a genuinely academic-register edit rather than generic grammar correction

Example

"Do a full editing pass on my Results section before I send it to my advisor" → Verb tense checked against Results-section conventions (past tense for findings), topic sentences flagged with %CC comments only where genuinely weak, line-by-line grammar review catching a dangling modifier and two comma splices, substantive clarity edits tightening three overwrought sentences, and — once the whole paper is ready — a pre-submission check confirming the GitHub repo is public and every preprint citation has been checked for its published version

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

Or install from your terminal:
npx ccplaybooks add scientific-manuscript-editor
# Scientific Manuscript Editor

## Your Role

You are a scientific manuscript editing team, not a single generic proofreader. Five specialized passes, each catching a different class of problem that generic grammar checkers and general-purpose editing miss entirely: verb tense conventions specific to scientific writing, paragraph structure, line-by-line grammar, substantive clarity editing, and pre-submission compliance checks.

Run these as **separate, focused passes** rather than one blended review — each one has a narrow job and does it thoroughly rather than skimming for everything at once.

---

## Pass 1: Verb Tense Consistency

Get new playbooks like this one

One email a week with new Claude Code workflows. Free, like everything here.

No spam. Unsubscribe anytime.

README.md

What This Does

Five separate, narrowly-focused editing passes instead of one generic proofread — because scientific manuscripts have failure modes generic editors don't catch: section-specific verb tense conventions, paragraphs that don't survive a topic-sentence-only skim, and pre-submission blockers like a private GitHub repo or an unpublished preprint citation that should now point to the journal version.

Each pass is LaTeX-aware — commands, citations, and math expressions are recognized and left alone; only the actual prose gets edited.


Quick Start

Step 1: Create a Project Folder

mkdir manuscript-editing && cd manuscript-editing

Step 2: Download the Template

Click Download above, then:

mv ~/Downloads/CLAUDE.md ./

Step 3: Run an Editing Pass

claude

Then ask: "Check the verb tense in my Methods section" or "Run a full editing pass on this manuscript"


The Five Passes

Pass Catches
Verb tense Section-specific tense violations — present tense in Methods, tense drift mid-paragraph in Discussion
Topic sentences Paragraphs whose main point isn't in the first sentence — tested by whether the paper reads coherently from topic sentences alone
Line-by-line grammar Dangling modifiers, unclear antecedents, comma splices — the class of error generic tools miss
Clarity editing Jargon that obscures rather than precises, inconsistent terminology, sentences that are correct but unclear
Pre-submission check Private repos, unpublished preprints that have since been published, incomplete bibliographic entries

Tips & Best Practices

  • Run passes separately, not blended. Each one has a narrow job — mixing "check my grammar" with "check my tense" with "check my structure" into one pass produces shallower results on all three than running them one at a time.
  • The topic-sentence pass marks before it rewrites. It inserts %CC comments only where a paragraph's opener genuinely doesn't carry the main point — a well-structured paragraph gets no comment. Implementation happens only when you explicitly ask for it, so you can review the marked list before anything changes.
  • Tense conventions differ by section, and that's not a style choice — it's convention. Methods is past tense throughout. Introduction mixes present (established knowledge) and past (specific prior studies). Getting this right matters more to reviewers than it might seem.
  • Run the pre-submission check last, and run it even if you're confident. A private repository link or an unpublished preprint citation that's now been formally published are exactly the kind of thing that's invisible during writing and obvious to a reviewer — catching it before submission avoids an easily preventable rejection reason.
  • "Our work" reads casual to most journals — "our study" is the safer default. Small thing, flagged reflexively across academic style guides for a reason.

Limitations

  • The clarity-editing pass explicitly stays out of domain-specific technical content it can't evaluate (a specialized statistical method, a niche protocol) — it flags the limitation rather than confidently editing something outside general scientific writing conventions
  • Repository and preprint verification depends on being able to actually reach those resources — rate-limited or auth-gated links get flagged for manual verification rather than silently skipped
  • Designed around LaTeX source specifically; verb-tense and grammar passes assume LaTeX markup needs to be distinguished from prose, which matters less if working from plain text or Word
  • This playbook condenses five of the source repository's manuscript-focused agents; the source also ships general code-review agents (antipattern detection, code smell detection) not included here since they overlap with the code-review content already on this site

$Related Playbooks

Academic Research

Scientific Matchms

Spectral similarity and compound identification for metabolomics. Use for comparing mass spectra, computing similarity scores (cosine, modified cosine), and identifying unknown compounds from spectral libraries. Best for metabolite identification,...

10 minutes
Intermediate
Academic Research

Scientific Medchem

Medicinal chemistry filters. Apply drug-likeness rules (Lipinski, Veber), PAINS filters, structural alerts, complexity metrics, for compound prioritization and library filtering.

10 minutes
Intermediate
Academic Research

Scientific Metabolomics Workbench Database

Access NIH Metabolomics Workbench via REST API (4,200+ studies). Query metabolites, RefMet nomenclature, MS/NMR data, m/z searches, study metadata, for metabolomics and biomarker discovery.

5 minutes
Beginner
Academic Research

Scientific Molecular Dynamics

Run and analyze molecular dynamics simulations with OpenMM and MDAnalysis. Set up protein/small molecule systems, define force fields, run energy minimization and production MD, analyze trajectories (RMSD, RMSF, contact maps, free energy surfaces)...

15 minutes
Advanced
Academic Research

Scientific Molfeat

Molecular featurization for ML (100+ featurizers). ECFP, MACCS, descriptors, pretrained models (ChemBERTa), convert SMILES to features, for QSAR and molecular ML.

10 minutes
Intermediate
Academic Research

Scientific Monarch Database

Query the Monarch Initiative knowledge graph for disease-gene-phenotype associations across species. Integrates OMIM, ORPHANET, HPO, ClinVar, and model organism databases. Use for rare disease gene discovery, phenotype-to-gene mapping, cross-speci...

5 minutes
Beginner
Academic Research

Scientific Neurokit2

Comprehensive biosignal processing toolkit for analyzing physiological data including ECG, EEG, EDA, RSP, PPG, EMG, and EOG signals. Use this skill when processing cardiovascular signals, brain activity, electrodermal responses, respiratory patter...

10 minutes
Intermediate
Academic Research

Scientific Neuropixels Analysis

Neuropixels neural recording analysis. Load SpikeGLX/OpenEphys data, preprocess, motion correction, Kilosort4 spike sorting, quality metrics, Allen/IBL curation, AI-assisted visual analysis, for Neuropixels 1.0/2.0 extracellular electrophysiology....

15 minutes
Advanced
Academic Research

Scientific Omero Integration

Microscopy data management platform. Access images via Python, retrieve datasets, analyze pixels, manage ROIs/annotations, batch processing, for high-content screening and microscopy workflows.

10 minutes
Intermediate
Academic Research

Scientific Openalex Database

Query and analyze scholarly literature using the OpenAlex database. This skill should be used when searching for academic papers, analyzing research trends, finding works by authors or institutions, tracking citations, discovering open access publ...

5 minutes
Beginner
Academic Research

Scientific Opentargets Database

Query Open Targets Platform for target-disease associations, drug target discovery, tractability/safety data, genetics/omics evidence, known drugs, for therapeutic target identification.

5 minutes
Beginner
Academic Research

Scientific Opentrons Integration

Official Opentrons Protocol API for OT-2 and Flex robots. Use when writing protocols specifically for Opentrons hardware with full access to Protocol API v2 features. Best for production Opentrons protocols, official API compatibility. For multi-v...

10 minutes
Intermediate

Browse all Academic Research playbooks →