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.
'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
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.
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.