Communitygithub.com

Rédacteur de Newsletter

Utilisez cette compétence lorsque l'utilisateur souhaite rédiger un e-mail de mise à jour produit, une lettre d'annonce de fonctionnalité ou un e-mail de synthèse pour les utilisateurs ou les abonnés.

Qu'est-ce que Rédacteur de Newsletter ?

Cette compétence spécialisée dans la rédaction de newsletters produit permet aux utilisateurs de générer facilement des e-mails de mise à jour produit, des annonces de fonctionnalités et des e-mails de synthèse pour les utilisateurs ou abonnés. Elle prend en charge plusieurs types d'entrée, y compris les briefs marketing, les articles de blog, les changelogs, les URLs GitHub, les plages de références Git, les chemins de fichiers ou le texte libre. La compétence suit un flux de travail structuré en cinq phases : découverte, configuration, rédaction, révision et sortie. Elle génère des lignes d'objet, du texte d'aperçu et un corps d'e-mail au format approprié (mono-fonctionnalité ou digest), adapté au public cible et au ton de la marque. La compétence met l'accent sur des avantages utilisateur, une rédaction conversationnelle et une vérification humaine, tout en évitant les suppositions non confirmées. L'utilisateur final approuve chaque étape avant de passer à la suivante. La compétence ne se charge pas de l'envoi, de la planification ou de la gestion des listes d'abonnés.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlemTuzlak/skills/tree/HEAD/skills/newsletter

Demander à votre IA préférée

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

Documentation

Que fait Rédacteur de Newsletter ?

Rédigez des e-mails de mise à jour produit et des lettres d'annonce de fonctionnalités. Gère les lignes d'objet, le texte d'aperçu, la structure de l'e-mail et le contenu adapté au public.

Résolution de l'entrée

Résolvez l'argument (si fourni) dans cet ordre :

  1. Chemin vers un brief marketing existant (.md contenant "Executive Summary" ou "Key Messages") -> brief marketing
  2. Chemin vers un article de blog existant (.md avec une structure d'article de blog) -> article de blog
  3. Chemin vers un changelog existant (.md avec les sections Ajouté/Corrigé/Modifié ou CHANGELOG.md) -> changelog
  4. Correspond à une URL GitHub ou un motif #\d+ -> PR
  5. Contient ... ou .. -> plage de références Git
  6. Se résout en fichier/répertoire existant -> fonctionnalité du code
  7. Sinon -> texte libre

Si aucun argument n'est fourni, demandez : "Que doit couvrir la newsletter ? Vous pouvez fournir un brief marketing, un article de blog, un changelog, une URL/numéro de PR, une plage de références Git, un chemin de fichier/répertoire, ou simplement décrire la mise à jour."

Si plusieurs interprétations correspondent, confirmez avec l'utilisateur.

Flux de processus

digraph newsletter {
    rankdir=TB;
    "Résoudre l'entrée" [shape=box];
    "Phase 1 : Découverte" [shape=box];
    "Phase 2 : Configuration" [shape=box];
    "Phase 3 : Rédaction" [shape=box];
    "Phase 4 : Révision" [shape=box];
    "Approuvé ?" [shape=diamond];
    "Phase 5 : Sortie" [shape=box];

    "Résoudre l'entrée" -> "Phase 1 : Découverte";
    "Phase 1 : Découverte" -> "Phase 2 : Configuration";
    "Phase 2 : Configuration" -> "Phase 3 : Rédaction";
    "Phase 3 : Rédaction" -> "Phase 4 : Révision";
    "Phase 4 : Révision" -> "Approuvé ?";
    "Approuvé ?" -> "Phase 3 : Rédaction" [label="révisions"];
    "Approuvé ?" -> "Phase 5 : Sortie" [label="oui"];
}

Ne sautez PAS les phases. Posez les questions à un rythme naturel. Si l'utilisateur répond à plusieurs questions à la fois, acceptez des réponses groupées et passez à la suite.

Si l'utilisateur dit "choisis les valeurs par défaut", "décide toi-même" ou quelque chose d'approchant, choisissez des valeurs par défaut raisonnables en fonction du contexte, indiquez ce que vous avez choisi et demandez une seule confirmation avant de continuer.

Ne présumez jamais sans confirmer.

Phase 1 : Découverte

Étape 1 - Analyser l'entrée

Type d'entréeQue lire
Brief marketingExtrayez l'énoncé du problème, la proposition de valeur, le public, les messages clés. Passez à l'étape 3. Faites quand même l'étape 2 si le brief manque de contexte produit.
Article de blogExtrayez le titre, les points clés, le public, l'appel à l'action. Passez à l'étape 3. Faites quand même l'étape 2 si cela manque de contexte produit.
ChangelogExtrayez toutes les entrées. Utilisez-les comme base pour un e-mail de synthèse. Passez à l'étape 3.
PRDiff, description de la PR, commentaires de révision, messages de commit (gh pr view, gh pr diff). Pour les grandes PR (20+ fichiers), concentrez-vous sur les changements visibles par l'utilisateur.
Références Gitgit diff et git log entre les références. Pour les grandes plages, priorisez les messages de commit et les changements visibles par l'utilisateur.
Fonctionnalité du codeLisez les fichiers/répertoires spécifiés.
Texte libreAnalysez la description de l'utilisateur. Si elle manque de détails, demandez à l'utilisateur de fournir plus d'informations ou de pointer vers un fichier/PR spécifique. Revenez à des questions ouvertes seulement s'il ne peut pas.

Changements visibles par l'utilisateur incluent : nouvelles fonctionnalités, modifications de l'interface utilisateur, modifications de l'API, améliorations des performances, corrections de bugs et mises à jour de la documentation. Changements internes incluent : refontes, ajouts de tests, modifications CI et mises à jour de dépendances. En cas de doute, listez ce que vous avez trouvé et demandez à l'utilisateur ce qui est pertinent.

Gestion des erreurs :

  • gh non disponible -> informez l'utilisateur, suggérez gh auth login, proposez une entrée alternative
  • PR/référence invalide -> demandez à l'utilisateur de vérifier
  • Fichier introuvable -> demandez le chemin correct

Étape 2 - Lire le contexte produit plus large

Lisez s'ils existent : README, docs/, package.json (ou équivalent).

Si rien n'est trouvé, demandez : "Je n'ai pas trouvé de contexte produit dans le dépôt. Pouvez-vous décrire brièvement le produit et à qui il s'adresse ?"

Étape 3 - Présenter la compréhension et déterminer le format

Présentez un résumé structuré :

"Voici ce sur quoi je vais baser la newsletter :"

  • Mise à jour A - brève description
  • Mise à jour B - brève description

"Quelque chose à ajouter, supprimer ou corriger ?"

Ensuite, déterminez le format de l'e-mail en fonction du nombre de mises à jour :

  • Mise à jour majeure unique -> e-mail mono-fonctionnalité (ciblé, approfondi)
  • Plusieurs mises à jour -> e-mail digest (liste priorisée, la plus importante développée)

Confirmez le format avec l'utilisateur.

Si aucun changement visible par l'utilisateur n'est trouvé dans l'entrée, dites-le à l'utilisateur et arrêtez-vous : "Aucun changement visible par l'utilisateur trouvé dans cette entrée. Rien à écrire pour une newsletter."

Ne continuez PAS avant que l'utilisateur ait confirmé la portée et le format.

Phase 2 : Configuration

Posez ces questions :

Q1 - Public : "À qui va cet e-mail ?" (tous les utilisateurs, utilisateurs avancés, nouveaux utilisateurs, niveau de plan spécifique, développeurs, utilisateurs non techniques, autre)

Q2 - Format de sortie : "Dans quel format voulez-vous l'e-mail ?"

  • Copie seule - ligne d'objet, texte d'aperçu, corps du texte, texte de l'appel à l'action (à insérer dans votre outil d'e-mail)
  • Markdown - markdown formaté que la plupart des outils d'e-mail peuvent importer

Q3 - Ton : Lisez le contenu existant du dépôt (README, docs, articles de blog) pour détecter la voix du produit. Confirmez ensuite :

"D'après votre contenu existant, le ton semble [par ex. conversationnel et adapté aux développeurs]. Dois-je m'en tenir à cela ou aller dans une direction différente ?"

Si aucun contenu existant à analyser, demandez directement le ton souhaité par l'utilisateur.

Q4 - Appel à l'action (CTA) : Déduisez l'appel à l'action le plus approprié du contexte :

  • Nouvelle fonctionnalité -> "Essayez-le maintenant", "Découvrez ce qui est nouveau"
  • Amélioration -> "Jetez-y un œil", "Voyez la différence"
  • Open source -> "Mettez à jour maintenant", "Voir la version"

"Je suggère que l'appel à l'action soit : [CTA déduit]. Voulez-vous l'utiliser ou autre chose ?"

Phase 3 : Rédaction

Lignes d'objet

Générez 3 à 5 options de ligne d'objet avec différentes approches :

  • Axée sur les bénéfices ("Vos rapports s'exportent désormais en PDF")
  • Curiosité ("Nous avons repensé le fonctionnement de la recherche")
  • Nom de fonctionnalité spécifique ("Présentation du mode sombre")
  • Question ("Vous attendez encore la fin des exportations ?")
  • Urgence/actualité ("Nouveau cette semaine : 3 fonctionnalités que vous avez demandées")

Recommandez-en une et expliquez pourquoi elle fonctionne le mieux. Expliquez également les compromis des autres.

Règles :

  • 30 à 50 caractères optimal (évitez la troncature sur mobile)
  • Soyez spécifique, pas générique ("Nouveau : exportations PDF" bat "Mise à jour produit - mars 2026")
  • Aucun mot déclencheur de spam (Gratuit, Acheter maintenant, Agissez maintenant)

Texte d'aperçu

Générez un texte d'aperçu pour chaque option de ligne d'objet. Le texte d'aperçu est la ligne secondaire visible dans les aperçus de la boîte de réception.

Règles :

  • 40 à 130 caractères
  • Développez la ligne d'objet, ne la répétez pas
  • Incluez le bénéfice ou le résultat clé

Corps de l'e-mail

Structure d'e-mail mono-fonctionnalité :

  1. Énoncé du problème - une phrase décrivant le problème que cela résout
  2. Ce qui a changé - 2 à 3 phrases décrivant la mise à jour en langage bénéfice-utilisateur ("Les rapports se chargent plus vite" pas "Exécution de la requête SQL optimisée")
  3. Espace réservé visuel - <!-- TODO: Ajouter une capture d'écran ou un GIF montrant la fonctionnalité en action --> avec une description de ce qu'il faut capturer
  4. Bouton CTA - une seule action claire

Structure d'e-mail digest :

  1. Mise à jour principale - la mise à jour la plus importante reçoit le traitement complet mono-fonctionnalité (problème, ce qui a changé, visuel, CTA)
  2. Mises à jour secondaires - des puces brèves avec des descriptions d'une ligne et des liens
  3. Correctifs rapides / améliorations - liste groupée de petites modifications
  4. CTA de clôture - une seule action ou "Voir toutes les mises à jour"

Règles de rédaction

  • Mettez en avant le bénéfice utilisateur, pas ce que vous avez construit
  • Ton conversationnel, pas corporate
  • Paragraphes courts (2 à 3 phrases maximum)
  • Une idée par paragraphe
  • N'utilisez jamais de tirets longs (tiret cadratin) dans le contenu généré. Pas de caractères "---". Utilisez plutôt des virgules, des deux-points, des points ou des parenthèses.
  • Pas de jargon. "Les rapports se chargent plus vite" bat "Plan d'exécution de requête SQL optimisé"
  • Mettez en gras les phrases clés pour la lisibilité
  • Gardez le texte facile à parcourir. Plus c'est court, mieux c'est. Si l'e-mail prend plus de 60 secondes à lire, il est trop long.

Variantes par segment

Après avoir généré l'e-mail principal, demandez :

"Voulez-vous que je génère des variantes pour différents segments de public ? (par ex. une version plus technique pour les développeurs, une version plus simple pour les utilisateurs non techniques)"

Si oui, générez les variantes demandées, en ajustant le ton, la profondeur et l'accent sur les fonctionnalités par segment.

Phase 4 : Révision

Présentez l'e-mail complet :

"Voici la newsletter :"

Options de ligne d'objet : (avec recommandation et texte d'aperçu pour chacune)

  1. Sujet : "..." / Aperçu : "..."
  2. Sujet : "..." / Aperçu : "..."
  3. Sujet : "..." / Aperçu : "..."

Corps : [contenu complet de l'e-mail]

"Choisissez une ligne d'objet et dites-moi si vous voulez des modifications."

Attendez que l'utilisateur sélectionne une ligne d'objet et approuve ou demande des révisions. Ne passez à la sortie qu'une fois approuvé.

Phase 5 : Sortie

Imprimez toujours l'e-mail final approuvé dans le terminal.

Demandez ensuite : "Voulez-vous que je sauvegarde ceci dans emails/<slug>.md ? Ou un chemin différent ?"

Créez le répertoire s'il n'existe pas. Si le fichier existe déjà, demandez s'il faut écraser ou créer une copie versionnée.

Gestion des erreurs

  • gh non disponible -> informez l'utilisateur, proposez une entrée alternative
  • PR/référence invalide -> demandez à l'utilisateur de vérifier
  • Aucun contexte produit -> demandez à l'utilisateur de décrire le produit
  • Aucun répertoire d'e-mails existant -> par défaut emails/, créez-le

Ce que cette compétence NE fait PAS

  • Envoyer ou planifier des e-mails
  • Gérer les listes d'abonnés ou la logique de segmentation
  • Créer des modèles d'e-mails ou des systèmes de conception
  • Générer des articles de blog ou des copies pour les réseaux sociaux (utilisez /blog-post ou /social-copy)

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

AlemTuzlak/skills

Use when the user wants to write a blog post about a feature, product change, PR, git diff, or any technical topic - accepts marketing briefs, PRs, git refs, codebase paths, or freeform descriptions as input

AlemTuzlak/skills

Use when the user wants to generate a changelog, release notes, or document what changed between versions, tags, or PRs

AlemTuzlak/skills

Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning or implementing a new feature or change in a repo (docs ship with the code). Also use when tempted to write docs without showing the discovered readers to the user, without asking for tone, or without loading simple-english and i-have-adhd. Triggers on "write docs for X", "document this feature", "add a guide", "update the docs", "reorganize the docs", "plan feature X", "implement X", or /docs.

AlemTuzlak/skills

Use when a bug is in play: a test fails, CI is red, an API returns the wrong result, a stack trace appears, or the user says it is broken or fix this. Don't use for a new feature with no failure, for types-only work, or for docs.

AlemTuzlak/skills

Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required writing filter by the docs skill. Don't use for marketing copy or after the user says "stop adhd mode" or "normal mode".

AlemTuzlak/skills

Use when a settled change must be turned into an ordered stack of small blocks before anyone implements. Don't use for unsettled intent, typos, comments, formatting, docs-only work, or writing the implementation itself.

AlemTuzlak/skills

Use when the user wants to turn a raw talking-head / screen-share recording into a finished, edited, annotated video plus a full content package. Removes silences, flags mistakes for the user to cut, transcribes, adds transcript-synced overlays (code, on-screen code highlights, word highlights, lists, comparisons, diagrams, section labels, punch-in zooms), renders with original audio, then generates blog/socials/YouTube content. Triggers on "produce a video", "edit my video", "annotate my recording", "/produce-video".

AlemTuzlak/skills

Use when the user runs /prove-it or says prove it, prove the changes, show me in the browser, or asks to prove a UI or API change. Don't use only because the agent is about to say done, for types-only work, or for docs with no behavior to prove.

AlemTuzlak/skills

Use when the user wants to write, draft, or author an RFC (Request for Comments) / technical design doc for a feature, change, or architectural decision. Interactively interviews the user, grounds the proposal in the actual codebase, presents 2-3 concrete API/code-snippet approaches to choose from, then writes a review-ready RFC. Triggers on "write an RFC", "draft an RFC", "RFC for X", "design doc for X", or /rfc.

AlemTuzlak/skills

Use when the user wants to deeply learn a new topic from scratch. Runs a pre-interview (current knowledge, end-goal proficiency, depth, practice load, background, scope), researches online (articles, niche-influencer blogs, canonical docs, subtopic landscape), then produces a structured markdown course with mandatory visual diagrams, evidence-based learning-science features (retrieval practice, spaced callbacks, worked-example fading, concept ledger, jargon gate, analogy hygiene), and a self-contained interactive HTML mini-course. Triggers on /teach-me, "teach me about X", "I want to learn X", "deep dive on X", "create a course on X", "study X with me".

AlemTuzlak/skills

Use when the change intent is already settled and the agent must map what a behavior change touches before an implementation plan or any code. Use for new features, bug fixes, and refactors that move a boundary. Don't use for typos, comments, formatting, lockfile-only diffs, docs with no code, or while the user is still deciding what they want.

AlemTuzlak/skills

Use when the user wants to transcribe a video or audio file to text with word-level timestamps — spins up a self-contained local Whisper (whisper.cpp) Docker service bundled in this skill and returns transcript.txt, transcript.srt, and word-level transcript.words.json. Also used as a building block by /produce-video. Triggers on "transcribe this video", "get a transcript", "transcribe-video".

AlemTuzlak/skills

Use when the user wants to write a video script for a product demo, feature walkthrough, launch video, or social media video about a feature or product change

AlemTuzlak/skills

Use when the user wants YouTube metadata for a video — a click-worthy title, an SEO/above-the-fold description, tags, and timestamped chapters. Accepts a transcript (ideally timestamped SRT), a topic, a PR, or a freeform description. Used standalone and by /produce-video. Triggers on "youtube title", "youtube description", "youtube chapters", "youtube tags", "youtube metadata", "youtube-copy".

Skills associés