Home
cd ../playbooks
Academic ResearchBeginner

Scholarly Writing Refiner

Polish academic English at the sentence level — a five-dimension review (grammar, word choice, voice, coherence, sentence structure) with concrete before/after tables for colloquial-to-academic substitutions, active/passive voice selection by scenario, transition-signal words by logical relationship, and section-specific tense and structure conventions for the Abstract and Introduction.

5 minutes
By zebbern (claude-code-guide)Source
#academic-writing#english-editing#manuscript-editing#esl-writing#grammar

'It was found by us that the results were improved by the method' technically says the same thing as 'we found that our method improved the results' — but only one of them is what a journal reviewer expects from academic prose, and the difference is a specific, teachable set of voice, word-choice, and sentence-structure rules, not vague 'make it sound more academic' feedback.

Who it's for: non-native English speakers polishing a manuscript for journal submission, graduate students revising a thesis chapter for academic tone, researchers who know their content is sound but want the prose to read as native-level academic English, anyone who needs grammar and word-choice feedback specific to scientific writing conventions rather than general copyediting

Example

"Polish this Introduction paragraph for a journal submission" → Each of the five dimensions checked independently (subject-verb agreement, colloquial word choices swapped for academic register, passive voice applied where the action's object matters more than the actor, transition signal words corrected where 'Furthermore' was used to express contrast instead of 'However'), with the polished text delivered alongside a list of what changed and why

CLAUDE.md Template

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

# Scholarly Writing Refiner

Polish academic English paragraph by paragraph — grammar, word choice, voice, coherence, and sentence structure — according to international academic journal standards. Output revision suggestions alongside the polished text. Use for manuscript editing, journal submission editing, thesis/dissertation polishing, and "make this paragraph sound more academic" requests.

## Quick Start

Provide: the text to polish, and optionally the paper type (journal article / conference paper / thesis / review), the target journal or field (Nature, IEEE, AAAI, a specific field), and the polishing focus (comprehensive / grammar only / word choice only / coherence only).

## Review Dimensions

Polishing runs across five independently-rated dimensions: **Grammar** (subject-verb agreement, tense, articles, prepositions, clause structure, punctuation), **Word Choice** (academic register, precision, collocation, avoiding colloquialisms), **Voice** (active/passive selection, tense consistency), **Coherence & Cohesion** (transitions within and between paragraphs, the argumentation chain, signal words), and **Sentence Structure** (variety, balance of long and short sentences, coordination and subordination).

## Grammar Review

### Common Errors Checklist

| Error Type | Incorrect | Correction | Why |
|---|---|---|---|
| Subject-verb disagreement | "The results of the experiment **shows**..." | "...**show**..." | Subject is "results" (plural) |
| Missing/misused article | "We propose **method** to solve..." | "We propose **a method** to solve..." | Singular countable nouns need an article |
| Dangling modifier | "**Using the proposed method,** the accuracy was improved." | "**Using the proposed method, we** improved the accuracy." | The implied subject must match the main clause's subject |
| Run-on sentence | "The model performs well**,** it achieves 95% accuracy." | "...well**;** it achieves..." or split into two sentences | A comma can't join two independent clauses |
| Incomplete comparison | "Our method is **more efficient**." | "...more efficient **than the baseline**." | Comparatives need an explicit object |
| Broken parallelism | "The system can **detect, classify,** and **is able to segment**..." | "...**detect, classify, and segment**..." | Coordinated elements need the same grammatical form |
| that/which confusion | "The model **which** we proposed..." | "The model **that** we proposed..." | Restrictive relative clauses use "that" |
| Irregular plurals | "These **phenomenon** indicate..." | "These **phenomena** indicate..." | Watch for irregular plural forms |

### Punctuation

- **Serial (Oxford) comma**: "A, B, and C" — recommended in academic writing.
- **Em dash**: consistent spacing per the target journal's style.
- **Capitalization after a colon**: capitalize only if a complete sentence follows.
- **Quotation marks and periods**: American style puts the period inside quotes; British style outside — match the target journal's regional convention.
- **Abbreviation periods**: "e.g.," / "i.e.," / "et al." — note the required comma.

### Tense by Section

| Section | Tense | Example |
|---|---|---|
| Abstract | Past (what was done) + present (conclusions) | "We **proposed** a method... The results **show** that..." |
| Introduction | Present (current consensus) + past (prior work) | "Deep learning **has become**... Smith et al. **demonstrated** that..." |
| Methods | Past | "We **trained** the model on... The data **were** preprocessed..." |
| Results | Past | "The model **achieved** 95% accuracy. Table 2 **shows**..." |
| Discussion | Present (interpretation) + past (citing results) | "This result **suggests** that... Our findings **indicated** that..." |
| Conclusion | Past (summary) + present (contribution/significance) | "We **proposed** and **evaluated**... This work **contributes** to..." |

## Word Choice

**Colloquial → academic**: "a lot of" → numerous/a substantial number of; "get" → obtain/acquire/achieve; "show" → demonstrate/illustrate/indicate/reveal (pick by nuance — demonstrate emphasizes proof, indicate emphasizes suggestion); "big/huge" → substantial/significant; "use" → employ/utilize/leverage/adopt; "try" → attempt; "look at" → examine/investigate/analyze; "find out" → determine/identify; "point out" → highlight/emphasize; "deal with" → address/tackle/mitigate; "make sure" → ensure/verify; "need" → require/necessitate. Don't over-substitute — "can" is acceptable in academic writing as-is.

**Vague → precise**: "very good results" → the actual statistic ("a 12% increase in accuracy"); "some researchers" → the actual citations; "recently" → an actual time range ("since 2020"); "a few" → the actual count ("n=3"); "it is known that" → "Prior work has established that (citation)"; "this is important" → state *why* it matters.

**Reducing redundancy**: "in order to" → "to"; "due to the fact that" → "because"; "it is worth noting that" → "Notably," or delete; "the vast majority of" → "most"; "has the ability to" → "can"; "take into consideration" → "consider"; "is in agreement with" → "agrees with."

## Voice

| Scenario | Recommended Voice | Example |
|---|---|---|
| Describing the authors' actions | Active ("We") | "**We** trained the model using..." |
| Describing general methods/established facts | Passive | "The data **were** collected from..." |
| Emphasizing the object of an action | Passive | "The samples **were analyzed** using mass spectrometry." |
| Reporting results | Prefer active | "**Our method achieves** 95% accuracy." |
| Describing equipment/materials | Passive | "The solution **was heated** to 100°C." |

**Common voice issues**: overuse of passive ("It was found by us that the results were improved by the method" → "We found that our method improved the results"); inconsistent person across the paper (pick "We" or "The authors" and stay consistent); meaningless passive ("It can be seen that accuracy increases" → "Accuracy increases").

**Person conventions**: "We" is the most common choice, accepted by many journals even for single-author papers; "The authors" is a more formal alternative some journals prefer; "I" is used in single-author theses/dissertations (not accepted everywhere); "One" is generic/hypothetical and reads as somewhat old-fashioned.

## Coherence and Cohesion

**Intra-paragraph signal words by relationship**: Addition (furthermore, moreover, additionally); Contrast (however, in contrast, conversely, nevertheless); Cause & Effect (therefore, consequently, as a result, hence); Exemplification (for example, specifically, in particular); Emphasis (indeed, notably, importantly); Concession (although, despite, while); Summary (in summary, overall); Sequence (first, subsequently, then); Condition (if, provided that, given that).

**Inter-paragraph transition patterns**: Hook (the end of one paragraph raises the question the next answers); Recap ("Having established X, we now turn to..."); Contrast Bridge ("While these methods achieve reasonable accuracy, they fail to address..."); Question Bridge ("How can we overcome this limitation? In this section..."); Topic Sentence (the first sentence of each paragraph states its core argument).

**Common coherence problems**: jumping argumentation (leaping from A to C without the B step — add the missing reasoning); signal-word overuse (starting every sentence with "However"/"Moreover" — reduce and let sentence structure carry the logic instead); signal-word misuse (using "Furthermore" to express contrast instead of "However"); overly long paragraphs (past 8–10 sentences — split by argument point); overly short paragraphs (1–2 sentences — merge or expand); unclear reference ("This shows..." — say what "this" is: "This result shows...").

## Sentence Structure

**Variety strategies**: participial-phrase opening ("We use attention, and we improve accuracy" → "Leveraging attention, we improve accuracy"); inversion for emphasis; appositive insertion ("The model, which was proposed by Smith, achieves..." → "The model, proposed by Smith (2023), achieves..."); nominalization for a completed action as a subject; parallel structure for a list of properties ("The method is fast. It is also accurate. It is scalable too." → "The method is fast, accurate, and scalable"); fronted adverbial.

**Problems to avoid**: sentences over ~40 words (split into 2–3); several consecutive short, choppy sentences (combine into one with the right subordination); starting with "There is/are" ("There are many studies that focus on..." → "Many studies focus on..."); overusing "It is...that" cleft sentences; noun pile-ups ("deep learning image classification model performance" → "the performance of a deep learning model for image classification").

## Section-Specific Polishing

**Abstract** — typically 150–300 words (follow the target journal); structure: background (1–2 sentences) → problem/motivation (1 sentence) → method (2–3 sentences) → results (1–2 sentences) → significance (1 sentence). Past tense for describing the work, present tense for conclusions. No citations, no undefined abbreviations, no figure/table numbers.

**Introduction** — the classic funnel: broad context → specific problem → existing methods and their limitations → proposed method/contributions → paper outline. Every paragraph needs a clear topic sentence; stay objective reviewing prior work, never disparaging. Common openers: "In recent years, ... has attracted increasing attention." / "Despite significant progress, ... remains a challenge." / "To address this issue, we propose..."

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

A sentence-level academic English editor that reviews across five independently-rated dimensions — grammar, word choice, voice, coherence/cohesion, and sentence structure — each backed by a concrete before/after table rather than general advice to "sound more academic." The grammar section catches specific, common errors (subject-verb disagreement on collective nouns, dangling modifiers, broken parallelism, "that" vs. "which") with a correction and a one-line reason for each; the word-choice section maps dozens of colloquial phrases ("a lot of," "get," "deal with") to their academic equivalents while explicitly warning against over-substitution ("can" doesn't need replacing); and a full tense-by-section table specifies exactly when a paper should shift from past tense (describing what was done) to present tense (stating a conclusion) across the Abstract, Introduction, Methods, Results, Discussion, and Conclusion.

The voice and coherence sections are where it goes beyond a basic grammar check: a scenario table specifies exactly when active voice belongs ("We trained the model," describing the authors' own actions) versus passive ("The samples were analyzed," emphasizing the object of an action), and a signal-words table maps each logical relationship — addition, contrast, cause-and-effect, concession, exemplification — to its correct transition word, catching the common mistake of using "Furthermore" where the sentence actually expresses a contrast that needs "However." Sentence-structure guidance covers concrete fixes for run-on academic sentences (past ~40 words, split), noun pile-ups, and starting sentences with "There is/are," rounding out with section-specific structural conventions for the Abstract (a five-part funnel in ~150–300 words) and Introduction (broad context → specific problem → limitations of existing work → contribution → outline).


Quick Start

Step 1: Create a Project Folder

mkdir scholarly-refiner && cd scholarly-refiner

Step 2: Download the Template

Click Download above, then:

mv ~/Downloads/CLAUDE.md ./

Step 3: Polish a Paragraph

claude

Paste a paragraph or section you're revising for journal submission, optionally noting the paper type and target venue. Claude will review across the five dimensions and return polished text alongside the specific changes made and why.


Tips & Best Practices

  • Specify the target journal or field when you have one — regional punctuation conventions (American vs. British quotation-mark placement) and formality expectations vary enough between venues that this changes real decisions.
  • Don't over-apply the colloquial-to-academic substitutions — the guide itself flags "can" as acceptable as-is; blanket-replacing every simple verb with a longer Latinate one produces stiff, over-formal prose rather than better academic writing.
  • Use the coherence section specifically when a reviewer or advisor says a section "doesn't flow" — the jumping-argumentation and signal-word-misuse diagnoses name the actual structural problem instead of leaving you to guess what "doesn't flow" means.

Limitations

  • A sentence- and paragraph-level polish, not a structural or claim-evidence review — pairing it with a structural editing pass (checking whether the paper's overall argument and evidence hold together) covers a different, complementary layer.
  • Section-specific conventions (abstract length, tense patterns) are general academic norms; always defer to a specific target journal's actual author guidelines where they differ.
  • Voice and tense guidance reflects general STEM/social-science academic convention; some fields (humanities, certain qualitative research traditions) have different, sometimes contrary, stylistic norms.

$Related Playbooks

Academic Research

Scientific Adaptyv

Cloud laboratory platform for automated protein testing and validation. Use when designing proteins and needing experimental validation including binding assays, expression testing, thermostability measurements, enzyme activity assays, or protein ...

10 minutes
Intermediate
Academic Research

Scientific Alphafold Database

Access AlphaFold 200M+ AI-predicted protein structures. Retrieve structures by UniProt ID, download PDB/mmCIF files, analyze confidence metrics (pLDDT, PAE), for drug discovery and structural biology.

10 minutes
Intermediate
Academic Research

Scientific Anndata

Data structure for annotated matrices in single-cell analysis. Use when working with .h5ad files or integrating with the scverse ecosystem. This is the data format skill—for analysis workflows use scanpy; for probabilistic models use scvi-tools; f...

10 minutes
Intermediate
Academic Research

Scientific Arboreto

Infer gene regulatory networks (GRNs) from gene expression data using scalable algorithms (GRNBoost2, GENIE3). Use when analyzing transcriptomics data (bulk RNA-seq, single-cell RNA-seq) to identify transcription factor-target gene relationships a...

10 minutes
Intermediate
Academic Research

Scientific Benchling Integration

Benchling R&D platform integration. Access registry (DNA, proteins), inventory, ELN entries, workflows via API, build Benchling Apps, query Data Warehouse, for lab data management automation.

10 minutes
Intermediate
Academic Research

Scientific Bindingdb Database

Query BindingDB for measured drug-target binding affinities (Ki, Kd, IC50, EC50). Search by target (UniProt ID), compound (SMILES/name), or pathogen. Essential for drug discovery, lead optimization, polypharmacology analysis, and structure-activit...

5 minutes
Beginner
Academic Research

Scientific Biopython

Comprehensive molecular biology toolkit. Use for sequence manipulation, file parsing (FASTA/GenBank/PDB), phylogenetics, and programmatic NCBI/PubMed access (Bio.Entrez). Best for batch processing, custom bioinformatics pipelines, BLAST automation...

10 minutes
Intermediate
Academic Research

Scientific Biorxiv Database

Efficient database search tool for bioRxiv preprint server. Use this skill when searching for life sciences preprints by keywords, authors, date ranges, or categories, retrieving paper metadata, downloading PDFs, or conducting literature reviews.

5 minutes
Beginner
Academic Research

Scientific Bioservices

Unified Python interface to 40+ bioinformatics services. Use when querying multiple databases (UniProt, KEGG, ChEMBL, Reactome) in a single workflow with consistent API. Best for cross-database analysis, ID mapping across services. For quick singl...

10 minutes
Intermediate
Academic Research

Scientific Brenda Database

Access BRENDA enzyme database via SOAP API. Retrieve kinetic parameters (Km, kcat), reaction equations, organism data, and substrate-specific enzyme information for biochemical research and metabolic pathway analysis.

5 minutes
Beginner
Academic Research

Scientific Cbioportal Database

Query cBioPortal for cancer genomics data including somatic mutations, copy number alterations, gene expression, and survival data across hundreds of cancer studies. Essential for cancer target validation, oncogene/tumor suppressor analysis, and p...

5 minutes
Beginner
Academic Research

Scientific Cellxgene Census

Query the CELLxGENE Census (61M+ cells) programmatically. Use when you need expression data across tissues, diseases, or cell types from the largest curated single-cell atlas. Best for population-scale queries, reference atlas comparisons. For ana...

10 minutes
Intermediate

Browse all Academic Research playbooks →