Before and after
How far the standard intervenes
Note
This is the actual guidance the skill uses. Every pair on this page is generated from the skill’s example set. Read the exact source, examples.md, on GitHub (opens in a new tab).
Example 1
Lead with the conclusion
Before
It is worth noting that there are several areas where the current implementation could create challenges: unclear ownership, no rollback procedure, and an untested recovery path.
After
The current implementation has 3 unresolved points: unclear ownership, no rollback procedure, and an untested recovery path.
The hedge goes and the count leads. All 3 points survive unchanged.
Example 2
Delete the framing
Prefer deleting a framing phrase to replacing it with another. The facts already in the draft carry the message.
Before
I wanted to take a moment to flag that the vendor contract expires on 31 March.
After
The vendor contract expires on 31 March.
Before
As we navigate today's fast-moving threat landscape, the firewall rules have not been reviewed since January.
After
The firewall rules have not been reviewed since January.
Before
This section outlines the 3 issues we found: missing backups, an expired certificate, and an open admin port.
After
We found 3 issues: missing backups, an expired certificate, and an open admin port.
Example 3
Remove artificial balance
Before
The team has been working hard, but the process still lacks an accountable owner, an approval gate, and tested recovery.
After
The process lacks an accountable owner, an approval gate, and tested recovery.
Add progress or mitigating evidence only when it changes the assessment; a specific, material gain is a fact and stays.
Example 4
Preserve technical agency
Source
After the change review, the infrastructure team configured the firewall to block inbound connections from untrusted networks and confirmed that the firewall now blocks them.
Preferred when the configuration is the relevant fact
The firewall blocks inbound connections from untrusted networks.
Preferred when accountability is the relevant fact
The infrastructure team made that firewall change.
Either fact can lead, depending on which one matters.
Example 5
Preserve useful adverbs
Weak modifier
The system is extremely unreliable.
Preferred, when data supports it
The service dropped 14 percent of requests during the test window.
Use the specific figure only when the source or a measurement provides it; otherwise keep the statement qualitative and flag the missing measurement.
Legitimate modifier
The encryption keys are cryptographically isolated from the application workload.
Example 6
Executive request
Before
I wanted to reach out to see if we could align on the warehouse project: the owner, the critical path, the unresolved dependencies, and the recovery plan, before Thursday at 3 p.m.
After
Please confirm the warehouse project's owner, critical path, unresolved dependencies, and recovery plan before 3:00 p.m. Thursday.
The ask becomes explicit and the deadline exact. All 4 items are unchanged.
Example 7
Replace executive template phrasing
Before
The agenda looks highly relevant to my work, particularly the sessions on regulatory interoperability, cyber resilience, and audit readiness.
After
The agenda covers 3 areas I work on: regulatory interoperability, cyber resilience, and audit readiness.
Keep the same topics and state the writer's connection to them, rather than asserting relevance with an intensifier.
Abstract-noun frame
My main areas of interest are AI governance and cybersecurity.
Preferred, as a direct statement
I am interested in AI governance and cybersecurity.
Example 8
Incident status
Before
The situation appears to be under control, and the team is continuing to work diligently: the affected server is isolated, file transfers resumed at 06:40, the root cause is not yet confirmed, and the legacy environment still requires rebuild approval.
After
The affected server is isolated. File transfers resumed at 06:40. The root cause is not yet confirmed, and the legacy environment still requires rebuild approval.
The reassurance goes. The 4 facts stay, in the same order.
Example 9
Proofreading with minimal intervention
Source
The vendor have confirmed they will provide there response by Friday and we should be able to review it early next week.
After
The vendor has confirmed that it will respond by Friday. We should be able to review the response early next week.
The source is a flawed draft on purpose. “vendor have” and “there response” are the errors a proofreading pass catches; the corrected version fixes the agreement and rewrites the second as “respond”.
Without that, it reads as the object of confirmed; the inserted that marks it as the subject of a clause.
Do not restructure a proofreading request into an executive rewrite unless clarity requires it.
By channel
The same standard, tuned to the context
Clean Language applies the same precedence order everywhere, then adapts to the channel and document type. The rules for each of the 8 channels cover executive, technical, governance, incident, email, chat, report, and humorous writing.
Try it
Try it on your own writing
Copy a prompt and run it against your own draft, or install the skill so the standard is available in any chat.