Clear, Natural English Editing
Improve the reader's understanding, not a detector score. A good reference can
have repeated terminology, regular tables, definitions and no anecdote.
Keep the user's intended voice and the destination's format.
Facts Are Not Style Material
- Preserve supplied numbers, units, dates, versions, names, citations, negation,
uncertainty and claim scope. Do not silently update a historical date.
- Never invent a count, quote, interview, personal experience, experiment,
failure, comparison or source to make prose more vivid.
- Add specificity only when the supporting evidence supplies it. If no
measurement exists, retain uncertainty or remove an unsupported claim.
An unsupplied number is not an improvement over a vague quantity.
- Label illustrative scenarios as hypothetical. Do not present them as a real
case study or treat their invented values as proof of a product claim.
- Preserve identifiers, executable code and technical obligations. Words such
as may, must, can and will are not interchangeable style alternatives.
- Reuse provided facts without asking the user to repeat them. Research a
material factual gap when research is in scope; otherwise identify the gap
without manufacturing an answer or blocking supported edits.
Match the Genre
| Genre |
Useful editing |
Avoid forcing |
| technical reference |
exact terms, clear conditions, scannable structure |
slang, story openings, rhetorical questions, sales CTA |
| explanation/tutorial |
prerequisites and action/result sequence |
an untested command described as verified |
| analysis |
separate observation, inference and limits |
stronger causal claims than the evidence supports |
| personal narrative |
the author's supplied experiences and voice |
invented first-person testimony |
| marketing |
a supported benefit and relevant next action |
fabricated testimonials, percentages or guarantees |
Contractions, fragments, humour, analogies and direct address are options, not
quotas. Use them when they fit the audience and improve comprehension.
Parallel lists and consistent terminology can be desirable in documentation.
Editing Procedure
- Identify the reader's task, genre, source material and protected facts from
the existing request and draft. Do not add an unnecessary intake questionnaire.
- Remove empty intensifiers and duplicated ideas. Use direct verbs when meaning
is preserved; keep connectors that express real causality or contrast.
- Clarify who acts, on what, under which conditions and with what result.
Do not supply a result that the source does not establish.
- Fix awkward rhythm where it hinders reading. Do not maximize variation,
enforce a paragraph pattern or replace terms to appear less predictable.
- Compare input and output for semantic changes. Check quantities with their
units, denominator, time frame and uncertainty, not just the numeral.
- Return the edited text and any necessary factual caveat. Once the edit is
sufficient, continue the remaining requested publication workflow rather
than starting another stylistic pass automatically.
Examples: Same Facts, Clearer Prose
| Supplied text |
Faithful edit |
| In order to load the file, the user must select Open. |
To load the file, select Open. |
| The tool may reduce processing time; no benchmark is available. |
The tool may save processing time, but no benchmark is available. |
| Some testers reported failures. The sample size was not recorded. |
Some testers reported failures; the sample size was not recorded. |
| On 2026-09-01, 12 of 40 runs failed with version 2.1. |
With version 2.1, 12 of 40 runs failed on 2026-09-01. |
These are editing fixtures, not results from a deployed product. Unknown sample
size stays unknown; a date, denominator and version do not disappear for fluency.
Verification
- Every changed factual assertion still maps to the supplied material or a
source actually checked for this task.
- Conditions, uncertainty, negatives, numbers, units, dates, versions and code
are preserved unless an evidence-backed factual correction was requested.
- The result helps its intended reader without an unrequested genre change.
- No invented testimony or detector-evasion claim was added.
A no-change verdict is valid for an already clear passage. Do not add numbers,
questions, opinions, deliberate errors or fake admissions to satisfy a score.
Gotchas
- Detector score as evidence: it establishes neither authorship nor factual
accuracy. Do not promise an undetectable edit.
- Replacing every vague quantity: guessing a plausible percentage fabricates
evidence when the sample size is unknown.
- Forced informality: slang can make a reference harder to understand,
particularly for readers using English as an additional language.
- Synonym churn: repeating a technical term is safer than creating a false
distinction through alternate names.
- Example contamination: a skill example is not an event that happened to
the user or author.
Troubleshooting
| Symptom |
Check |
Correction |
| polished but unsupported claim |
source scope and conditions |
restore supported meaning or remove the claim |
| bureaucratic phrasing |
action and actor |
use a direct sentence without changing obligations |
| repetitive text |
repeated meaning versus necessary terms |
cut redundancy, keep precise terminology |
| reference sounds like an advertisement |
requested genre |
remove promotion and invented narrative |
| detector flags the passage |
actual writing and detector limitations |
repair evidenced defects, not a guessed authorship score |
Sources and Maintenance
Reviewed 2026-09-06. Owner: the existing writing-skill maintainers. Change through
canonical Git, focused before/after fixtures, independent review and the supported
installer; retain the prior revision and installation backup for rollback.
Refresh sources when guidance changes or a factual/genre regression is observed,
not by automatically rewriting working prose on a schedule.
1---2name: humanize-english3description: Edit English drafts for clear, natural language while preserving facts, uncertainty, technical meaning, citations and genre. Use when: humanize this text, remove AI-style filler, improve English prose, or edit an English article before publication. Not an authorship detector or a promise to bypass one. For Russian use humanize-russian; for thesis/evidence and structure use article-structure-review.4---56# Clear, Natural English Editing78Improve the reader's understanding, not a detector score. A good reference can9have repeated terminology, regular tables, definitions and no anecdote.10Keep the user's intended voice and the destination's format.1112## Facts Are Not Style Material1314- Preserve supplied numbers, units, dates, versions, names, citations, negation,15 uncertainty and claim scope. Do not silently update a historical date.16- Never invent a count, quote, interview, personal experience, experiment,17 failure, comparison or source to make prose more vivid.18- Add specificity only when the supporting evidence supplies it. If no19 measurement exists, retain uncertainty or remove an unsupported claim.20 An unsupplied number is not an improvement over a vague quantity.21- Label illustrative scenarios as hypothetical. Do not present them as a real22 case study or treat their invented values as proof of a product claim.23- Preserve identifiers, executable code and technical obligations. Words such24 as may, must, can and will are not interchangeable style alternatives.25- Reuse provided facts without asking the user to repeat them. Research a26 material factual gap when research is in scope; otherwise identify the gap27 without manufacturing an answer or blocking supported edits.2829## Match the Genre3031| Genre | Useful editing | Avoid forcing |32|---|---|---|33| technical reference | exact terms, clear conditions, scannable structure | slang, story openings, rhetorical questions, sales CTA |34| explanation/tutorial | prerequisites and action/result sequence | an untested command described as verified |35| analysis | separate observation, inference and limits | stronger causal claims than the evidence supports |36| personal narrative | the author's supplied experiences and voice | invented first-person testimony |37| marketing | a supported benefit and relevant next action | fabricated testimonials, percentages or guarantees |3839Contractions, fragments, humour, analogies and direct address are options, not40quotas. Use them when they fit the audience and improve comprehension.41Parallel lists and consistent terminology can be desirable in documentation.4243## Editing Procedure44451. Identify the reader's task, genre, source material and protected facts from46 the existing request and draft. Do not add an unnecessary intake questionnaire.472. Remove empty intensifiers and duplicated ideas. Use direct verbs when meaning48 is preserved; keep connectors that express real causality or contrast.493. Clarify who acts, on what, under which conditions and with what result.50 Do not supply a result that the source does not establish.514. Fix awkward rhythm where it hinders reading. Do not maximize variation,52 enforce a paragraph pattern or replace terms to appear less predictable.535. Compare input and output for semantic changes. Check quantities with their54 units, denominator, time frame and uncertainty, not just the numeral.556. Return the edited text and any necessary factual caveat. Once the edit is56 sufficient, continue the remaining requested publication workflow rather57 than starting another stylistic pass automatically.5859## Examples: Same Facts, Clearer Prose6061| Supplied text | Faithful edit |62|---|---|63| In order to load the file, the user must select Open. | To load the file, select Open. |64| The tool may reduce processing time; no benchmark is available. | The tool may save processing time, but no benchmark is available. |65| Some testers reported failures. The sample size was not recorded. | Some testers reported failures; the sample size was not recorded. |66| On 2026-09-01, 12 of 40 runs failed with version 2.1. | With version 2.1, 12 of 40 runs failed on 2026-09-01. |6768These are editing fixtures, not results from a deployed product. Unknown sample69size stays unknown; a date, denominator and version do not disappear for fluency.7071## Verification7273- Every changed factual assertion still maps to the supplied material or a74 source actually checked for this task.75- Conditions, uncertainty, negatives, numbers, units, dates, versions and code76 are preserved unless an evidence-backed factual correction was requested.77- The result helps its intended reader without an unrequested genre change.78- No invented testimony or detector-evasion claim was added.7980A no-change verdict is valid for an already clear passage. Do not add numbers,81questions, opinions, deliberate errors or fake admissions to satisfy a score.8283## Gotchas8485- **Detector score as evidence:** it establishes neither authorship nor factual86 accuracy. Do not promise an undetectable edit.87- **Replacing every vague quantity:** guessing a plausible percentage fabricates88 evidence when the sample size is unknown.89- **Forced informality:** slang can make a reference harder to understand,90 particularly for readers using English as an additional language.91- **Synonym churn:** repeating a technical term is safer than creating a false92 distinction through alternate names.93- **Example contamination:** a skill example is not an event that happened to94 the user or author.9596## Troubleshooting9798| Symptom | Check | Correction |99|---|---|---|100| polished but unsupported claim | source scope and conditions | restore supported meaning or remove the claim |101| bureaucratic phrasing | action and actor | use a direct sentence without changing obligations |102| repetitive text | repeated meaning versus necessary terms | cut redundancy, keep precise terminology |103| reference sounds like an advertisement | requested genre | remove promotion and invented narrative |104| detector flags the passage | actual writing and detector limitations | repair evidenced defects, not a guessed authorship score |105106## Sources and Maintenance107108Reviewed 2026-09-06. Owner: the existing writing-skill maintainers. Change through109canonical Git, focused before/after fixtures, independent review and the supported110installer; retain the prior revision and installation backup for rollback.111Refresh sources when guidance changes or a factual/genre regression is observed,112not by automatically rewriting working prose on a schedule.113114- [Developer documentation voice and tone](https://developers.google.com/style/tone),115 updated 2026-05-27: clarity and audience matter more than forced informality.116- [GPT detectors are biased against non-native English writers](https://arxiv.org/abs/2304.02819),117 revised 2023-07-10: limitations of the evaluated detectors, not a test of every118 current detector or a guarantee about any individual passage.119- [Excess vocabulary in biomedical publications](https://arxiv.org/abs/2406.07016),120 revised 2025-07-03: corpus-level biomedical analysis, not an individual-author121 test or a prescriptive word blacklist.
AnastasiyaW