Writing
The outcome is text a reader trusts without re-checking: every fact survives
the edit, nothing is invented, and it reads as written by a person who knew the
subject. Australian English, plain and mildly casual by default
(voice.md).
Rules
- Facts don't move. Style passes are where they drift, so lock them first and
audit against the lock.
- Never fabricate experience, sources, detail or fake messiness. Mark each gap
[FLAG: cite source] or [FLAG: verify].
- No em dash (U+2014) in output, examples included. Recast the sentence; a
colon or spaced hyphen that keeps the same pivot moves the tell.
- A supplied voice sample beats these defaults.
- Edit for the reader, never a detector score. Formal prose isn't proof of AI
authorship.
- One term per concept: repeat the precise noun, don't cycle
endpoint,
route and URL for variety.
- Never style-pass gates, ADR decisions, credential custody or literal
runbooks. Edit them by hand, and check whether a test matches their exact
wording first.
Procedure
Pick the lightest pass: repair named defects, rewrite (default) or diagnose
(findings only). If the draft already reads well, say so and touch little.
- Lock facts, numbers, names, quotes, citation keys, defined terms,
modals and negations. List them.
- Diagnose by mechanism (mechanisms.md), not
by phrase. Name the two or three that cost the reader most.
- Rewrite once, restating each claim directly and adding only anchors the
source holds.
- Audit independently. Compare the lock list with the result; revert any
sentence that lost or strengthened a claim. For high-stakes text, a
clean-context reviewer sees only the before and after. For number-heavy
text, script the check (claims.md).
- Report the text first, with notes only for material flags.
provenant check writing PATH flags em dashes and lexical hints. Its silence
is necessary, not sufficient.
References
- voice.md: register, punctuation and Australian
English. Load before any write or rewrite.
- mechanisms.md: the defects, with before/after
pairs.
- claims.md: claim classes, comparatives, number
audit and the condense pass.
- engineering.md: READMEs, PRs, commits, error
text, runbooks, release notes and process-language leaks. Specs and issue
bodies go to
scope and tracker; where a doc lives is engineering-docs.
- academic.md: thesis and paper register, citations,
LaTeX invariants.
1---2name: writing3description: "Use to write or tighten prose, emails, theses, docs, commits, PR bodies and release notes. Not for legal drafting (legal-writing)."4metadata:5 source: https://skillmd.com/skills/mblauberg/writing6---78# Writing910The outcome is text a reader trusts without re-checking: every fact survives11the edit, nothing is invented, and it reads as written by a person who knew the12subject. Australian English, plain and mildly casual by default13([voice.md](references/voice.md)).1415## Rules1617- Facts don't move. Style passes are where they drift, so lock them first and18 audit against the lock.19- Never fabricate experience, sources, detail or fake messiness. Mark each gap20 `[FLAG: cite source]` or `[FLAG: verify]`.21- No em dash (U+2014) in output, examples included. Recast the sentence; a22 colon or spaced hyphen that keeps the same pivot moves the tell.23- A supplied voice sample beats these defaults.24- Edit for the reader, never a detector score. Formal prose isn't proof of AI25 authorship.26- One term per concept: repeat the precise noun, don't cycle `endpoint`,27 `route` and `URL` for variety.28- Never style-pass gates, ADR decisions, credential custody or literal29 runbooks. Edit them by hand, and check whether a test matches their exact30 wording first.3132## Procedure3334Pick the lightest pass: repair named defects, rewrite (default) or diagnose35(findings only). If the draft already reads well, say so and touch little.36371. **Lock** facts, numbers, names, quotes, citation keys, defined terms,38 modals and negations. List them.392. **Diagnose** by mechanism ([mechanisms.md](references/mechanisms.md)), not40 by phrase. Name the two or three that cost the reader most.413. **Rewrite once**, restating each claim directly and adding only anchors the42 source holds.434. **Audit independently.** Compare the lock list with the result; revert any44 sentence that lost or strengthened a claim. For high-stakes text, a45 clean-context reviewer sees only the before and after. For number-heavy46 text, script the check ([claims.md](references/claims.md)).475. **Report** the text first, with notes only for material flags.4849`provenant check writing PATH` flags em dashes and lexical hints. Its silence50is necessary, not sufficient.5152## References5354- [voice.md](references/voice.md): register, punctuation and Australian55 English. Load before any write or rewrite.56- [mechanisms.md](references/mechanisms.md): the defects, with before/after57 pairs.58- [claims.md](references/claims.md): claim classes, comparatives, number59 audit and the condense pass.60- [engineering.md](references/engineering.md): READMEs, PRs, commits, error61 text, runbooks, release notes and process-language leaks. Specs and issue62 bodies go to `scope` and `tracker`; where a doc lives is `engineering-docs`.63- [academic.md](references/academic.md): thesis and paper register, citations,64 LaTeX invariants.