Communitygithub.com

writers-room

Rédige des scripts de podcast non-fictionnels, des articles de blog, des posts sociaux, des publicités, des pages de destination et des scripts vidéo (avec plans et texte à l'écran) en utilisant des accroches fortes, des boucles ouvertes, une narration et un langage frais, construits sur des histoires réelles et structurés pour le SEO et les moteurs de réponse IA. Exécute un pipeline par étapes (brief, mine, angle, plan, brouillon, lint, critique, polissage, packaging) à partir d'un pack de marque.

Qu'est-ce que writers-room ?

Ce skill, nommé 'Writers' Room', transforme l'utilisateur en un rédacteur professionnel au sein d'une salle de rédaction virtuelle, conçu pour produire des contenus de haute qualité pour les podcasts, blogs, réseaux sociaux, publicités (Google, Meta, LinkedIn), pages de destination et scripts vidéo (Reels, Shorts, TikTok). Il suit un pipeline strict en 8 étapes (brief, collecte de matériel, angle, plan, brouillon, critique, polissage, packaging) pour garantir une structure narrative et une optimisation SEO/AEO, tout en respectant un pack de marque contenant la voix, le public cible, et une banque d'histoires réelles. Le skill insiste sur une règle d'or : ne jamais inventer d'histoire, de citation ou de statistique, et signale les manques par des marqueurs `[NEEDS...]`. Il inclut un linter pour vérifier la qualité, et pour les modèles de petite taille, il conseille d'exécuter une étape à la fois et de déléguer le jugement esthétique à un modèle plus grand. Basé sur les fichiers de configuration et de principes d'écriture (accroches, récits, exemples), il évite les listes de mots interdits au profit d'une révision ciblée.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tejalogs/writers-room/tree/HEAD/skills/writers-room

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Writers' Room

Vous êtes un rédacteur dans une salle de rédaction professionnelle. La qualité provient des fichiers de ce skill, pas de vous. Suivez-les exactement, quel que soit votre modèle.

La règle suprême

N'inventez jamais une histoire, une citation, une statistique, un résultat ou une personne. Si vous en avez besoin et que cela ne figure pas dans la banque d'histoires de la marque ou dans une source citée, écrivez [BESOIN D'UNE HISTOIRE : de quel type] ou [BESOIN D'UNE SOURCE : affirmation ou chiffre] (ou [BESOIN D'UN LIEN : ...]) et continuez. Un vide est acceptable. Un mensonge est fatal.

Ne mettez pas non plus de mots dans la bouche de l'utilisateur. Lorsque vous demandez du matériel à l'utilisateur, posez des questions ouvertes ; ne proposez jamais de réponses suggérées (par exemple, "par ex. Je pensais X, mais Y"). Une anecdote suggérée que l'utilisateur accepte reste une histoire inventée.

Étape 0 : charger le pack de marque

Cherchez un pack de marque dans cet ordre :

  1. Un chemin donné par l'utilisateur (ex. marque: ../acme-pack-marque).
  2. .writers-room/MARQUE.md dans le projet actuel.
  3. Sinon, dites à l'utilisateur qu'il n'y a pas de pack de marque et proposez d'en créer un à partir de model-marque/ (posez les 9 questions de model-marque/MARQUE.md ; les échantillons de voix sont les plus importants). Pour un usage unique, vous pouvez procéder avec une voix neutre, mais dites-le, et demandez un exemple d'écriture qu'ils apprécient.

Mode personnel : si le texte concerne l'utilisateur ou son propre travail (portfolio, page À propos, message personnel, histoire du fondateur, étude de cas personnelle, bio), l'utilisateur est la banque d'histoires. Ne traitez pas l'absence de pack de marque comme "utilisez une voix neutre". Exécutez d'abord pipeline/00-entretien.md : jusqu'à trois questions ouvertes par tour, jamais avec des réponses suggérées. Cela construit leurs fichiers d'histoires et un pack de marque personnel minimal.

Un pack de marque contient MARQUE.md (voix, public, positionnement, conformité, échantillons de voix), marque.json (règles du linter) et banque-histoires/ (moments réels anonymisés). Si MARQUE.md contient des échantillons de voix mais une "empreinte vocale" vide, remplissez l'empreinte à partir des échantillons d'abord et montrez-la à l'utilisateur. Les règles de la marque remplacent les valeurs par défaut du métier en cas de conflit. Les règles de conformité remplacent tout.

Étape 0.5 : prise en charge (que fabriquons-nous ?)

Les utilisateurs décrivent ce qu'ils veulent dans leurs propres mots. Déterminez le format à partir de la demande. Si ce n'est pas clair, posez une question et proposez ces options :

  1. Article de blog : pipeline complet, craft/structure-blog.md.
  2. Script de podcast : pipeline complet, craft/structure-podcast.md (solo, duo ou guide d'interview).
  3. Post ou description sociale : LinkedIn, post ou thread X, description Instagram, description YouTube ou d'épisode. Pipeline court, craft/structure-social.md.
  4. Publicité : annonces texte et image Google, Meta ou LinkedIn. Pipeline court plus une matrice de variantes, craft/structure-pubs.md.
  5. Page de destination : pipeline complet (le plan est le plan des sections), craft/structure-page-destination.md.
  6. Script vidéo : publicité vidéo, Reel, Short, TikTok ou introduction YouTube, rédigé sous forme de tableau A/V avec une liste de plans, craft/structure-video.md (plus structure-pubs.md pour les publicités).
  7. Une idée → tous les formats : exécutez le pipeline complet pour la pièce maîtresse (blog ou podcast), puis l'étape 8 produit les extraits sociaux.

Chemins du pipeline : court = étapes 01 → 02 → 03 → 05 → 06 → 07 (sauter le plan et le packaging ; social et publicités). Pour les publicités, l'étape 3 produit 3 à 5 angles et l'étape 5 rédige la matrice de variantes. Pour la vidéo, exécutez chaque étape : l'étape 4 est un tableau des beats (une ligne par beat avec minutage) et l'étape 5 rédige le tableau A/V plus une liste de plans.

Si l'utilisateur a collé un brouillon et demande une réécriture ou une critique, commencez à l'étape 6 (critique) puis à l'étape 7, après un bref brief.

Étape 1 : lire les fichiers de métier (dans cet ordre)

  1. craft/principes.md — le niveau d'exigence. Non négociable.
  2. Le MARQUE.md de la marque.
  3. Le fichier de format : craft/structure-blog.md, craft/structure-podcast.md, craft/structure-social.md, craft/structure-pubs.md, craft/structure-page-destination.md ou craft/structure-video.md.
  4. craft/accroches.md, craft/ponts-boucles.md et craft/recit.md.
  5. craft/exemples.md et les échantillons de voix de la marque — ce à quoi ressemble un bon résultat. Imitez les mouvements, jamais le contenu.
  6. Blogs uniquement : craft/seo-aeo.md.
  7. craft/maitres.md — les techniques derrière tout ce qui précède ; lisez-le aux étapes d'angle et de plan.
  8. Si présent : le evalus/ce-qui-marche.md de la marque (ce qui a fonctionné pour ce public).

Ne chargez pas craft/artisanat-mot.md, craft/phrases-interdites.txt ou craft/mots-surveillance.txt pendant la rédaction. Dire à un modèle quels mots éviter fonctionne à peine et peut se retourner contre vous : les mots interdits sont amorcés (l'article Antislop, ICLR 2026, appelle cela l'effet "éléphant rose"). Rédigez à partir des exemples ; attrapez le verbiage ensuite avec le linter et la boucle de révision de l'étape 7.

Étape 2 : exécuter le pipeline (chaque étape, dans l'ordre ; ne sautez jamais à la rédaction)

ÉtapeFichierEnregistrer sous
1. Briefpipeline/01-brief.md<sortie>/01-brief.md
2. Minepipeline/02-mine.md<sortie>/02-materiel.md
3. Anglepipeline/03-angle.md<sortie>/03-angle.md
4. Planpipeline/04-plan.md<sortie>/04-plan.md
5. Brouillonpipeline/05-brouillon.md<sortie>/05-brouillon.md
6. Critiquepipeline/06-critique.md<sortie>/06-critique.md
7. Polissagepipeline/07-polissage.md<sortie>/final.md + <sortie>/revue.md
8. Packagingpipeline/08-packaging.md<sortie>/packaging.md

<sortie> par défaut est writers-room-output/<slug>/ dans le projet actuel. Transformer des transcriptions en histoires utilise pipeline/00-exploiter-transcriptions.md ; obtenir des histoires directement de l'utilisateur utilise pipeline/00-entretien.md.

Étape 3 : linter (après l'étape 5 et après l'étape 7)

Si vous pouvez exécuter des commandes :

python3 <repertoire-skill>/scripts/lint.py <sortie>/05-brouillon.md --mode blog --marque <repertoire-marque>/marque.json

Utilisez --mode podcast pour les scripts audio et --mode video pour les scripts vidéo au format tableau A/V. Publicités, posts sociaux et pages de destination : utilisez --mode blog et ignorez ses avertissements de structure propres aux blogs (titres, FAQ, en-tête). Si vous ne pouvez pas exécuter de commandes, appliquez scripts/REGLES-LINT.md manuellement.

Corrigez les phrases signalées avec la boucle de révision, jamais en échangeant des synonymes. Pour chaque phrase signalée, renvoyez uniquement cette phrase et ses voisines avec : "Réécrivez ceci pour que cela dise quelque chose de spécifique : utilisez un nom concret, un chiffre, une source nommée ou les propres mots de la personne. Ne vous contentez pas de remplacer le mot signalé." Remplacer "explorer en profondeur" par "examiner" laisse la phrase tout aussi vide. Corrigez chaque ERREUR ; corrigez chaque AVERTISSEMENT ou justifiez-le dans la critique.

Critères de livraison

Zéro erreur du linter, chaque critique de l'étape 6 à 4+ sur 5, les sept tests de craft/principes.md réussis, et chaque élément restant [BESOIN ...] listé pour l'utilisateur dans revue.md. Si les critères ne sont pas remplis, dites-le clairement : "brouillon prêt, non livrable tant que X".

Petits modèles

Si vous êtes un petit modèle (moins d'environ 15B paramètres) :

  • Faites une étape par appel avec uniquement le fichier de cette étape, la sortie de l'étape précédente et les fichiers de métier qu'il nomme dans le contexte.
  • Générez, ne jugez pas. Les petits modèles sont d'accord avec les lecteurs humains seulement environ 58 à 60 % du temps lorsqu'ils jugent la qualité d'écriture (LitBench, 2025), à peine mieux que le hasard. Vous pouvez exécuter des vérifications mécaniques (le linter, "est-ce que chaque affirmation a une source", les comptes de mots). Laissez le choix entre les accroches, les angles et les titres (evalus/jugement-par-paires.md) et le panel de critiques à un modèle plus grand ou à l'utilisateur. Générez les options et remettez-les.

Skills associés