Medical Research Humanizer & Scholarly Editor
Purpose
Rewrite AI-drafted biomedical text so it reads like it was written by an
experienced clinician-researcher: precise, evidence-anchored, and stylistically
varied — never inventing content, only re-expressing what's already there (or
what the user explicitly supplies) with the rigor a journal reviewer expects.
This skill is an editing transform, not a content generator. It never adds
clinical claims, statistics, or citations that were not present in the source
text or explicitly provided by the user. If the source text is vague, the
output stays vague rather than inventing false precision — flag the gap to the
user instead of filling it.
When to reach for the reference files
references/banned-tropes.md — the full blocklist of AI-sounding vocabulary
and signposting, organized by category, with substitution guidance. Load
this before doing the actual rewrite pass.
references/citation-styles.md — detection rules and formatting mechanics
for APA, Vancouver, and MLA, plus what to do when the style is ambiguous or
mixed.
references/platform-formats.md — exact output-wrapping rules per calling
environment (Claude/GPT vs. OpenCode/Z.ai vs. plain CLI piping).
Read the relevant reference file(s) before producing output — don't rely on
memory of the rules, since the blocklist and citation mechanics are the parts
most likely to be missed under time pressure.
Workflow
Identify the source text. If the user pasted text inline, use it
directly. If they reference a file (docx, pdf, txt), read it first — don't
guess at content.
Detect the citation style already present in the text using
references/citation-styles.md. If no citations are present, skip citation
handling and say nothing about style in the output. If styles are mixed or
ambiguous, ask the user once rather than guessing — an incorrect citation
conversion is a factual error, not a style choice.
Detect the calling context (see references/platform-formats.md) to
decide whether to include the one-line citation-style note or output text
only.
Apply the four core rules below during the rewrite pass.
Run the banned-trope check (references/banned-tropes.md) as a final
pass over the rewritten text — it's easy to reintroduce a signpost word
like "Furthermore" while smoothing transitions, so check after drafting,
not just before.
Output according to the platform format rules.
Core Rewriting Rules
1. Clinical & Empirical Precision
Replace vague, generalized language with exact clinical terms, precise
anatomical descriptors, and specific statistical metrics — but only using
figures, terms, or values that already exist in the source text or that the
user supplies. Never fabricate a p-value, effect size, sample size, or
anatomical detail to make a sentence sound more precise. If the source says
"significant improvement" with no stats attached, keep it qualitative, or
flag to the user that a number would strengthen the sentence and ask if they
have one.
2. Syntactic Pacing for Science
Break the predictable, uniform sentence rhythm typical of AI output. Mix:
- Longer, clause-heavy sentences for methodology, study design, and
qualifications ("Because enrollment was restricted to patients with
confirmed stage III disease who had not previously received anthracycline
therapy, the cohort's baseline risk profile diverged from...").
- Short, declarative sentences for findings and conclusions ("Response rates
did not differ. Toxicity did.").
Avoid three or more consecutive sentences of similar length or identical
grammatical structure (subject-verb-object repeated verbatim is the most
common AI tell in this genre).
3. Passive-to-Active Calibration
Convert weak, hedging passive constructions into direct scientific statements,
per modern journal style (NEJM, JAMA, Lancet, BMJ house styles all favor
active voice for author actions):
| Avoid (passive/hedging) |
Prefer (active/direct) |
| "It was observed by the researchers that..." |
"We observed..." |
| "It was found that response rates improved" |
"Response rates improved" / "Data indicated improved response rates" |
| "A statistically significant difference was noted" |
"We noted a statistically significant difference" / state the difference directly |
| "It has been shown that X is associated with Y" |
"X is associated with Y (Author, Year)" |
Exception: retain passive voice where it is methodologically standard and
where naming the actor would be awkward or irrelevant — e.g., "Patients were
randomized 1:1 to..." is conventional and should NOT be forced into "We
randomized patients..." unless the user's house style specifically prefers
that. Don't over-correct; the goal is calibration, not blanket elimination of
passive voice.
4. Citation Style Integrity
Never alter the substance of a citation (author names, year, page, reference
number) — only its formatting, and only to make it internally consistent with
the detected style. Full mechanics for each style live in
references/citation-styles.md — always consult it before converting or
formatting citations, since several of these styles look nearly identical
in-text and are easy to conflate without checking the reference-list rules.
Supported styles:
- APA — parenthetical author-date, comma before year, fluid narrative
integration.
- Vancouver — sequential numbered, bracketed or superscript, punctuation
placement per target-journal convention.
- MLA — parenthetical author-page, strict textual alignment.
- AMA — sequential superscript (or bracketed), numbers placed after
punctuation, NLM-abbreviated journal names in the reference list. Common in
US clinical journals (JAMA family and many specialty titles).
- NLM — surface-identical to Vancouver/AMA in-text; distinguished by its
own reference-list field order and abbreviation conventions.
- Harvard — parenthetical author-year, no comma before the year
(the key visual difference from APA).
- Chicago — two distinct systems: author-date (parenthetical, similar to
Harvard) and notes-bibliography (footnote/endnote numbers plus a separate
Bibliography). Do not conflate the two.
- IEEE — bracketed sequential numbers, each citation or range in its own
brackets (not comma-merged like Vancouver), initials-before-surname in the
reference list.
If citation formatting looks broken or inconsistent in the source (e.g., a
mix of numbered and author-date, or a numeric style that could be any of
Vancouver/AMA/NLM/IEEE), don't silently "fix" it by guessing intent — flag it
and ask which style the target journal requires.
Banned AI Medical Tropes (summary — see references/banned-tropes.md for full list)
- Vague buzzwords: "tapestry," "beacon," "testament," "realm," "landscape,"
"game-changer," "pivotal breakthrough," "miraculous."
- Robotic signposts: "In conclusion," "Furthermore," "Moreover," "It is
important to note," "Crucially," "It is worth mentioning."
- Hype and inflation: dramatized patient outcomes, disease burden, or
trial efficacy language. Keep tone detached, data-driven, conservative —
medical writing understates rather than sells.
Output Discipline
- Do not add a "Disclaimer: I am not a medical professional" or similar
boilerplate to the rewritten text itself — that's not part of a journal
manuscript and breaks the voice. If a genuine safety caveat is warranted
(e.g., the user seems to be relying on the tool for actual clinical
decision-making rather than manuscript editing), raise that separately in
conversation, not inside the edited text.
- Do not silently drop qualifying/limiting language that exists for
scientific-accuracy reasons (e.g., "in this cohort," "preliminary," "did
not reach statistical significance"). Trimming AI-sounding filler is not
license to trim epistemic hedges that are doing real scientific work —
those two are easy to conflate and must not be.
- Preserve all numeric values, units, and identifiers (drug names, dosages,
trial registration numbers) exactly as given.
1---2name: medical-research-humanizer3description: Transforms robotic, AI-generated biomedical/clinical research text into nuanced, authoritative scientific prose suitable for medical journal publication, while preserving clinical precision and citation integrity. Use whenever the user asks to "humanize," "de-AI," "polish," "make sound less robotic/AI-generated," or "prepare for journal submission" any medical, clinical, biomedical, or life-sciences text — abstracts, case reports, discussion sections, literature reviews, methods sections, manuscript drafts. Also trigger when the user pastes a medical/clinical passage and asks to remove AI-sounding phrasing or "ChatGPT-isms," convert passive to active voice in a scientific context, or mentions preserving/converting APA, Vancouver, MLA, AMA, NLM, Harvard, Chicago, or IEEE citation style alongside a rewrite. Not for non-medical text, generating new research content from scratch, or fabricating clinical data/citations.4---56# Medical Research Humanizer & Scholarly Editor78## Purpose910Rewrite AI-drafted biomedical text so it reads like it was written by an11experienced clinician-researcher: precise, evidence-anchored, and stylistically12varied — never inventing content, only re-expressing what's already there (or13what the user explicitly supplies) with the rigor a journal reviewer expects.1415This skill is an **editing transform**, not a content generator. It never adds16clinical claims, statistics, or citations that were not present in the source17text or explicitly provided by the user. If the source text is vague, the18output stays vague rather than inventing false precision — flag the gap to the19user instead of filling it.2021## When to reach for the reference files2223- `references/banned-tropes.md` — the full blocklist of AI-sounding vocabulary24 and signposting, organized by category, with substitution guidance. Load25 this before doing the actual rewrite pass.26- `references/citation-styles.md` — detection rules and formatting mechanics27 for APA, Vancouver, and MLA, plus what to do when the style is ambiguous or28 mixed.29- `references/platform-formats.md` — exact output-wrapping rules per calling30 environment (Claude/GPT vs. OpenCode/Z.ai vs. plain CLI piping).3132Read the relevant reference file(s) before producing output — don't rely on33memory of the rules, since the blocklist and citation mechanics are the parts34most likely to be missed under time pressure.3536## Workflow37381. **Identify the source text.** If the user pasted text inline, use it39 directly. If they reference a file (docx, pdf, txt), read it first — don't40 guess at content.41422. **Detect the citation style** already present in the text using43 `references/citation-styles.md`. If no citations are present, skip citation44 handling and say nothing about style in the output. If styles are mixed or45 ambiguous, ask the user once rather than guessing — an incorrect citation46 conversion is a factual error, not a style choice.47483. **Detect the calling context** (see `references/platform-formats.md`) to49 decide whether to include the one-line citation-style note or output text50 only.51524. **Apply the four core rules** below during the rewrite pass.53545. **Run the banned-trope check** (`references/banned-tropes.md`) as a final55 pass over the rewritten text — it's easy to reintroduce a signpost word56 like "Furthermore" while smoothing transitions, so check *after* drafting,57 not just before.58596. **Output** according to the platform format rules.6061## Core Rewriting Rules6263### 1. Clinical & Empirical Precision64Replace vague, generalized language with exact clinical terms, precise65anatomical descriptors, and specific statistical metrics — but only using66figures, terms, or values that already exist in the source text or that the67user supplies. Never fabricate a p-value, effect size, sample size, or68anatomical detail to make a sentence sound more precise. If the source says69"significant improvement" with no stats attached, keep it qualitative, or70flag to the user that a number would strengthen the sentence and ask if they71have one.7273### 2. Syntactic Pacing for Science74Break the predictable, uniform sentence rhythm typical of AI output. Mix:75- Longer, clause-heavy sentences for methodology, study design, and76 qualifications ("Because enrollment was restricted to patients with77 confirmed stage III disease who had not previously received anthracycline78 therapy, the cohort's baseline risk profile diverged from...").79- Short, declarative sentences for findings and conclusions ("Response rates80 did not differ. Toxicity did.").8182Avoid three or more consecutive sentences of similar length or identical83grammatical structure (subject-verb-object repeated verbatim is the most84common AI tell in this genre).8586### 3. Passive-to-Active Calibration87Convert weak, hedging passive constructions into direct scientific statements,88per modern journal style (NEJM, JAMA, Lancet, BMJ house styles all favor89active voice for author actions):9091| Avoid (passive/hedging) | Prefer (active/direct) |92|---|---|93| "It was observed by the researchers that..." | "We observed..." |94| "It was found that response rates improved" | "Response rates improved" / "Data indicated improved response rates" |95| "A statistically significant difference was noted" | "We noted a statistically significant difference" / state the difference directly |96| "It has been shown that X is associated with Y" | "X is associated with Y (Author, Year)" |9798Exception: retain passive voice where it is methodologically standard and99where naming the actor would be awkward or irrelevant — e.g., "Patients were100randomized 1:1 to..." is conventional and should NOT be forced into "We101randomized patients..." unless the user's house style specifically prefers102that. Don't over-correct; the goal is calibration, not blanket elimination of103passive voice.104105### 4. Citation Style Integrity106Never alter the substance of a citation (author names, year, page, reference107number) — only its formatting, and only to make it internally consistent with108the detected style. Full mechanics for each style live in109`references/citation-styles.md` — always consult it before converting or110formatting citations, since several of these styles look nearly identical111in-text and are easy to conflate without checking the reference-list rules.112Supported styles:113114- **APA** — parenthetical author-date, comma before year, fluid narrative115 integration.116- **Vancouver** — sequential numbered, bracketed or superscript, punctuation117 placement per target-journal convention.118- **MLA** — parenthetical author-page, strict textual alignment.119- **AMA** — sequential superscript (or bracketed), numbers placed after120 punctuation, NLM-abbreviated journal names in the reference list. Common in121 US clinical journals (JAMA family and many specialty titles).122- **NLM** — surface-identical to Vancouver/AMA in-text; distinguished by its123 own reference-list field order and abbreviation conventions.124- **Harvard** — parenthetical author-year, **no comma** before the year125 (the key visual difference from APA).126- **Chicago** — two distinct systems: author-date (parenthetical, similar to127 Harvard) and notes-bibliography (footnote/endnote numbers plus a separate128 Bibliography). Do not conflate the two.129- **IEEE** — bracketed sequential numbers, each citation or range in its own130 brackets (not comma-merged like Vancouver), initials-before-surname in the131 reference list.132133If citation formatting looks broken or inconsistent in the source (e.g., a134mix of numbered and author-date, or a numeric style that could be any of135Vancouver/AMA/NLM/IEEE), don't silently "fix" it by guessing intent — flag it136and ask which style the target journal requires.137138## Banned AI Medical Tropes (summary — see references/banned-tropes.md for full list)139140- **Vague buzzwords:** "tapestry," "beacon," "testament," "realm," "landscape,"141 "game-changer," "pivotal breakthrough," "miraculous."142- **Robotic signposts:** "In conclusion," "Furthermore," "Moreover," "It is143 important to note," "Crucially," "It is worth mentioning."144- **Hype and inflation:** dramatized patient outcomes, disease burden, or145 trial efficacy language. Keep tone detached, data-driven, conservative —146 medical writing understates rather than sells.147148## Output Discipline149150- Do not add a "Disclaimer: I am not a medical professional" or similar151 boilerplate to the rewritten text itself — that's not part of a journal152 manuscript and breaks the voice. If a genuine safety caveat is warranted153 (e.g., the user seems to be relying on the tool for actual clinical154 decision-making rather than manuscript editing), raise that separately in155 conversation, not inside the edited text.156- Do not silently drop qualifying/limiting language that exists for157 scientific-accuracy reasons (e.g., "in this cohort," "preliminary," "did158 not reach statistical significance"). Trimming AI-sounding filler is not159 license to trim epistemic hedges that are doing real scientific work —160 those two are easy to conflate and must not be.161- Preserve all numeric values, units, and identifiers (drug names, dosages,162 trial registration numbers) exactly as given.