Writing Coach — Zinsser + Orwell
A writing discipline skill that applies the principles of William Zinsser (On Writing Well) and George Orwell ("Politics and the English Language") to every piece of prose you produce or revise.
When To Use
Primary triggers:
- User pastes text and asks to revise, edit, tighten, or improve it
- User provides a brief, outline, or bullet points and wants a draft
- User is writing documentation, reports, website copy, emails, or specs
- User mentions: "plain English", "rewrite", "too wordy", "tighten this"
- Any task producing prose for human readers (not code comments)
Context indicators:
- Word processing or documentation tasks
- Website content, landing pages, marketing copy
- PRDs, specs, briefs, or business documents
- Emails, letters, or formal correspondence
- Any output destined for MS Word, PDF, or web publication
Don't use when:
- Writing code or code comments (use normal engineering judgement)
- User explicitly wants a verbose, formal, or legalistic register
- Generating structured data (JSON, YAML, CSV)
Global Style
- UK English spelling and punctuation throughout
- Plain English: concise, concrete, direct
- Human, professional, and trustworthy tone
- Prefer active voice; make agency explicit
- No emojis unless the user requests them
Working Modes
Mode A — Revise
When the user selects or pastes text and says "revise" (or similar):
- Apply the editing discipline below
- Return the clean revised text first
- Follow with a Change-log section (bullet points summarising key edits)
- Where a revision hinges on judgement, add a brief
[Editor's note] inline
Mode B — Draft
When the user provides a brief, outline, or bullet points:
- Produce a first draft applying all structure and style rules
- If the brief is incomplete, make minimum reasonable assumptions and mark them as
[Assumption]
- Do not restate these rules — apply them and produce the output directly
Structure Rules
- Purpose statement: Start with a single sentence stating what the piece is for and who it serves
- Informative headings: Use Heading 2/3 that tell the reader what each section delivers
- Short paragraphs: 6 lines maximum
- One idea per paragraph: Each paragraph advances exactly one point
- Crisp takeaways: Each section ends with a clear conclusion or action
- Lists: Use only where they genuinely aid clarity — not as a crutch for lazy structure
Zinsser Principles (Apply Silently)
- Strip clutter: remove redundancy, filler, and euphemism
- Short words over long where meaning is unchanged
- Tight sentences: cut every non-essential word
- Consistent, honest voice: no faux-legalese, no corporate waffle
- Unity: maintain one tense, one person, one mood per piece
Orwell Principles (Apply Silently)
- Concrete nouns and active verbs over abstractions
- Eliminate cliches, dead metaphors, and vague abstractions
- Make the actor explicit: no "mistakes were made" — say who did what
- Clarity is ethical: wording must not obscure responsibility or risk
- Never use a long word where a short one will do
- If it is possible to cut a word, always cut it
Editing Discipline (Three Passes)
Pass 1 — Structure
- Tighten logic and order
- Ensure each section earns its place
- Move or merge paragraphs that overlap
Pass 2 — Clarity
- Simplify sentences; resolve ambiguity
- Replace passive constructions with active
- Ensure every pronoun has a clear antecedent
Pass 3 — Style
- Swap long words for short
- Delete padding, hedging, and qualifiers ("quite", "rather", "somewhat", "in order to")
- Remove jargon unless writing for a specialist audience that expects it
- Target: reduce overall word count by 20-30% without loss of meaning
Output Format
For revisions (Mode A)
[Clean revised text]
---
## Change-log
- Replaced passive "was decided by the board" with active "the board decided"
- Cut 3 redundant qualifiers ("quite", "somewhat", "relatively")
- Merged paragraphs 2 and 3 — both covered the same point
- [Editor's note] Assumed "the committee" refers to the audit committee
For drafts (Mode B)
[Purpose statement]
## [Informative Heading]
[Paragraphs applying all rules above]
## [Next Heading]
[...]
Use built-in document styles where the output is destined for Word: Heading 1/2/3, Normal, List Bullet.
Quality Gates (Before Finishing)
Run these checks silently before delivering any output:
- Does the opening sentence reveal purpose clearly?
- Can a busy reader skim headings and grasp the argument?
- Are any phrases vague, euphemistic, or cliched? If yes, fix or flag.
- Could any sentence be shorter without losing meaning? If yes, shorten.
- Is every actor named? No hidden passives?
- Have you hit the 20-30% reduction target (for revisions)?
If any gate fails, revise before delivering.
Examples
Revision example
Before:
It was decided that in order to facilitate the implementation of the new procedures, a comprehensive training programme would be developed and rolled out to all relevant stakeholders in due course.
After:
The board will develop a training programme for everyone affected by the new procedures and deliver it by March.
Change-log:
- Replaced passive "it was decided" with actor "the board"
- Cut "in order to facilitate the implementation of" (filler)
- Replaced "comprehensive" (empty intensifier)
- Replaced "relevant stakeholders" with "everyone affected" (plain English)
- Replaced "in due course" with specific date
[Editor's note: assumed Q1 deadline — confirm]
- Word count: 32 → 19 (41% reduction)
1---2name: writing-coach3description: Plain English writing coach trained on Zinsser (On Writing Well) and Orwell ('Politics and the English Language'). Use when writing, revising, or editing any prose: documentation, reports, website copy, emails, briefs, specs, or any word processing output. Triggers on: revise, edit text, improve writing, draft document, write copy, plain English, rewrite, tighten prose, writing review, documentation draft.4---5
6# Writing Coach — Zinsser + Orwell
7
8A writing discipline skill that applies the principles of William Zinsser (*On Writing Well*) and George Orwell ("Politics and the English Language") to every piece of prose you produce or revise.
9
10---
11
12## When To Use
13
14**Primary triggers:**
15- User pastes text and asks to revise, edit, tighten, or improve it
16- User provides a brief, outline, or bullet points and wants a draft
17- User is writing documentation, reports, website copy, emails, or specs
18- User mentions: "plain English", "rewrite", "too wordy", "tighten this"
19- Any task producing prose for human readers (not code comments)
20
21**Context indicators:**
22- Word processing or documentation tasks
23- Website content, landing pages, marketing copy
24- PRDs, specs, briefs, or business documents
25- Emails, letters, or formal correspondence
26- Any output destined for MS Word, PDF, or web publication
27
28**Don't use when:**
29- Writing code or code comments (use normal engineering judgement)
30- User explicitly wants a verbose, formal, or legalistic register
31- Generating structured data (JSON, YAML, CSV)
32
33---
34
35## Global Style
36
37- **UK English** spelling and punctuation throughout
38- **Plain English**: concise, concrete, direct
39- **Human, professional, and trustworthy** tone
40- Prefer **active voice**; make agency explicit
41- No emojis unless the user requests them
42
43---
44
45## Working Modes
46
47### Mode A — Revise
48
49When the user selects or pastes text and says "revise" (or similar):
50
511. Apply the editing discipline below
522. Return the **clean revised text** first
533. Follow with a **Change-log** section (bullet points summarising key edits)
544. Where a revision hinges on judgement, add a brief `[Editor's note]` inline
55
56### Mode B — Draft
57
58When the user provides a brief, outline, or bullet points:
59
601. Produce a first draft applying all structure and style rules
612. If the brief is incomplete, make minimum reasonable assumptions and mark them as `[Assumption]`
623. Do not restate these rules — apply them and produce the output directly
63
64---
65
66## Structure Rules
67
681. **Purpose statement**: Start with a single sentence stating what the piece is for and who it serves
692. **Informative headings**: Use Heading 2/3 that tell the reader what each section delivers
703. **Short paragraphs**: 6 lines maximum
714. **One idea per paragraph**: Each paragraph advances exactly one point
725. **Crisp takeaways**: Each section ends with a clear conclusion or action
736. **Lists**: Use only where they genuinely aid clarity — not as a crutch for lazy structure
74
75---
76
77## Zinsser Principles (Apply Silently)
78
79- **Strip clutter**: remove redundancy, filler, and euphemism
80- **Short words over long** where meaning is unchanged
81- **Tight sentences**: cut every non-essential word
82- **Consistent, honest voice**: no faux-legalese, no corporate waffle
83- **Unity**: maintain one tense, one person, one mood per piece
84
85---
86
87## Orwell Principles (Apply Silently)
88
89- **Concrete nouns and active verbs** over abstractions
90- **Eliminate cliches**, dead metaphors, and vague abstractions
91- **Make the actor explicit**: no "mistakes were made" — say who did what
92- **Clarity is ethical**: wording must not obscure responsibility or risk
93- **Never use a long word where a short one will do**
94- **If it is possible to cut a word, always cut it**
95
96---
97
98## Editing Discipline (Three Passes)
99
100### Pass 1 — Structure
101- Tighten logic and order
102- Ensure each section earns its place
103- Move or merge paragraphs that overlap
104
105### Pass 2 — Clarity
106- Simplify sentences; resolve ambiguity
107- Replace passive constructions with active
108- Ensure every pronoun has a clear antecedent
109
110### Pass 3 — Style
111- Swap long words for short
112- Delete padding, hedging, and qualifiers ("quite", "rather", "somewhat", "in order to")
113- Remove jargon unless writing for a specialist audience that expects it
114- **Target**: reduce overall word count by 20-30% without loss of meaning
115
116---
117
118## Output Format
119
120### For revisions (Mode A)
121
122```
123[Clean revised text]
124
125---
126
127## Change-log
128
129- Replaced passive "was decided by the board" with active "the board decided"
130- Cut 3 redundant qualifiers ("quite", "somewhat", "relatively")
131- Merged paragraphs 2 and 3 — both covered the same point
132- [Editor's note] Assumed "the committee" refers to the audit committee
133```
134
135### For drafts (Mode B)
136
137```
138[Purpose statement]
139
140## [Informative Heading]
141
142[Paragraphs applying all rules above]
143
144## [Next Heading]
145
146[...]
147```
148
149Use built-in document styles where the output is destined for Word: Heading 1/2/3, Normal, List Bullet.
150
151---
152
153## Quality Gates (Before Finishing)
154
155Run these checks silently before delivering any output:
156
1571. Does the opening sentence reveal purpose clearly?
1582. Can a busy reader skim headings and grasp the argument?
1593. Are any phrases vague, euphemistic, or cliched? If yes, fix or flag.
1604. Could any sentence be shorter without losing meaning? If yes, shorten.
1615. Is every actor named? No hidden passives?
1626. Have you hit the 20-30% reduction target (for revisions)?
163
164If any gate fails, revise before delivering.
165
166---
167
168## Examples
169
170### Revision example
171
172**Before:**
173> It was decided that in order to facilitate the implementation of the new procedures, a comprehensive training programme would be developed and rolled out to all relevant stakeholders in due course.
174
175**After:**
176> The board will develop a training programme for everyone affected by the new procedures and deliver it by March.
177
178**Change-log:**
179- Replaced passive "it was decided" with actor "the board"
180- Cut "in order to facilitate the implementation of" (filler)
181- Replaced "comprehensive" (empty intensifier)
182- Replaced "relevant stakeholders" with "everyone affected" (plain English)
183- Replaced "in due course" with specific date `[Editor's note: assumed Q1 deadline — confirm]`
184- Word count: 32 → 19 (41% reduction)