Cédric Rittié

/writing:coach

Writing Coach

ÉcritureDébutant2 min d'installation132 lignes

Applique les trois principes cardinaux de Philip Yaffe : clarté (les idées principales sont-elles en tête ?), concision (chaque mot gagne-t-il sa place ?), densité (des chiffres précis plutôt que des mots flous). Structure les textes en pyramide inversée et vérifie la présence des 5W + H. Deux modes : réécriture complète ou audit (score /10 par principe avec les 3-5 fixes les plus impactants).

Publié 15 avril 2026Mis à jour 16 avril 2026
GitHub
Pour qui ?

Toute personne qui écrit pour être lue : mails au board, slides, articles, posts LinkedIn. Particulièrement efficace sur les textes 'acceptables mais mous' qu'on aimerait resserrer. Peu utile sur un texte déjà dense, ou quand tu cherches un ton volontairement bavard.

Configuration

Nom
writing:coach
Catégorie
Écriture
Description
Réécrit un texte brut ou approximatif en écriture professionnelle claire, concise et dense en français. Utilise les principes d'écriture de Philip Yaffe.
Outils autorisés
ReadWrite

Installation

Une ligne, un terminal
$ mkdir -p ~/.claude/skills/writing:coach && \
  curl -sSL https://www.cedricrittie.com/api/skills/writing-coach/raw \
       -o ~/.claude/skills/writing:coach/SKILL.md

Puis redémarre Claude Code. Test avec `/writing:coach`.

Besoin d'installer Claude Code d'abord ? Voir la fiche Claude Code · Télécharger le .md brut

Exemples d'utilisation

/writing:coach Réécris ce mail pour mon board

Le Skill demande le texte, produit un diagnostic (message central, audience, format), puis réécrit en mode pyramide inversée avec 3-5 annotations justifiant les choix.

Résultat type
Diagnostic
- Message central : l'objectif Q1 est tenable si on réalloue 2 ETP du projet X
- Audience : membres du board, pas opérationnels
- Objectif : obtenir l'autorisation de réallouer

Texte réécrit
Objet : Réallocation 2 ETP projet X → projet Y (décision demandée 28/11)
[...]

Annotations
1. Décision déplacée en objet : le board lit les objets en premier
2. "De nombreux blocages" remplacé par "3 blocages bloquants" : densité
3. Paragraphe 2 coupé : répétait le paragraphe 1
/writing:coach Audite cette landing page

En mode audit : pas de réécriture, juste un scoring par principe et les 3-5 problèmes prioritaires avec citation du passage concerné.

Résultat type
Clarté : 6/10 — bénéfice principal enterré au paragraphe 3
Concision : 5/10 — 180 mots qui pourraient en faire 60
Densité : 4/10 — 12 occurrences de mots flous ("nombreux", "significatif")

Fixes prioritaires
1. Passage : "Nous accompagnons de nombreuses entreprises..."
   Fix : "340 entreprises B2B depuis 2019"
2. Passage : "Des solutions adaptées à vos enjeux"
   Fix : supprimer — ne dit rien
3. [...]

Le Skill en entier

Pourquoi le Skill est écrit en anglais ? Les LLM sont entraînés majoritairement sur de l'anglais. Un prompt système en anglais donne des résultats plus fiables et plus précis, même quand Claude te répond en français. Le texte produit par le Skill (tes posts, tes audits, tes digests) sort dans la langue que tu utilises, lui. Seules les instructions système restent en anglais par choix de performance.

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:

  1. Score out of 10 for each principle (Clarity, Concision, Density)
  2. The 3-5 most impactful problems, with citation of the relevant passage
  3. A concrete improvement suggestion for each problem

Do not rewrite the text in this mode.

Version publique de ce Skill. 132 lignes. Copie-colle dans ~/.claude/skills/writing:coach/SKILL.md pour l'installer.

Skills liés