Communitygithub.com

AlemTuzlak/skills

À utiliser lorsque l'utilisateur souhaite rédiger un article de blog sur une fonctionnalité, un changement de produit, une PR, un diff git ou tout sujet technique – accepte les briefs marketing, les PR, les références git, les chemins de la base de code ou des descriptions libres en entrée.

Qu'est-ce que skills ?

Blog Post Writer est un agent spécialisé qui transforme des modifications de code, des briefs marketing ou des descriptions de fonctionnalités en articles de blog de haute qualité. Il gère l'ensemble du processus de rédaction : analyse d'entrée (PR, diffs git, fichiers, briefs marketing, texte libre), recherche concurrentielle via WebSearch, configuration personnalisée (audience, ton, type de publication, CTA, niveau d'implication), génération d'un plan structuré, rédaction avec auto-révision et optimisation SEO (balises meta, mots-clés, slug). L'outil prend en charge les agents comme Claude Code, Cursor et Codex. Il suit un flux en six phases : découverte, recherche concurrentielle, configuration, planification, rédaction (avec génération de titres et frontmatter YAML) et sortie (sauvegarde dans le répertoire blog). Il propose trois niveaux d'implication utilisateur : entièrement autonome, validation du plan uniquement, ou validation section par section. Une règle stricte interdit l'utilisation de tirets cadratins (em-dashes), remplacés par des traits d'union. Ce skill ne publie pas les articles, ne crée pas de copies pour les réseaux sociaux ni de briefs marketing, et ne génère pas de multiples variantes pour différents publics.

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

Demander à votre IA préférée

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

Aperçu

Depuis le README du skill

Description du texte alternatif

Documentation

Rédacteur d'articles de blog

Rédigez des articles de blog de haute qualité à partir de modifications de code, de briefs marketing ou de descriptions de fonctionnalités. Gère le SEO, la structure, l'adaptation du ton et le contenu visuel.

Règle d'écriture (non négociable) : n'utilisez jamais de tirets cadratins (— ou –). Utilisez plutôt un trait d'union -. S'applique à chaque ligne de texte généré.

Résolution d'entrée

Résolvez l'argument (s'il est fourni) dans cet ordre :

  1. Chemin vers un fichier de brief marketing existant (.md contenant "Executive Summary" ou "Key Messages") → brief marketing
  2. Correspond à une URL GitHub ou un motif #\d+ → PR
  3. Contient ... ou .. → plage de références git
  4. Résout un fichier/répertoire existant → fonctionnalité de la base de code
  5. Sinon → texte libre

Si aucun argument n'est fourni, demandez : "Sur quoi devrais-je écrire ? Vous pouvez fournir un chemin de brief marketing, une URL/numéro de PR, une plage de références git (par exemple v1.0...v2.0), un chemin de fichier/répertoire, ou simplement décrire le sujet."

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

Flux de processus

digraph blog_post {
    rankdir=TB;
    "Resolve input" [shape=box];
    "Phase 1: Discovery" [shape=box];
    "Phase 2: Research" [shape=box];
    "Phase 3: Configure" [shape=box];
    "Phase 4: Outline" [shape=box];
    "Outline approved?" [shape=diamond];
    "Phase 5: Write" [shape=box];
    "Phase 6: Output" [shape=box];

    "Resolve input" -> "Phase 1: Discovery";
    "Phase 1: Discovery" -> "Phase 2: Research";
    "Phase 2: Research" -> "Phase 3: Configure";
    "Phase 3: Configure" -> "Phase 4: Outline";
    "Phase 4: Outline" -> "Outline approved?";
    "Outline approved?" -> "Phase 4: Outline" [label="non, réviser"];
    "Outline approved?" -> "Phase 5: Write" [label="oui"];
    "Phase 5: Write" -> "Phase 6: Output";
}

Ne SAUTEZ PAS les phases. Posez des questions à un rythme naturel. Ne submergez pas, mais ne ralentissez pas artificiellement non plus. Si l'utilisateur répond à plusieurs questions à la fois, acceptez ses réponses groupées et passez à la suite.

Si l'utilisateur dit "choisis les valeurs par défaut", "tu choisis" ou une phrase similaire, 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 faites jamais d'hypothèses sans confirmer.

Phase 1 : Découverte

Étape 1 – Analyser l'entrée

Type d'entréeQue lire
Brief marketingLisez le brief – extrayez l'énoncé du problème, la proposition de valeur, le public, les messages clés, le positionnement concurrentiel. Faites toujours l'étape 2 si le brief manque de contexte produit, puis passez à l'étape 3.
PRDiff, description de la PR, commentaires de revue, 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é de la base de codeLisez les fichiers/répertoires spécifiés.
Texte libreAnalysez la description de l'utilisateur. Si elle manque de détails (pas de nom de fonctionnalité, pas de proposition de valeur, pas de contexte), demandez à l'utilisateur de fournir plus de détails ou de pointer vers un fichier/PR spécifique. Revenez aux questions ouvertes uniquement s'il ne peut pas.

Les 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. Les changements internes incluent : refactorisations, ajouts de tests, modifications CI et mises à jour de dépendances. En cas d'incertitude, listez ce que vous avez trouvé et demandez à l'utilisateur ce qui est pertinent.

Gestion des erreurs :

  • gh non installé/authentifié → informez l'utilisateur, suggérez gh auth login, proposez une entrée alternative
  • PR/référence invalide → dites-le à l'utilisateur, demandez 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), références marketing.

Objectif : comprendre ce qu'est le produit, à qui il s'adresse, ce qu'il fait.

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

"Voici ce que j'ai compris :"

  • Fonctionnalité A - courte description
  • Fonctionnalité B - courte description

"Lesquelles de ces fonctionnalités l'article devrait-il couvrir ? Y a-t-il quelque chose à ajouter, supprimer ou corriger ?"

Posez autant de questions que nécessaire pour comprendre pleinement le périmètre. Ne continuez PAS tant que l'utilisateur n'a pas confirmé.

Étape 4 – Signaler les éléments sensibles

Recherchez : les changements cassants, les dépréciations, les correctifs de sécurité, les exigences de migration.

Si trouvé, signalez chaque élément et demandez comment les formuler avant de continuer.

Phase 2 : Recherche concurrentielle d'articles de blog

Avant de configurer l'article, recherchez des articles de blog similaires dans le domaine :

  1. Utilisez WebSearch pour trouver 3 à 5 articles de blog existants couvrant le même sujet, des produits concurrents ou des annonces de fonctionnalités similaires
  2. Analysez ce qui fonctionne et ce qui ne fonctionne pas dans ces articles – structure, titres, accroches, mots-clés SEO, profondeur
  3. Identifiez les lacunes de contenu – ce que les concurrents NE couvrent PAS et que cet article pourrait aborder
  4. Utilisez ces résultats pour éclairer la stratégie SEO, la génération de titres et la structure du contenu

Si WebSearch n'est pas disponible, sautez cette phase et fiez-vous à vos propres connaissances.

Présentez un bref résumé à l'utilisateur :

"J'ai trouvé quelques articles similaires dans le domaine. Voici ce que j'ai remarqué :"

  • [Résultats clés sur ce qui fonctionne]
  • [Lacunes de contenu / opportunités]
  • [Opportunités de mots-clés SEO]

"J'utiliserai ces informations pour façonner l'article."

Phase 3 : Configuration

Posez ces questions :

Q1 – Public : "À qui s'adresse cet article de blog ?" (développeurs, utilisateurs finaux, décideurs techniques, grand public, autre)

Q2 – Ton : Lisez les articles de blog existants, le README et la documentation du dépôt pour détecter la voix du produit. Confirmez ensuite :

"D'après votre contenu existant, le ton semble [par exemple, conversationnel et orienté développeur]. Dois-je m'y conformer ou aller dans une direction différente ?"

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

Q3 – Type d'article : En fonction de l'entrée et du public, recommandez un type d'article et confirmez :

  • Annonce de fonctionnalité – "Nous avons livré X, voici pourquoi c'est important" (~600–1000 mots)
  • Approfondissement technique – "Comment nous avons construit X, les décisions et l'architecture" (~1500–2500 mots)
  • Récit problème-solution – "Vous avez le problème X, voici comment cela le résout" (~1000–2000 mots)

"Compte tenu de [l'entrée/le public], je recommanderais un article de type [type] parce que [raison]. Cela vous convient-il ?"

Q4 – CTA : Déduisez l'appel à l'action le plus approprié du contexte :

  • Open source → donnez une étoile au dépôt, contribuez, essayez-le
  • SaaS → inscrivez-vous, commencez l'essai gratuit
  • Mise à jour de fonctionnalité → essayez la nouvelle fonctionnalité, lisez la documentation
  • Bibliothèque/SDK → installez-le, lisez le guide de migration

"Je suggère que le CTA soit : [CTA déduit]. Voulez-vous le conserver ou autre chose ?"

Q5 – Niveau d'implication : "À quel point souhaitez-vous être impliqué dans le processus d'écriture ?"

  • A) Écrire directement – Je gère tout, choisis le meilleur titre et enregistre l'article final. Vous pouvez demander des modifications après.
  • B) Montrez-moi d'abord le plan – approuvez la structure, puis je rédige l'article complet
  • C) Guidez-moi étape par étape – approbation du plan, puis section par section avec confirmation

Phase 4 : Plan

Générez un plan structuré :

## [Titre de travail]

1. **Accroche/Introduction** - [approche : question/statistique/affirmation audacieuse/histoire]
   - Point clé à établir
   - Transition vers le corps

2. **Nom de la section** - [objectif]
   - Points clés
   - Nombre de mots estimé

3. **Nom de la section** - [objectif]
   - Points clés
   - Nombre de mots estimé

[...autant de sections que nécessaire]

N. **Conclusion** - [résumé + CTA]
   - Point clé à renforcer
   - CTA : [action spécifique]

Total estimé : ~X mots

Si le niveau d'implication est A, générez le plan en interne sans le montrer. Pour B et C, présentez-le et attendez l'approbation.

Phase 5 : Rédaction

Processus d'écriture interne (toujours exécuté, quel que soit le niveau d'implication)

Pour chaque section :

  1. Rédigez la section
  2. Auto-revue : analysez si le contenu pourrait être structuré différemment, s'il manque de contexte nécessaire au lecteur pour le comprendre et l'assimiler, ou s'il présente des lacunes qui dérouteraient quelqu'un qui n'est pas familier avec le sujet
  3. Complément : si des éléments manquants sont trouvés, ajoutez des paragraphes de transition, du contexte, ou restructurez avant de continuer

Si le niveau d'implication est C, présentez chaque section après l'auto-revue et obtenez une confirmation avant de continuer. Pour A et B, exécutez ce processus en silence.

Titres

Une fois le corps terminé, générez 3 à 5 options de titres en utilisant différentes formules :

  • Tutoriel ("Comment [Produit] résout [problème]")
  • Nombre/liste ("3 raisons pour lesquelles [fonctionnalité] change [flux de travail]")
  • Question ("Fatigué de [point douloureux] ?")
  • Affirmation audacieuse ("[Fonctionnalité] est le moyen le plus rapide d'[obtenir un résultat]")
  • Avant/après ("[Problème] → [Résultat] : Comment [fonctionnalité] le rend possible")

Recommandez-en un et expliquez pourquoi il fonctionne le mieux pour le public, le SEO et le contexte de cet article. Expliquez également les compromis des autres options.

Pour les niveaux d'implication B et C, présentez les options et obtenez la sélection de l'utilisateur avant de continuer. Pour le niveau A, utilisez votre recommandation.

Priorisez la lisibilité par rapport aux contraintes SEO. Écrivez d'abord le meilleur titre. S'il ne respecte pas la limite de 50 à 60 caractères du titre SEO, créez une balise titre plus courte séparée pour le frontmatter.

Frontmatter SEO

Générez en tant que frontmatter YAML en haut de l'article :

---
title: "[Titre sélectionné]"
meta_description: "[140–160 caractères, inclut le mot-clé principal, proposition de valeur convaincante]"
primary_keyword: "[mot-clé cible principal]"
secondary_keywords: ["mot-clé1", "mot-clé2", "mot-clé3"]
long_tail_keywords: ["expression plus longue 1", "expression plus longue 2"]
slug: "[slug-optimisé-pour-url]"
---

Règles :

  • Balise titre : 50–60 caractères, mot-clé principal en début
  • Meta description : 140–160 caractères, rédigée pour les humains, inclut une proposition de valeur unique
  • Mots-clés éclairés par la recherche concurrentielle de la phase 2
  • Pas de bourrage de mots-clés – langage naturel uniquement

Règles de formatage du contenu

  • Paragraphes courts : 2–4 phrases maximum
  • Sous-titres : utilisez H2 pour les sections principales, H3 pour les sous-sections. Les sous-titres doivent fonctionner comme un plan pouvant être scanné seuls.
  • Mettez en gras les phrases clés pour soutenir la lecture en modèle F
  • Points de puce et listes pour tout ensemble de 3 éléments ou plus
  • Une idée par paragraphe
  • N'utilisez jamais de tirets cadratins dans le contenu généré. Pas de caractères "—". Utilisez des virgules, des deux-points, des points ou des parenthèses à la place.

Accroche/Introduction

L'introduction comporte trois éléments :

  1. Accroche (1 à 2 premières phrases) – une statistique surprenante, une affirmation audacieuse, un point douloureux auquel le lecteur peut s'identifier, ou une question provocante. Doit créer de la curiosité ou une résonance émotionnelle en moins de 3 secondes de lecture.
  2. Autorité – établissez brièvement pourquoi cela compte ou pourquoi le lecteur devrait faire confiance
  3. Promesse – indiquez clairement ce que le lecteur retirera de cet article

Limitez l'introduction à 3 à 5 courts paragraphes. Pas de murs de texte.

Conclusion

  1. Reformulez le point clé (n'introduisez PAS de nouvelles idées)
  2. Un seul CTA clair avec un verbe d'action ("Essayez maintenant", "Donnez une étoile au dépôt", "Commencez votre essai gratuit")
  3. Terminez éventuellement par une déclaration tournée vers l'avenir ou une question pour susciter la discussion

Contenu visuel

Générez directement lorsque c'est possible :

  • Diagrammes d'architecture → blocs de code mermaid ou SVG en ligne
  • Diagrammes de flux de données → blocs de code mermaid
  • Tableaux comparatifs → tableaux en markdown
  • Exemples de code → blocs de code avec coloration syntaxique

Pour les images nécessitant une création externe :

<!-- TODO : Ajouter une image ici -->
<!-- Suggestion : [description de ce que l'image doit montrer] -->
<!-- Prompt LLM : "[prompt prêt à l'emploi pour un modèle de génération d'images, par exemple "Une illustration minimaliste et propre montrant un tableau de bord avec un bouton de mode sombre, style design plat, esthétique d'outil développeur, ratio 16:9"]" -->
![Description du texte alternatif](placeholder.png)

Utilisez des visuels chaque fois qu'ils aident la compréhension – après avoir expliqué un concept complexe, lors de la comparaison d'options, ou en montrant des modifications de l'interface utilisateur.

Exemples de code

Pour un public de développeurs, incluez au moins un exemple de code montrant la fonctionnalité en action. Privilégiez des extraits minimaux et exécutables (5 à 15 lignes). Montrez l'avant/après lors de la démonstration d'une amélioration.

Phase 5b : Révision du brouillon complet

Après que toutes les sections ont été rédigées et le titre sélectionné, assemblez l'article complet (frontmatter + corps).

  • Niveau A : Ignorez la révision. Passez directement à la sortie. Présentez l'article final et enregistrez-le. L'utilisateur peut demander des modifications après.
  • Niveau B : Présentez le brouillon complet à l'utilisateur pour révision avant de l'enregistrer. "Voici l'article complet. Vous voulez des modifications avant que je l'enregistre ?"
  • Niveau C : L'utilisateur a vu chaque section individuellement, mais présentez tout de même le brouillon assemblé pour une révision finale. "Voici l'article complet. Vous voulez des modifications avant que je l'enregistre ?"

Pour B et C, si l'utilisateur demande des révisions, effectuez-les et présentez à nouveau. Passez à la sortie uniquement après approbation.

Phase 6 : Sortie

Détectez d'abord le répertoire blog existant. Vérifiez la présence de :

  • content/blog/, src/pages/blog/, _posts/, blog/, posts/, articles/

Si trouvé, utilisez ce répertoire. Sinon, utilisez par défaut blog/posts/.

Présentez à l'utilisateur :

"Je vais enregistrer ceci dans [chemin-détecté-ou-par-défaut]/<slug>.md. Vous voulez un autre emplacement, ou dois-je l'afficher uniquement sans l'enregistrer ?"

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
  • Pas de contexte produit → demandez à l'utilisateur de décrire le produit
  • WebSearch non disponible → sautez la phase 2, procédez avec vos propres connaissances
  • Pas de répertoire blog existant → utilisez par défaut blog/posts/, créez-le

Ce que cette compétence NE fait PAS

  • Générer du contenu pour les réseaux sociaux (utilisez /social-copy pour cela)
  • Publier ou déployer l'article sur une plateforme
  • Générer des briefs marketing (utilisez /marketing-brief pour cela)
  • Créer plusieurs variantes pour différents publics – réexécutez la compétence pour un public différent

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 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 write a product update email, feature announcement newsletter, or digest email for users or subscribers

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