The standard

What Clean Language actually says.

Clean Language produces writing that reads as deliberate, technically competent, and written by a capable practitioner rather than generated from a generic communications template. These pages are the standard itself. You do not need to read them to use the skill, but they are here if you want to see exactly how it works.

This is the actual guidance the skill uses. This page mirrors the skill's entry point. Read the exact source, SKILL.md, on GitHub.

The precedence order

When rules compete, the earlier rule wins. Style never overrides meaning.

  1. Preserve factual, technical, legal, contractual, policy, and semantic accuracy.
  2. Preserve the user's explicit audience, purpose, tone, length, and format constraints.
  3. Preserve names, dates, figures, commitments, qualifications, and domain terminology.
  4. Improve organization, clarity, directness, density, and natural cadence.
  5. Remove generic AI-writing patterns only when doing so does not conflict with rules 1 through 4.

Never sacrifice correctness to satisfy a stylistic heuristic.

Operating modes

DraftCreate finished prose from notes or an objective.
RewriteReplace supplied prose while preserving meaning and material details.
ProofreadCorrect grammar, spelling, punctuation, and obvious ambiguity with minimal stylistic change.
AuditIdentify language defects and explain recommended changes without rewriting unless requested.
AdaptRework the same content for a different audience, channel, formality level, or length.

The core style

  • Lead with the answer, decision, request, finding, or action.
  • Write concise, information-dense prose.
  • Prefer a direct subject and verb to an abstract-noun frame: write "I am interested in X", not "My main areas of interest are X".
  • Use clear headings, bullets, and tables only when they improve comprehension.
  • Use Oxford English and -ize spellings where both forms are valid, and the Oxford comma where it prevents ambiguity.
  • Use active voice when ownership or accountability matters, and passive voice when the actor is unknown, immaterial, confidential, or less important than the affected object.
  • Distinguish verified facts, reasonable inferences, estimates, and speculation, and state uncertainty directly.
  • Preserve the writer's natural bluntness when it remains professionally appropriate; when they supply a draft or a correction, keep their voice rather than a generic executive register.
  • Do not add praise, reassurance, or filler, and do not end with an optional offer or generic engagement prompt.

What it removes

Generic AI-writing patterns, treated as diagnostic signals rather than unconditional bans:

  • throat-clearing before the substantive point;
  • vague declarations of importance;
  • formulaic negative-to-positive contrasts;
  • manufactured punch lines and dramatic fragments;
  • repetitive three-part rhetorical structures used without substantive need;
  • meta-commentary about what the document will do;
  • empty intensifiers, softeners, and business jargon;
  • formulaic executive phrasing used as default connection or emphasis, and catalogue-style topic lists;
  • excessive em dashes;
  • abstract claims that conceal the actor, evidence, consequence, or required action.

The full catalogue, with examples, is on the AI Patterns page.

What it preserves

Clean Language does not mechanically delete language that carries meaning:

  • adverbs that convey method, timing, scope, legal effect, technical behaviour, or operational significance;
  • passive constructions required by legal, audit, incident, scientific, or standards writing;
  • three-item lists that accurately represent three distinct items;
  • absolute terms such as must, never, always, or prohibited when they express a verified requirement or invariant;
  • technical subjects that genuinely perform actions, such as a firewall blocking traffic;
  • domain-specific jargon that the intended audience uses precisely;
  • quoted language, official titles, product names, standards text, or contractual wording;
  • the separator in a numeric or date range: an en dash becomes a hyphen or the word "to" (12-14, or 12 to 14), never deleted or merged.

Match the context

The standard adapts to the channel and document type, from executive communication to incident reports, email, and governance material. See the By Channel page for the specific rules.

Check the result

Before finished prose is delivered, it is checked against the quality criteria. See the Checklist, and the before-and-after examples for the degree of intervention.

Install Clean Language