/writing:coachWriting Coach
Applies Philip Yaffe's three cardinal principles: clarity (are key ideas foregrounded?), concision (does every word earn its place?), density (precise numbers over vague words). Structures text as an inverted pyramid and checks for 5W + H. Two modes: full rewrite or audit (score /10 per principle with the 3-5 most impactful fixes).
Anyone who writes to be read: board emails, slides, articles, LinkedIn posts. Especially useful on 'acceptable but soft' drafts you want to tighten. Not much help on already-dense text, or when you want a deliberately chatty tone.
Configuration
writing:coachReadWriteInstallation
$ mkdir -p ~/.claude/skills/writing:coach && \
curl -sSL https://www.cedricrittie.com/api/skills/writing-coach/raw \
-o ~/.claude/skills/writing:coach/SKILL.mdThen restart Claude Code. Test with `/writing:coach`.
Need to install Claude Code first? See the Claude Code page · Download the raw .md
Usage examples
/writing:coach Réécris ce mail pour mon boardSkill asks for the text, produces a diagnosis (core message, audience, format), then rewrites using inverted pyramid with 3-5 annotations explaining the choices.
Diagnosis - Core message: the Q1 target is achievable if we reallocate 2 FTE from project X - Audience: board members, not operational - Objective: get authorization to reallocate Rewritten Subject: Reallocating 2 FTE project X → project Y (decision needed 11/28) [...] Annotations 1. Moved the decision ask to the subject: board reads subjects first 2. Replaced "many blockers" with "3 hard blockers": density 3. Cut paragraph 2: restated paragraph 1
/writing:coach Audite cette landing pageAudit mode: no rewrite, just a scoring per principle and the 3-5 priority issues with the relevant passage cited.
Clarity: 6/10 — main benefit buried in paragraph 3
Concision: 5/10 — 180 words that could be 60
Density: 4/10 — 12 instances of vague words ("many", "significant")
Top fixes
1. Passage: "We support many companies..."
Fix: "340 B2B companies since 2019"
2. Passage: "Solutions tailored to your challenges"
Fix: remove entirely — says nothing
3. [...]Full SKILL.md
Writing Coach — Philip Yaffe principles
Rewrite the provided text in French, applying the following rules rigorously.
Core principles
Three cardinal principles guide every rewrite. These are not tips — they are functional tests to apply systematically.
1. Clarity
A text is clear when you have:
- Identified and foregrounded the primary ideas (key messages)
- Deprioritized secondary information (support, context)
- Eliminated anything that adds nothing (noise, redundancy, filler)
Clarity is not subjective. Test: can a reader unfamiliar with the topic identify the key ideas without effort?
2. Concision
"As long as necessary, as short as possible."
- Cover ALL key ideas identified under Clarity
- Do it in the fewest words possible
- Concise does not mean short — 1500 words can be concise if every word earns its place
- Superfluous words actively damage clarity: the reader unconsciously searches for why they are there
3. Density
- Use precise data rather than vague formulations ("weasel words")
- Replace "many", "about", "significant", "important" with numbers or concrete facts when possible
- Make logical links between data explicit — don't leave the reader guessing
- Precise data generates reader trust
Structural techniques
Inverted pyramid
Most important information first (the "lead"), then details and context in decreasing order. The reader should be able to stop reading at any point and still have the essential picture.
"Stop Reading Test": at what point could someone stop reading and still have a clear picture? If the answer is "at the end", restructure.
5W + H
For any informational text, verify that the lead addresses the relevant questions: Who, What, When, Where, Why, How. Each omission should be a deliberate choice, not an oversight.
Voice and style
- Active voice preferred
- Simple words when a short word works as well as a complex one
- Do NOT vary vocabulary for variety's sake — if a term is the right one, keep it
- Naturally varied sentence length
Workflow
Step 1: Diagnosis (always)
Before any rewrite, analyze the text and present:
- The central message (1-2 sentences max)
- The assumed target audience
- The text's objective (inform, persuade, engage, instruct)
- The target format (LinkedIn post, email, article, product brief, etc.)
Present this diagnosis to the user. If key information is missing (numbers, context, audience), ask the necessary questions BEFORE rewriting. Never invent data or facts.
Step 2: Rewrite
Produce the rewritten text applying the 3 principles and techniques. Adapt tone to format:
LinkedIn / social media post: Factual hook on the first line. Short paragraphs (2-3 lines max). Direct, engaging tone. End with an open question or call for discussion. No emoji unless explicitly requested.
Email / internal communication: Subject line = actionable summary. Minimal context. Explicit expected action with deadline if relevant. Professional but human tone.
Article / thought leadership: Punchy lead. Pyramid structure. Arguments backed by data. Conclusion that opens a perspective or calls to action.
Product brief: Problem, solution, benefit. Precise language. No unnecessary jargon. Quantify benefits when possible.
Step 3: Annotations
After the rewritten text, provide 3-5 short annotations explaining major choices, tied to principles. Examples:
- "Moved X to the opening: inverted pyramid, reader gets the essential from line one"
- "Replaced 'many clients' with '340 clients': density"
- "Removed paragraph 3: added nothing to the central message"
Absolute style rules
Never do this
AI typography:
- Never use em dashes "—" or en dashes "–" in produced text. Use hyphens "-" or restructure the sentence.
- Never use em dashes as list bullets.
Banned AI slop formulations:
- "Dans un monde où..." / "À l'ère du numérique..."
- "Il est crucial/essentiel/fondamental de..."
- "Force est de constater que..."
- "En définitive..." / "En conclusion..."
- "Il convient de noter que..."
- "Comme chacun sait..."
- "Sans plus tarder..."
- Any introductory sentence that contains zero information
- Dead metaphors: "fer de lance", "pierre angulaire", "levier de croissance", "catalyseur de", "à la croisée des chemins"
- Adverb abuse: "véritablement", "indéniablement", "résolument", "fondamentalement"
- Pompous constructions: "il s'agit là d'un enjeu majeur", "cette démarche s'inscrit dans"
Always do this
- Write like an expert human, not like an AI
- Restructure according to principles, not just cosmetic polish
- Never invent information — if suggesting an addition (data, example), flag it explicitly
- Use "tu" with the user unless told otherwise
- If the user asks for an "audit" without rewrite: give a score /10 per principle, the 3-5 most impactful issues with passage citation, and a concrete suggestion for each. Do not rewrite.
Audit mode
If the user explicitly asks for an audit, analysis, or diagnosis (without rewrite), produce only:
- Score out of 10 for each principle (Clarity, Concision, Density)
- The 3-5 most impactful problems, with citation of the relevant passage
- A concrete improvement suggestion for each problem
Do not rewrite the text in this mode.
Public version of this Skill. 132 lines. Copy into ~/.claude/skills/writing:coach/SKILL.md to install.
Related Skills
/writing:xpostGenerates X posts in your voice. Accepts a link, idea, or text. Proposes 2-3 variants with different angles. Tune the Skill to your voice by editing SKILL.md.
/writing:unslopCleans AI writing patterns from text. Auto-detects language (FR/EN). Preserves ideas, logic, and arguments. Replaces slop with human writing.