# Compétence d'agent de rédaction de blog IA pour Claude Code

> Générez, optimisez et auditez du contenu de blog à grande échelle avec cette compétence d'agent de rédaction de blog IA pour Claude Code. Elle produit des articles doublement optimisés pour le classement Google et les plateformes de citation IA, garantissant un contenu de haute qualité et adapté au référencement à chaque fois.

- Canonical: https://nanoskill.ai/fr/skills/ai-blog-writing-skill
- Markdown: https://nanoskill.ai/fr/skills/ai-blog-writing-skill.md
- Author: AgriciDaniel
- Published: 2026-05-24T06:35:19.314Z
- Updated: 2026-07-25T04:39:13.470Z
- Language: fr
- Source type: github
- Popularity signal: 818

## Sources

- https://github.com/AgriciDaniel/claude-blog

## Install

```shell
npx skills add https://github.com/AgriciDaniel/claude-blog
```

## About

La compétence de rédaction de blog et d'optimisation SEO pour Claude Code, connue sous le nom de claude-blog, est une suite complète conçue pour automatiser et améliorer votre flux de travail de création de contenu. Cette compétence puissante rédige, optimise et audite du contenu de blog à grande échelle, garantissant que chaque article est méticuleusement conçu à la fois pour le classement dans les moteurs de recherche Google et les plateformes de citation IA. C'est un outil indispensable pour quiconque cherche à produire un contenu de haute qualité et adapté au référencement de manière régulière et efficace.

Se distinguant par son solide contrat de livraison à 5 portes, claude-blog garantit la qualité du contenu en notant chaque brouillon par rapport à une grille de 100 points et en bloquant tout ce qui est en dessous de 90. Il offre une double optimisation, visant la conformité avec la mise à jour principale de décembre 2025 et les signaux E-E-A-T pour Google, tout en préparant le contenu pour les plateformes de citation IA comme ChatGPT et Perplexity. Avec 30 sous-compétences, 5 agents et 12 modèles de contenu, il gère l'ensemble du cycle de vie du contenu, de la recherche et du plan à la génération de schéma et à la vérification des citations.

Que vous soyez un blogueur solo visant un article de haute qualité par semaine, une équipe marketing gérant des portefeuilles de contenu diversifiés, ou un créateur de compétences Claude Code à la recherche d'une référence de qualité production, claude-blog fournit des solutions sur mesure. Il prend en charge la planification de clusters de sujets, la publication multilingue, les profils vocaux axés sur la persona, et inclut des fonctionnalités avancées telles que la détection de cannibalisation de mots-clés et un pipeline de vérification des faits pour garantir l'exactitude et prévenir les conflits de contenu.

## Key features

- **Contrat de livraison à 5 portes**: Chaque brouillon passe par un contrat de livraison rigoureux à 5 portes (Capacité, Format, Visuel, Revue du contenu, Intégrité des ressources) avec une grille de 100 points, bloquant tout score inférieur à 90 avant qu'il ne vous parvienne.
- **Optimisation double pour SEO et citations IA**: Chaque article est optimisé pour le classement Google (Mise à jour principale de décembre 2025, E-E-A-T) et les plateformes de citation IA (ChatGPT, Perplexity, AI Overviews), maximisant la visibilité et la citabilité.
- **Génération de contenu complète**: Un moteur de blog couvrant tout le cycle de vie avec 30 sous-compétences, 5 agents et 12 modèles de contenu, couvrant la recherche, le plan, le brouillon, le schéma, les liens internes et la vérification des citations en une seule invocation.
- **Rédaction pilotée par persona et vérification des faits**: Gérez des personas de rédaction configurables avec des cadres de ton et des plages de lisibilité, ainsi qu'un pipeline de vérification des faits qui vérifie les statistiques par rapport aux sources citées pour garantir l'exactitude.
- **Détection de cannibalisation des mots-clés**: Identifiez et résolvez le chevauchement des mots-clés entre articles de blog avec une notation de gravité et des recommandations pour empêcher le contenu de se concurrencer lui-même dans les SERP.

## Use cases

- **Générer des articles de blog de haute qualité**: Les blogueurs et créateurs indépendants peuvent publier un article de haute qualité par semaine sans listes de contrôle SEO manuelles, en gérant la recherche, le plan, le brouillon, le schéma, les liens internes et la vérification des citations.
- **Gérer le contenu à grande échelle pour les équipes**: Les équipes marketing et les agences peuvent gérer de nombreux articles sur différents sujets et langues grâce à des fonctionnalités telles que la planification de clusters thématiques, la publication multilingue et les profils vocaux pilotés par persona.
- **Auditer et optimiser le contenu existant**: Utilisez la compétence pour analyser les articles de blog existants avec un score de qualité de 0 à 100, effectuer une validation SEO post-rédaction et détecter la cannibalisation des mots-clés sur votre site.

## Result preview

Voir une vraie liste des meilleurs outils de présentation IA créée par cette compétence d'agent.

![blog-writing-demo-01](https://file.nanoskill.ai/blog-writing-demo-01)

![blog-writing-demo-02](https://file.nanoskill.ai/blog-writing-demo-02)

![blog-writing-demo-03](https://file.nanoskill.ai/blog-writing-demo-03)

![blog-writing-demo-4](https://file.nanoskill.ai/blog-writing-demo-4)

## Result walkthrough

### Étape 1 : Installer

Ajoutez la compétence à votre agent.

![blog-writing-step-1](https://file.nanoskill.ai/blog-writing-step-1)

### Étape 2 :Générer du contenu

Utilisez une commande spécifique pour générer du contenu de blog.

![blog-writing-step-2](https://file.nanoskill.ai/blog-writing-step-2)

### Étape 3 :Réviser et modifier

Passez en revue le contenu et modifiez-le dans le document Word généré.

![blog-writing-step-03](https://file.nanoskill.ai/blog-writing-step-03)

## Skill definition

# Compétence de rédaction de blog IA et optimisation SEO pour Claude Code (`claude-blog`)

> **Deux versions de cette compétence.** Choisissez celle qui correspond à votre façon de travailler :
>
> - 🌐 **Open-source public** : [`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog). Sous licence MIT, versions publiques, ouvert à tous. Utilisez celle-ci si vous voulez la version stable, téléchargeable, sans adhésion requise.
> - 🔒 **Miroir privé communautaire** (ce dépôt) : [`AI-Marketing-Hub/claude-blog`](https://github.com/AI-Marketing-Hub/claude-blog). Accès anticipé aux travaux en cours de développement (contrat de livraison de blog v1.9.0+, échelle de héros, couverture de régression testée par mutation), et collaboration directe avec la communauté [AI Marketing Hub Pro](https://www.skool.com/ai-marketing-hub-pro). Adhésion requise.
>
> Les badges ci-dessus suivent le **dépôt public** (`AgriciDaniel/claude-blog`) car le miroir privé n'est pas visible par shields.io. Le flux de publication (développement privé, révision, publication publique) est documenté dans [`docs/PUBLISHING.md`](docs/PUBLISHING.md).

> **Blog :** [Voir comment fonctionne claude-blog](https://agricidaniel.com/blog/claude-code-blog-writer)

**claude-blog est une suite de compétences Claude Code qui rédige, optimise et audite du contenu de blog à grande échelle.** Chaque article est doublement optimisé pour le classement Google (mise à jour principale de décembre 2025, E-E-A-T) et les plateformes de citation IA (ChatGPT, Perplexity, AI Overviews). Un contrat de livraison à 5 portes v1.9.0 note chaque brouillon selon une grille de 100 points et bloque tout ce qui est en dessous de 90 avant de vous parvenir.

## Points clés

- **Ce que c'est** : un moteur de blog couvrant tout le cycle de vie : 30 sous-compétences, 5 agents, 12 modèles de contenu, 21 références à la demande, 9 scripts Python de niveau racine, 160 tests réussis.
- **À qui cela s'adresse** : blogueurs solo, équipes marketing, agences et créateurs de compétences Claude Code qui veulent une production de contenu de qualité professionnelle, pas des brouillons uniques.
- **Promesse principale** : chaque brouillon passe un contrat de livraison à 5 portes (Capacité, Format, Visuel, Révision de contenu, Intégrité des actifs) ou le rédacteur itère jusqu'à 3 fois avant de vous transmettre le problème.
- **Ce qui le rend différent** : il utilise son propre produit. La cohérence de version est imposée par CI sur 14 surfaces, l'hygiène de la prose est exécutée à chaque PR, trois suites de régression testées par mutation verrouillent les corrections v1.9.0, et `blog-reviewer` est une porte BLOQUANTE, pas consultative.
- **Aujourd'hui** : v1.9.0, publiée le 2026-05-18. Fonctionne avec Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby et HTML statique.

## À qui s'adresse claude-blog ?

claude-blog sert trois publics avec un seul moteur :

**Blogueurs solo et créateurs** qui veulent publier un article de haute qualité par semaine sans passer trois heures sur la checklist SEO. L'orchestrateur gère la recherche, le plan, le brouillon, le schéma, les liens internes et la vérification des citations en une seule invocation `/blog write`.

**Équipes marketing et agences** gérant de nombreux articles sur différents sujets, langues et plateformes. La compétence fournit la planification de clusters thématiques (`/blog cluster`), la publication multilingue en une seule commande (`/blog multilingual`), la détection de cannibalisation (`/blog cannibalization`), et des profils de voix basés sur les personas (`/blog persona`) afin que le même moteur produise un contenu cohérent dans toute l'équipe.

**Créateurs de compétences Claude Code** qui veulent une référence de qualité professionnelle pour l'architecture des compétences, la répartition des agents, les contrats de livraison et le contrôle CI. Le dépôt démontre le standard ouvert Agent Skills à un niveau de complexité 4 avec 160 tests, la vérification de cohérence des versions, les tests de régression de synchronisation de l'installateur, et le modèle de contrat à 5 portes v1.9.0. Lisez le code source pour vous inspirer ; adaptez les modèles dans vos propres compétences.

## Que produit claude-blog ?

Chaque brouillon est livré sous forme de 8 artefacts dans un seul dossier. Un exemple condensé de la sortie `.md` :

```markdown
---
title: "Where Should a Claude Code Skill Plugin Install Itself?"
description: "A working answer to the install-path question..."
date: "2026-05-18"
author: "Daniel Agrici"
tags: [claude-code, skills, plugins, installation]
canonical: "https://example.com/blog/skill-plugin-install-path"
---

# Where Should a Claude Code Skill Plugin Install Itself?

The short answer: most user-installable Claude Code skill plugins
should ship to `~/.claude/skills/<name>/` for skill content,
`~/.claude/agents/<name>.md` for agents, and
`~/.claude/scripts/<helper>.py` for any Python helpers.

## Key Takeaways
- `~/.claude/skills/` is the SKILL.md surface area.
- `~/.claude/agents/` holds agent markdown files.
- ... (full article, sourced citations, FAQ, schema JSON-LD)
```

En plus du `.md`, le contrat produit également : un `.html` rendu (JSON-LD protégé contre XSS, CSS adaptatif au mode sombre), un `.pdf` (Playwright ou weasyprint), `hero.<ext>` (1200x630, généré via Banana MCP, Gemini, APIs de banques d'images, ou Openverse), 3 captures d'écran à différentes largeurs d'écran (`mobile-375.png`, `tablet-768.png`, `desktop-1280.png`), `review.md` (tableau de bord à 5 catégories avec une ligne BLOQUANTE), et `preflight-report.json` (la piste d'audit complète).

## Table des matières

- [Démo](#demo)
- [Démarrage rapide](#quick-start)
- [Commandes](#commands)
- [Comment se compare claude-blog ?](#how-does-claude-blog-compare)
- [Fonctionnalités](#features)
- [Contrat de livraison (v1.9.0)](#delivery-contract-v190)
- [Architecture](#architecture)
- [Prérequis](#requirements)
- [Foire aux questions](#frequently-asked-questions)
- [Feuille de route](#roadmap)
- [Désinstallation](#uninstall)
- [Intégration](#integration)
- [Documentation](#documentation)
- [Comment citer](#how-to-cite)
- [Sécurité et code de conduite](#security--code-of-conduct)
- [Contribuer](#contributing)
- [Licence](#license)
- [Projets similaires](#related-projects)
- [Auteur](#author)

## Démo

[Regarder la démo sur YouTube](https://www.youtube.com/watch?v=AeLC4iutG8w)

<p align="center">
  <img src="https://raw.githubusercontent.com/AgriciDaniel/claude-blog/main/assets/blog-command-demo.gif" alt="Démo de commande claude-blog : routage des sous-commandes /blog via l'orchestrateur" width="100%">
</p>

---

## Démarrage rapide

> ℹ️ **Quelle version installez-vous ?**
>
> - **Vous n'êtes pas membre d'AI Marketing Hub Pro ?** Installez depuis le dépôt public : [`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog). Toutes les commandes d'installation ci-dessous fonctionnent là-bas. Remplacez simplement `AI-Marketing-Hub/claude-blog` par `AgriciDaniel/claude-blog` et le slug du plugin `claude-blog@ai-marketing-hub-claude-blog` par `claude-blog@agricidaniel-claude-blog`. Les versions publiques y sont publiées ; ce miroir privé est en avance.
> - **Membre Pro ?** Les commandes ci-dessous installent la **version communautaire** avec un accès anticipé aux fonctionnalités en développement. Elles nécessitent une session authentifiée `gh auth login` (ou un jeton d'accès GitHub) avec accès à l'organisation `AI-Marketing-Hub`. Si `/plugin marketplace add` échoue avec une erreur 404, votre compte n'est pas encore dans l'organisation. Envoyez un message privé dans la [communauté Skool](https://www.skool.com/ai-marketing-hub-pro) pour être ajouté.

**Installation du plugin (Claude Code 1.0.33+) :**

```bash
# Add marketplace (one-time)
/plugin marketplace add AI-Marketing-Hub/claude-blog

# Install plugin
/plugin install claude-blog@ai-marketing-hub-claude-blog
```

**Recommandé : cloner, vérifier, puis installer** (vous permet d'inspecter `install.sh` et de fixer une étiquette de version) :

```bash
git clone https://github.com/AI-Marketing-Hub/claude-blog.git
cd claude-blog
git checkout v1.9.0          # pin to a release tag (latest as of 2026-05-18)
chmod +x install.sh && ./install.sh
```

**Installation en une commande (Unix/macOS) :**

```bash
curl -fsSL https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh | bash
```

**Installation en une commande (Windows PowerShell) :**

```powershell
irm https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.ps1 | iex
```

> Exécuter `curl` ou `irm` directement dans un shell donne au script l'autorité d'exécution sur votre machine. La méthode cloner-puis-extraire-étiquette est plus sûre car vous pouvez inspecter ce qui s'exécute. Les deux flux s'authentifient auprès du dépôt privé en utilisant vos informations d'identification `gh auth` / GitHub existantes.

**Vérifier l'intégrité de l'installateur (recommandé, durcissement VULN-IAC-001) :**

```bash
# Download, verify SHA-256, then run if the hash matches.
curl -fsSL -o install.sh https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh
echo "029388e448dd29bed259b130c2be42e2f6a16d4d5b6801a61bfb4f49b621fc04  install.sh" | sha256sum -c
bash install.sh
```

Le SHA-256 ci-dessus correspond au fichier `install.sh` actuel à la tête de `main`. Vérifiez-le par rapport au [fichier canonique](https://github.com/AI-Marketing-Hub/claude-blog/blob/main/install.sh) avant de l'exécuter. Le hachage compagnon `install.ps1` est `6d03f353e5d844c4fe5c7c0b2500bd1e2aad02468cd544013bab876735cebf98`. Les hachages sont mis à jour dans ce README à chaque modification de l'installateur.

Redémarrez Claude Code après l'installation pour l'activer.

## Commandes

> 🚀 **Première fois ? Essayez d'abord ces trois commandes** : `/blog strategy <niche>` pour définir le périmètre de votre blog, `/blog write <topic>` pour générer votre premier article (le contrat à 5 portes s'exécute automatiquement), et `/blog analyze <fichier>` pour le noter selon la grille de 100 points.

<p align="center">
  <img src="https://file.nanoskill.ai/blog-write-demo-8.gif" alt="Démo de /blog write claude-blog : génération d'article de bout en bout avec le contrat de livraison à 5 portes" width="100%">
</p>

<p align="center">
  <img src="https://file.nanoskill.ai/03-sub-skill-map-B-13.svg" alt="Écosystème de sous-compétences claude-blog : orchestrateur central avec 30 sous-compétences organisées en 8 groupes thématiques (rédaction, stratégie, qualité, IA et recherche, multilingue, recherche, médias, distribution) ; la taille des panneaux s'adapte automatiquement au nombre de compétences" width="100%">
</p>

| Commande | Description |
|---------|-------------|
| `/blog write <topic>` | Rédiger un nouvel article de blog à partir de zéro |
| `/blog rewrite <file>` | Optimiser un article de blog existant |
| `/blog analyze <file>` | Audit qualité avec un score de 0 à 100 |
| `/blog brief <topic>` | Générer un brief de contenu détaillé |
| `/blog calendar` | Générer un calendrier éditorial |
| `/blog strategy <niche>` | Stratégie de blog et idéation de sujets |
| `/blog outline <topic>` | Plan de contenu basé sur les SERP |
| `/blog seo-check <file>` | Validation SEO post-rédaction |
| `/blog schema <file>` | Générer un balisage de schéma JSON-LD |
| `/blog repurpose <file>` | Recycler pour les réseaux sociaux, l'email, YouTube |
| `/blog geo <file>` | Audit de préparation aux citations IA |
| `/blog image [generate\|edit\|setup]` | Génération d'images IA via Gemini |
| `/blog audit [directory]` | Évaluation complète de la santé du blog |
| `/blog cannibalization [directory]` | Détecter le chevauchement de mots-clés entre articles |
| `/blog factcheck <file>` | Vérifier les statistiques par rapport aux sources citées |
| `/blog persona [create\|list\|apply]` | Gérer les personas d'écriture et les profils de voix |
| `/blog taxonomy [sync\|audit\|suggest]` | Gestion des étiquettes/catégories CMS |
| `/blog notebooklm <question>` | Interroger NotebookLM pour une recherche basée sur des sources |
| `/blog audio [generate\|voices\|setup]` | Générer une narration audio via Gemini TTS |
| `/blog google [command] [args]` | Données des API Google : PSI, CrUX, GSC, GA4, NLP, YouTube, Mots-clés |
| `/blog cluster [plan\|execute] <seed>` | Planification et exécution de clusters thématiques sémantiques (en étoile) |
| `/blog multilingual <topic> --languages <codes>` | Rédiger, traduire, localiser et générer les hreflang en une seule commande |
| `/blog translate <file> --to <codes>` | Traduction optimisée SEO avec préservation du format |
| `/blog localize <file> --locale <code>` | Adaptation culturelle approfondie par locale |
| `/blog locale-audit <directory>` | AQ du contenu multilingue (exhaustivité, hreflang, parité, fraîcheur) |
| `/blog flow [find\|optimize\|win\|prompts\|sync]` | Invites du cadre FLOW (basées sur des preuves, 30 applicables au blog) |
| `/blog brand [init\|show\|update]` | Générer le contexte BRAND.md + VOICE.md chargé automatiquement par toutes les sous-compétences |
| `/blog discourse <topic>` | Recherche de discours des 30 derniers jours sans API ; produit DISCOURSE.md |

> **30 répertoires de sous-compétences au total** : 29 invocables par l'utilisateur (28 commandes slash distinctes + `/blog update` alias de rewrite) + 1 interne uniquement (`blog-chart`, invoqué par blog-write/blog-rewrite pour les graphiques SVG en ligne). `blog-image` est invocable par l'utilisateur ET appelable en interne.

## Comment se compare claude-blog ?

claude-blog est un pipeline structuré. L'invite directe LLM est ponctuelle. Les outils SaaS hébergés sont à code source fermé. Voici la matrice de compromis honnête :

| Capacité | claude-blog | Invite directe Claude / ChatGPT | Copy.ai / Jasper | À faire soi-même |
|---|:---:|:---:|:---:|:---:|
| Article complet en une commande, avec boucle d'itération | ✅ (contrat à 5 portes, jusqu'à 3 tentatives) | ⚠️ ponctuel | ✅ | ❌ |
| Statistiques sourcées avec vérification | ✅ `/blog factcheck` récupère les URLs sources | ❌ hallucine | ❌ | ⚠️ manuel |
| Optimisation des citations IA (GEO / AEO) | ✅ audit dédié `/blog geo` | ❌ | ❌ | ⚠️ |
| Révision de contenu bloquante (score >= 90 pour livrer) | ✅ agent `blog-reviewer` | ❌ | ❌ | ❌ |
| Multilingue + hreflang en une commande | ✅ `/blog multilingual` | ⚠️ pas de hreflang | ⚠️ | ❌ |
| Planification de clusters thématiques (en étoile) | ✅ `/blog cluster` | ❌ | ⚠️ | ❌ |
| Narration audio | ✅ Gemini TTS, 30 voix | ❌ | ❌ | ❌ |
| Génération d'image héros (échelle en 4 étapes) | ✅ Banana, Gemini, banques d'images, Openverse | ❌ | ⚠️ banques d'images seulement | ⚠️ |
| Contexte de marque et de voix persistant | ✅ BRAND.md + VOICE.md chargés automatiquement | ❌ par invite | ⚠️ limité | ❌ |
| Open source, MIT, sans coût d'utilisation | ✅ gratuit | ❌ abonnement | ❌ abonnement | ✅ |

claude-blog n'est pas meilleur en tout. L'invite directe est plus rapide pour un brouillon jetable unique. Un SaaS hébergé est plus simple pour les non-développeurs. Le bricolage est plus flexible pour des pipelines uniques. claude-blog convient lorsque vous voulez du contenu de qualité professionnelle à grande échelle sans abonnement SaaS.

## Fonctionnalités

### 12 modèles de contenu
Sélectionnés automatiquement par sujet et intention : guide pratique, listicle, étude de cas, comparaison, page pilier, avis produit, leadership éclairé, tour d'horizon, tutoriel, analyse d'actualité, recherche de données, base de connaissances FAQ.

### Notation qualité à 5 catégories (100 points)
| Catégorie | Points | Focus |
|----------|--------|-------|
| Qualité du contenu | 30 | Profondeur, lisibilité, originalité, engagement |
| Optimisation SEO | 25 | Titres, balise titre, mots-clés, liens, méta |
| Signaux E-E-A-T | 15 | Auteur, citations, confiance, expérience |
| Éléments techniques | 15 | Schéma, images, vitesse, mobile, balises OG |
| Préparation aux citations IA | 15 | Citabilité, format Q&R, clarté des entités |

Tranches de notation : Exceptionnel (90-100), Fort (80-89), Acceptable (70-79), En dessous de la norme (60-69), À réécrire (<60). Le contrat v1.9.0 bloque la livraison en dessous de 90.

### Détection de contenu IA
Notation du taux de variation sur la variance de longueur des phrases, détection de phrases IA connues (17 phrases) et diversité du vocabulaire (TTR). Signale le contenu qui semble généré par une machine avant qu'il n'atteigne le réviseur.

### Rédaction basée sur les personas
Personas de rédaction configurables avec le cadre de tonalité NNGroup à 4 dimensions (formel/informel, sérieux/drôle, respectueux/irrévérencieux, factuel/enthousiaste). Gérez les profils vocaux par blog ou par auteur, avec des tranches de lisibilité (Grand public, Professionnelle, Technique) et une application du style au moment de la rédaction.

### Pipeline de vérification des faits
`/blog factcheck` récupère chaque URL source citée et évalue la confiance de l'affirmation comme correspondance exacte, paraphrase ou non trouvée. Garantit que chaque donnée est exacte et traçable, pas inventée.

### Détection de cannibalisation des mots-clés
`/blog cannibalization` identifie le chevauchement des mots-clés entre les articles de blog en utilisant une analyse grep locale ou l'API DataForSEO. La notation de gravité avec des recommandations de fusion ou de différenciation empêche les articles de se concurrencer dans les SERP.

### Gestion de la taxonomie CMS
Synchronisation des étiquettes et catégories prenant en charge WordPress REST, Shopify GraphQL, Ghost, Strapi et Sanity. Comprend des flux de suggestion, de synchronisation et d'audit des étiquettes.

### Double optimisation
Chaque article cible à la fois le classement Google et les plateformes de citation IA :
- **Google** : conformité avec la mise à jour principale de décembre 2025, signaux E-E-A-T, balisage de schéma, liens internes, sensibilisation aux Core Web Vitals via blog-google.
- **Citations IA** : formatage où la réponse précède, capsules de citation, citabilité au niveau des passages (blocs de 120-180 mots), schéma FAQ, clarté des entités.

### Médias visuels
- Recherche d'images sur Pixabay, Unsplash et Pexels avec vérification HTTP 200 et texte alternatif généré automatiquement.
- Génération d'images IA via Gemini pour les images héros, les illustrations en ligne et les cartes sociales. Nécessite une clé API Google AI gratuite.
- Génération de graphiques SVG intégrée en 7 styles (barres, barres groupées, sucette, beignet, ligne, aire, radar).
- Intégration de vidéos YouTube avec chargement différé `srcdoc` et solution de repli noscript pour les robots d'indexation IA.
- Objectifs de densité d'image calibrés par type de contenu.

### Intégration des API Google (v1.6.5+)
13 commandes réparties sur 4 niveaux d'authentification, toutes gratuites en utilisation normale :
- **Niveau 0** (clé API) : PageSpeed Insights, CrUX Core Web Vitals (historique de 25 semaines), recherche vidéo YouTube, analyse d'entités NLP.
- **Niveau 1** (OAuth) : performances Search Console, inspection d'URL, API d'indexation.
- **Niveau 2** (GA4) : rapports de trafic organique.
- **Niveau 3** (Annonces) : Planificateur de mots-clés Google Ads.

### Recherche NotebookLM
Interrogez Google NotebookLM pour une recherche basée sur des sources à partir de documents téléchargés par l'utilisateur. Qualité des données de niveau 1 avec un risque d'hallucination nul car les réponses sont extraites des documents que vous avez téléchargés.

### Narration audio
`/blog audio` génère une narration audio via Gemini TTS. Trois modes : résumé (200-300 mots), article complet, dialogue à deux locuteurs. 30 voix, plus de 80 langues.

### Support des plateformes
Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby et HTML statique.

### Méthodologies fondamentales (v1.8.0)
Cinq documents de référence sous `skills/blog/references/` définissent la méthodologie éditoriale et de recherche appliquée à toutes les sous-compétences. Ils sont chargés à la demande par l'orchestrateur :

| Référence | Objectif | Utilisé par |
|---|---|---|
| `ai-slop-detection.md` | Détection de contenu IA à deux niveaux : premier ordre (phrases) + second ordre (rythme structurel) | `blog-rewrite`, `blog-reviewer`, `blog-analyze` |
| `editorial-heuristics.md` | 10 heuristiques adaptées de Nielsen avec notation de 0 à 4 + étiquetage de gravité P0-P3 | `blog-analyze --rubric` |
| `cognitive-load.md` | Densité de concepts par section (entités, données numériques, jargon, références en avant, profondeur des clauses) | `blog-analyze --cognitive-load`, `scripts/cognitive_load.py` |
| `research-quality.md` | Grille de recherche à 5 dimensions + 4 classes de pièges à mots-clés avant décollage + seuils de fraîcheur | `blog-researcher`, `blog-discourse`, `blog-brief`, `blog-strategy` |
| `synthesis-contract.md` | 6 LOIS régissant la synthèse de recherche (pas de bloc Sources final, citations en ligne, etc.) | Toutes les sous-compétences de synthèse de recherche |

Adapté de `pbakaus/impeccable` (Apache 2.0) et `mvanhorn/last30days-skill` (MIT). Voir [`CONTRIBUTORS.md`](CONTRIBUTORS.md) pour l'attribution.

### Cadre FLOW

Le cadre FLOW (Find, Leverage, Optimize, Win) est le flux de travail basé sur des preuves partagé avec [`AgriciDaniel/flow`](https://github.com/AgriciDaniel/flow) (CC BY 4.0). Chaque phase contribue des invites au pipeline de l'orchestrateur ; `/blog flow` expose 30 invites prêtes à l'emploi indexées par phase.

<p align="center">
  <img src="https://file.nanoskill.ai/04-framework-B-15.svg" alt="Roue radiale du cadre FLOW : quatre phases (Find pour la découverte de sujets, Leverage pour l'amplification des actifs, Optimize pour l'amélioration du contenu, Win pour la conversion des lecteurs) disposées autour d'un moyeu central, avec 10 invites représentatives sur l'anneau extérieur" width="100%">
</p>

## Contrat de livraison (v1.9.0)

<p align="center">
  <img src="https://file.nanoskill.ai/02-pipeline-A-16.svg" alt="Pipeline du contrat de livraison de blog à 5 portes : Découverte des capacités, Complétude du format, Vérification visuelle, Révision du contenu (porte BLOQUANTE, le score doit être de 90 ou plus avec zéro problème P0), et Intégrité des actifs et des liens. Itère jusqu'à 3 fois en cas d'échec avant de transmettre à l'utilisateur" width="100%">
</p>

Chaque blog passe un contrat à 5 portes avant d'être montré à l'utilisateur. L'utilisateur n'est jamais le premier réviseur ; les portes le sont.

| Porte | Applique | Mise en œuvre |
|---|---|---|
| 1. Découverte des capacités | Outils et agents requis présents avant l'écriture | `scripts/blog_preflight.py --gate 1` |
| 2. Complétude du format | `.md` + `.html` + `.pdf` + image héros réelle | `scripts/blog_render.py`, `scripts/generate_hero.py` |
| 3. Vérification visuelle | Pas de débordement SVG, JSON-LD valide, rendu correct en mode sombre | `patchright` / `playwright` à 3 largeurs de fenêtre |
| 4. Révision du contenu (BLOQUANTE) | Score `blog-reviewer` de 90+ ET zéro problème P0 | `agents/blog-reviewer.md` (bloquant, v1.9.0) |
| 5. Intégrité des actifs + liens | Chaque image se résout, og:image existe, les liens renvoient 200, wordCount à moins de 5% | `scripts/blog_preflight.py --gate 5` |

Échelle d'image héros : Banana MCP, API Gemini directe, banques d'images premium (Unsplash, Pexels, Pixabay), API publique Openverse. Le premier disponible gagne. Bloque et itère jusqu'à 3 fois en cas d'échec à une porte avant de transmettre à l'utilisateur. Spécification complète : [`skills/blog/references/blog-delivery-contract.md`](skills/blog/references/blog-delivery-contract.md).

## Architecture

<p align="center">
  <img src="https://file.nanoskill.ai/01-architecture-B-15.svg" alt="Architecture du système claude-blog : pipeline de gauche à droite depuis la commande utilisateur via le routage de l'orchestrateur, l'exécution des sous-compétences et la répartition des agents jusqu'au contrat de livraison à 5 portes avant d'atteindre l'utilisateur" width="100%">
</p>

claude-blog est livré avec un orchestrateur et 29 sous-compétences, 5 agents, 21 références, 12 modèles et 9 scripts de niveau racine. L'orchestrateur achemine les commandes utilisateur vers les sous-compétences, qui génèrent des agents et appellent des scripts via Bash.

| Couche | Nombre | Emplacement |
|---|---:|---|
| Sous-compétences (invoquables par l'utilisateur) | 29 | `skills/blog-*/SKILL.md` |
| Sous-compétences (internes) | 1 | `skills/blog-chart/SKILL.md` |
| Agents spécialisés | 5 | `agents/blog-*.md` |
| Références à la demande | 21 | `skills/blog/references/*.md` |
| Modèles de contenu | 12 | `skills/blog/templates/*.md` |
| Scripts Python de niveau racine | 9 | `scripts/*.py` |
| Tests | 160 | `tests/test_*.py` |

Arborescence complète, diagrammes de flux de données, méthodologie de notation et points d'extension : [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md).

## Prérequis

- Interface en ligne de commande [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installée et configurée.
- Python 3.11+ (pour la notation de la qualité, les exécutants du contrat de livraison à 5 portes et le lint).
- Optionnel : `pip install -r requirements.txt` pour une analyse avancée (notation de la lisibilité, détection de schéma).

### Portes de qualité (imposées par CI à chaque PR)

1. **pytest** : 160 tests couvrant les suites de sécurité, comportementales, de régression et de contrat de livraison.
2. **Validation du plugin** : `claude plugin validate .` plus des vérifications JSON/regex personnalisées.
3. **Lint des chemins obsolètes** : détecte les dérives dans les références croisées de `references/` et `templates/`.
4. **Hygiène de la prose** : `scripts/lint_prose.py` (sensible aux barrières, sensible aux backticks) applique la règle CONTRIBUTING.md pas de tiret cadratin, pas de tiret demi-cadratin, pas de ` -- `.
5. **Cohérence des versions** : `tests/test_version_coherence.py` vérifie que `pyproject.toml`, `plugin.json`, `CITATION.cff` et le frontmatter de `skills/blog/SKILL.md` correspondent tous.
6. **Cohérence des commandes** : `tests/test_command_coherence.py` vérifie que `skills/blog/SKILL.md` et `docs/COMMANDS.md` déclarent le même ensemble de commandes.

Exécutez localement avant de pousser :
```bash
python -m pytest tests/
python3 scripts/lint_prose.py
claude plugin validate .
```

## Foire aux questions

### Qu'est-ce que claude-blog ?
claude-blog est une suite de compétences Claude Code pour la rédaction, l'optimisation et l'audit de contenu de blog. Elle exécute 30 sous-compétences et 5 agents via un contrat de livraison à 5 portes afin que chaque article atteigne une barre de qualité de 90/100 avant de vous parvenir.

### En quoi claude-blog est-il différent d'une invite directe à Claude ou ChatGPT ?
Une invite directe vous donne un brouillon à partir d'une invite. claude-blog vous offre un pipeline structuré : recherche avec statistiques sourcées, approbation du plan, génération du brouillon, notation de qualité en plusieurs passes, détection de contenu IA, vérification des faits, injection de schéma et une révision bloquante qui itère jusqu'à 3 fois avant la livraison. La compétence impose ce qu'un rédacteur en chef ferait autrement manuellement.

### Ai-je besoin d'une adhésion AI Marketing Hub Pro pour utiliser claude-blog ?
Non. La version open source publique sur [`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog) est sous licence MIT et gratuite pour toute personne disposant de Claude Code. Le miroir privé sur `AI-Marketing-Hub/claude-blog` est destiné aux membres Pro qui souhaitent un accès anticipé aux fonctionnalités en développement et une collaboration directe avec la communauté.

### Quelles plateformes de blog claude-blog prend-il en charge ?
Next.js MDX, Astro, Hugo, Jekyll, WordPress, Ghost, 11ty, Gatsby et HTML statique. L'orchestrateur détecte automatiquement la plateforme à partir des signaux du projet et ajuste le frontmatter, l'intégration d'images et l'injection de schéma en conséquence.

### claude-blog hallucine-t-il des statistiques ?
Non. Chaque statistique citée passe par `/blog factcheck`, qui récupère l'URL source et évalue la confiance de l'affirmation (correspondance exacte, paraphrase, non trouvée). L'agent `blog-reviewer` bloque la publication si une citation ne peut pas être vérifiée ou si la détection de contenu IA signale la prose comme générée par une machine.

### Qu'est-ce que le contrat de livraison de blog à 5 portes ?
Un pipeline de pré-présentation imposé par le code qui s'exécute sur chaque brouillon : Découverte des capacités, Complétude du format, Vérification visuelle à 3 largeurs de fenêtre, Révision du contenu (BLOQUANTE ; score de 90+ et zéro P0), et Intégrité des actifs et des liens. L'orchestrateur fait itérer le rédacteur jusqu'à 3 fois en cas d'échec à une porte avant de vous transmettre. Spécification complète dans [`skills/blog/references/blog-delivery-contract.md`](skills/blog/references/blog-delivery-contract.md).

### Puis-je utiliser claude-blog dans plusieurs langues ?
Oui. `/blog multilingual <sujet> --languages en,de,fr,es,ja` rédige l'article, le traduit en préservant le frontmatter et le schéma, exécute une adaptation culturelle approfondie par locale, et génère des balises hreflang ainsi qu'une carte linguistique prête pour le CMS en une seule commande.

### Comment citer claude-blog dans un travail académique ?
Voir la section [Comment citer](#how-to-cite) ci-dessous ou le fichier [`CITATION.cff`](CITATION.cff) à la racine du dépôt. GitHub présente le fichier de citation structuré via le bouton "Cite this repository" sur la page du miroir public.

### claude-blog est-il sûr à installer ?
L'installateur ne livre que des scripts Python et des fichiers markdown, n'exécute jamais de code distant au-delà de ce que `pip install -r requirements.txt` apporte, et est examiné conformément à la politique [`SECURITY.md`](SECURITY.md) du projet à chaque modification. La méthode d'installation cloner-puis-extraire-étiquette vous permet d'inspecter `install.sh` avant de l'exécuter. Voir [`SECURITY.md`](SECURITY.md) pour le modèle de menace complet.

## Feuille de route

<p align="center">
  <img src="https://file.nanoskill.ai/05-roadmap-A-14.svg" alt="Feuille de route des vagues de claude-blog sur une ligne de temps horizontale : fondation v1.6.0 (mars 2026), cadre FLOW v1.7.0 (avril 2026), méthodologie impeccable v1.8.0 (mai 2026), contrat de livraison v1.9.0 (actuel, mai 2026), publication multi-CMS v2.0.0 (T3 2026), blog-as-code v3.0.0 (T1 2027)" width="100%">
</p>

**v1.9.1 (prochaine)**
- Fonction partagée `_count_body_words(html)` entre `blog_render` et `blog_preflight` pour clore le résidu d'audit v1.9.0.
- Sémantique du code de sortie de `generate_hero.py` : non zéro en l'absence de chemin de génération d'image (renvoie actuellement une erreur JSON avec le code de sortie 0).
- Test de couverture de la boucle d'itération vérifiant que l'orchestrateur transmet après 3 BLOCS du réviseur, pas 4.
- Balayer les documents restants (CONTRIBUTORS, NOTICE, SECURITY, PRIVACY, TEMPLATES, TROUBLESHOOTING, MCP-INTEGRATION, DEMO) pour toute dérive résiduelle de strate v1.x.

**v1.10 (vision)**
- Raffinement du plan en direct basé sur les SERP via DataForSEO en cours d'écriture.
- Harnais d'évaluation mesurant la qualité du blog à travers différentes configurations (présence de BRAND.md, variante de persona, mode multilingue).
- Compteur d'itérations imposé par le code (actuellement instruction de l'orchestrateur ; promouvoir au niveau du script).

**v2.0 (long terme)**
- Intégration d'un serveur de prévisualisation sans tête : le contrat à 5 portes s'exécute sur un aperçu de domaine réel au lieu du HTML local.
- Connecteurs de publication CMS par plateforme (WordPress, Ghost, Sanity) avec republication idempotente lors de la réécriture.
- Tableau de bord de suivi des citations IA en temps réel (quels articles sont cités par ChatGPT, Perplexity, AI Overviews ; carte de chaleur de visibilité).

Ouvrez un ticket avec l'étiquette `roadmap` si vous souhaitez proposer ou voter pour quelque chose.

## Désinstallation

Unix/macOS :
```bash
chmod +x uninstall.sh && ./uninstall.sh
```

Windows (PowerShell) :
```powershell
.\uninstall.ps1
```

## Intégration

La génération de graphiques et l'intégration de vidéos YouTube sont intégrées. Les données des API Google nécessitent une clé API gratuite (voir `/blog google setup`).

**Compétences complémentaires optionnelles** (analyse approfondie des pages publiées) :

| Compétence | Intégration |
|-------|-------------|
| `/seo` | Analyse SEO approfondie des pages de blog publiées |
| `/seo-schema` | Validation et génération de balisage de schéma |
| `/seo-geo` | Audit d'optimisation des citations IA |
| `/seo-google` | Données des API Google (configuration partagée avec blog-google) |

## Documentation

La documentation détaillée se trouve dans [`docs/`](docs/) :

- [Guide d'installation](docs/INSTALLATION.md) : Unix, macOS, Windows, installation manuelle.
- [Référence des commandes](docs/COMMANDS.md) : Référence complète des commandes avec exemples.
- [Architecture](docs/ARCHITECTURE.md) : Conception du système et aperçu des composants.
- [Flux de publication](docs/PUBLISHING.md) : Flux de publication privé à public (mainteneurs Pro).
- [Modèles](docs/TEMPLATES.md) : Référence des modèles et personnalisation.
- [Dépannage](docs/TROUBLESHOOTING.md) : Problèmes courants et solutions.
- [Intégration MCP](docs/MCP-INTEGRATION.md) : Configuration optionnelle du serveur MCP.

## Comment citer

Si vous utilisez claude-blog dans le cadre de recherches ou en production, veuillez citer le projet :

```bibtex
@software{Agrici_claude_blog_2026,
  author       = {Agrici, Daniel},
  title        = {claude-blog: AI Blog Writing and SEO Optimization Skill for Claude Code},
  year         = {2026},
  url          = {https://github.com/AgriciDaniel/claude-blog},
  version      = {1.9.0},
  license      = {MIT}
}
```

GitHub présente également le fichier structuré [`CITATION.cff`](CITATION.cff) via "Cite this repository" sur la page du miroir public.

## Sécurité et code de conduite

- **Politique de sécurité + modèle de menace** : [`SECURITY.md`](SECURITY.md). Le passage de durcissement v1.8.x a fermé toutes les vulnérabilités connues ; v1.9.0 ajoute un JSON-LD protégé contre XSS, le refus de liens symboliques O_NOFOLLOW et la validation du frontmatter, le tout vérifié par tests de mutation. Pour signaler une vulnérabilité en privé, suivez la procédure de divulgation dans [`SECURITY.md`](SECURITY.md).
- **Code de conduite** : [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md). Pacte des contributeurs. Soyez excellents les uns envers les autres.

## Contribuer

Les contributions sont les bienvenues. Voir [`CONTRIBUTING.md`](CONTRIBUTING.md) pour les directives. Avant d'ouvrir une PR :

1. Exécutez `python -m pytest tests/` (les 160 doivent passer).
2. Exécutez `python3 scripts/lint_prose.py --root .` (zéro violation).
3. Exécutez `claude plugin validate .` (doit passer).
4. Incrémentez les versions de manière cohérente si vous modifiez des comptes ou des comportements visibles par l'utilisateur (voir [`docs/PUBLISHING.md`](docs/PUBLISHING.md)).

## Licence

Licence MIT. Voir [`LICENSE`](LICENSE) pour plus de détails.

## Projets similaires

- **[Rankenstein](https://rankenstein.pro)** : Flux de travail de publication de contenu basé sur une interface graphique ; de la recherche à la publication sur une seule plateforme.
- **[Cadre FLOW](https://github.com/AgriciDaniel/flow)** : Invites Find, Optimize, Win basées sur des preuves (CC BY 4.0). Intégré en tant que sous-compétence via `/blog flow`.
- **[Claude Ads](https://github.com/AgriciDaniel/claude-ads)** et **[Claude SEO](https://github.com/AgriciDaniel/claude-seo)** : compétences sœurs partageant le même kit de marque (bannière + diagrammes générés avec la palette orange de la marque).
- **[AI Marketing Hub](https://www.skool.com/ai-marketing-hub)** : Communauté gratuite, plus de 2 800 membres. Le niveau Pro sur [`ai-marketing-hub-pro`](https://www.skool.com/ai-marketing-hub-pro) héberge le miroir privé de cette compétence.

## Historique des étoiles

<a href="https://star-history.com/#AgriciDaniel/claude-blog&Date">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date&theme=dark" />
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" />
    <img alt="Historique des étoiles d'AgriciDaniel/claude-blog sur GitHub" src="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" />
  </picture>
</a>

Si claude-blog vous fait gagner du temps, une étoile sur le [dépôt public](https://github.com/AgriciDaniel/claude-blog) est le moyen le plus simple de dire merci (et aide d'autres créateurs de contenu à le trouver).

## Auteur

Créé par [Daniel Agrici](https://agricidaniel.com/about), architecte de flux de travail IA, avec Claude Code.

- [Blog](https://agricidaniel.com/blog) : Plongées approfondies sur l'automatisation du marketing IA.
- [YouTube](https://www.youtube.com/@AgriciDaniel) : Tutoriels et démos.
- [Tous les outils open source](https://github.com/AgriciDaniel) : Autres compétences Claude Code.
- [AI Marketing Hub](https://www.skool.com/ai-marketing-hub) : Communauté gratuite pour le marketing alimenté par l'IA.

## FAQ

### Qu'est-ce que la compétence claude-blog ?

claude-blog est une suite de compétences Claude Code conçue pour rédiger, optimiser et auditer du contenu de blog à grande échelle. Elle garantit que chaque article est doublement optimisé pour le classement Google et les plateformes de citation d'IA.

### À qui s'adresse cette compétence de rédaction de blog IA ?

Elle est destinée aux blogueurs et créateurs indépendants qui souhaitent publier efficacement des articles de haute qualité, aux équipes marketing et agences gérant de grands portefeuilles de contenu, et aux constructeurs de compétences Claude Code cherchant une référence de qualité production pour l'architecture des compétences.

### Comment fonctionne le contrat de livraison à 5 portes ?

Le contrat de livraison à 5 portes évalue chaque brouillon selon une grille de 100 points couvrant la capacité, le format, l'aspect visuel, la revue du contenu et l'intégrité des ressources. Tout brouillon obtenant un score inférieur à 90 est bloqué et le rédacteur itère jusqu'à trois fois avant de vous remonter le problème.

### Quel type de contenu claude-blog produit-il ?

Il produit 8 artefacts dans un seul dossier, comprenant un fichier markdown avec titre, description, date, auteur, balises et URL canonique, ainsi que le HTML rendu, PDF, images héros, captures d'écran, une fiche d'évaluation et un rapport d'audit pré-vol.

### Cette compétence peut-elle gérer du contenu multilingue ?

Oui, il prend en charge la publication multilingue en une seule commande, y compris la rédaction, la traduction, la localisation et l'émission de hreflang. Il offre également une traduction optimisée pour le SEO avec préservation du format et adaptation culturelle approfondie par langue.

### Comment claude-blog assure-t-il la qualité et l'exactitude du contenu ?

Il utilise un système de notation de qualité en 5 catégories, une détection de contenu IA pour signaler la prose générée par machine, une rédaction pilotée par persona avec application du style, et un pipeline de vérification des faits qui vérifie les statistiques par rapport aux sources citées.