Générateur d'articles de centre d'aide - transformez les tickets en docs — Claude Skill

Générateur d'articles de centre d'aide

Transformez les tickets support en réponses self-serve. Prend les questions répétées, docs de fonctionnalités ou specs produit et génère des articles de centre d'aide qui réduisent le volume de tickets.

Conçu pour : équipes early-stage où les mêmes 20 questions représentent 80% des tickets support et où personne n'a le temps d'écrire les docs d'aide. L'objectif est de transformer un après-midi de génération d'articles en plusieurs mois de ticket deflection.

Quand l'utiliser

• « Écris des articles de centre d'aide pour nos principales questions support »
• « Transforme ces tickets support en articles FAQ »
• « Génère la doc pour [fonctionnalité] »
• « Construis notre base de connaissances »
• « Notre volume support est trop élevé : aide-moi à créer du contenu self-serve »

Phase 0 : collecte

Source de contenu, fournissez une ou plusieurs options

1. Export de tickets support — CSV/liste de tickets récents : sujet, description, résolution. Le skill les regroupe pour trouver les sujets récurrents prioritaires.
2. Liste FAQ — vous connaissez déjà les principales questions ? fournissez-les directement.
3. Documentation de fonctionnalité — docs internes, PRD ou specs de fonctionnalités qui ont besoin d'articles client-facing.
4. Walkthrough produit — décrivez le workflow étape par étape et le skill génère l'article.
5. Articles existants à améliorer — URLs ou texte des articles actuels à réécrire.

Configuration

6. Nom du produit — comment s'appelle le produit ?
7. Audience — qui lit ces articles ? utilisateurs techniques, non techniques, mixte
8. Ton — casual/friendly, professionnel, technique/developer-docs ?
9. Structure d'article préférée :
   • Standard — Vue d'ensemble -> Étapes -> Troubleshooting -> Articles liés
   • Développeur — Vue d'ensemble -> Référence API -> Exemples de code -> Erreurs
   • Quick start — Quoi -> Pourquoi -> Comment (3 étapes max) -> Ensuite
10. Convention de captures — utilisez-vous des screenshots ? Le skill insérera des champs réservés [Screenshot: description]
11. Batch ou single ? — un article ou plusieurs depuis un export de tickets ?

Phase 1 : clustering des sujets, mode batch

Si un export de tickets est fourni, regroupez les tickets en sujets d'articles :

Approche de clustering

1. Regrouper par similarité — tickets aux sujets/descriptions similaires
2. Classer par fréquence — clusters les plus fréquents = articles prioritaires
3. Identifier le type d'article par cluster :

Sortie des clusters

CLUSTERS DE SUJETS, classés par fréquence de tickets :

1. [Sujet] — [N tickets] — Type : [How-to]
   Formulation fréquente : « [Comment les clients posent cette question] »
   Pattern de résolution : [Ce que le support répond habituellement]

2. [Sujet] — [N tickets] — Type : [Troubleshooting]
   ...

3. ...

Phase 2 : génération de l'article

Template d'article — How-to

# [Titre orienté action — ex. « Comment configurer l'intégration email »]

[Vue d'ensemble en 1-2 phrases : ce que couvre l'article et pour qui]

**Temps nécessaire :** [X minutes]
**Prérequis :** [Ce qu'il faut avant de commencer — ex. « accès admin, clé API »]

---

## Étape 1 : [verbe d'action + quoi faire]

[1-2 phrases expliquant cette étape]

[Screenshot: Description de ce que l'utilisateur doit voir — ex. « page Settings avec l'onglet Integrations surligné »]

> **Astuce :** [contexte utile ou raccourci]

## Étape 2 : [verbe d'action + quoi faire]

[Instructions]

[Screenshot: Description]

## Étape 3 : [verbe d'action + quoi faire]

[Instructions]

---

## Vérifier que cela fonctionne

[Comment confirmer que la configuration a réussi]

[Screenshot: Description de l'état de succès]

---

## Troubleshooting

### [Problème fréquent 1]
**Symptôme :** [ce que voit l'utilisateur]
**Cause :** [pourquoi cela arrive]
**Correction :** [résolution étape par étape]

### [Problème fréquent 2]
**Symptôme :** [...]
**Cause :** [...]
**Correction :** [...]

---

## FAQ

**Q : [Question de suivi fréquente]**
R : [Réponse]

**Q : [Autre question fréquente]**
R : [Réponse]

---

## Articles liés

- [[Titre de l'article]] — [description en une ligne du moment où le lire]
- [[Titre de l'article]] — [...]

Template d'article — Troubleshooting

# Fix : [Description du problème — ex. « Emails qui ne partent pas »]

[1-2 phrases : quand ce problème apparaît]

---

## Correction rapide

Essayez ceci d'abord, cela résout environ 80% des cas :

1. [Correction la plus fréquente — étape 1]
2. [Étape 2]
3. [Vérifier]

---

## Si cela ne fonctionne pas

### Vérification 1 : [premier point à vérifier]
[Comment vérifier + quoi chercher]

OK si [résultat attendu] -> ce n'est pas le problème. Passez à la vérification 2.
Sinon si [résultat inattendu] -> [correction spécifique à ce cas]

### Vérification 2 : [deuxième point à vérifier]
[Comment vérifier]

OK -> passez à la vérification 3.
Sinon -> [correction]

### Vérification 3 : [troisième point à vérifier]
[Comment vérifier]

OK -> passez à « Toujours bloqué ? »
Sinon -> [correction]

---

## Toujours bloqué ?

Si rien ci-dessus ne résout le problème :

1. [Information à collecter — ex. « capture du message d'erreur »]
2. [Où demander de l'aide — ex. « envoyez un email à [email protected] avec ces infos »]
3. [Délai de réponse attendu]

---

## Pourquoi cela arrive

[2-3 phrases expliquant la cause racine pour les utilisateurs curieux. Optionnel, mais cela renforce la confiance.]

## Articles liés

- [[Article]] — [Contexte]

Template d'article — Getting Started / Quick Start

# Bien démarrer avec [Fonctionnalité/Produit]

[1 phrase : ce que vous aurez accompli à la fin du guide]

**Temps :** [X minutes] | **Difficulté :** [Débutant/Intermédiaire]

---

## Ce qu'il vous faut

- [Prérequis 1]
- [Prérequis 2]

---

## Étape 1 : [Première chose à faire] (2 min)

[Instructions claires]

[Screenshot: Description]

## Étape 2 : [Deuxième chose] (3 min)

[Instructions]

## Étape 3 : [Troisième chose] (2 min)

[Instructions]

---

## C'est prêt !

[Ce que l'utilisateur peut faire maintenant]

**Étapes suivantes :**
- [Prochaine action logique — lien vers l'article suivant]
- [Astuce power user — lien vers article avancé]
- [Rejoindre la communauté — lien si applicable]

Phase 3 : contrôle qualité de l'article

Pour chaque article généré, vérifiez :

• Titre orienté action — commence par « Comment », « Fix : », « Bien démarrer » ou « Comprendre »
• Scannable — headers, étapes numérotées, termes clés en gras. Pas de murs de texte.
• Complet — couvre tout le workflow, pas seulement le happy path
• Troubleshooting inclus — au moins 2 scénarios d'échec fréquents
• Pas de jargon — utilise le langage client, pas les termes internes
• champs réservés screenshots — chaque étape UI a un champ réservé
• Articles liés — références croisées pour garder les utilisateurs dans le centre d'aide
• Search-friendly — titre et premier paragraphe contiennent les mots-clés réellement recherchés par les clients

Phase 4 : sortie

Mode article unique

Enregistrez dans clients/<client-name>/customer-success/help-center/[article-slug].md

Mode batch

Enregistrez dans :

• clients/<client-name>/customer-success/help-center/ — un fichier par article
• clients/<client-name>/customer-success/help-center/_index.md — table des matières avec catégories

Template d'index

# Centre d'aide — [Nom du produit]
Généré : [DATE] | Articles : [N]

## Bien démarrer
- [[getting-started-guide.md]] — Walkthrough de première configuration
- [[quick-start.md]] — Quick start en 5 minutes

## Guides how-to
- [[how-to-setup-email.md]] — Configurer l'intégration email
- [[how-to-invite-team.md]] — Inviter des membres d'équipe
- ...

## Troubleshooting
- [[fix-emails-not-sending.md]] — Emails qui ne partent pas
- [[fix-login-issues.md]] — Impossible de se connecter
- ...

## Référence
- [[api-rate-limits.md]] — Limites et quotas API
- [[billing-plans.md]] — Comparaison des plans et FAQ facturation

Coût

Outils requis

Aucun. Skill de raisonnement pur : prend l'input brut et produit des articles structurés.

Phrases de déclenchement

• « Écris des articles de centre d'aide depuis nos tickets support »
• « Génère la doc pour [fonctionnalité] »
• « Construis notre base de connaissances »
• « Transforme nos FAQ en articles d'aide »
• « Lance le générateur d'articles de centre d'aide »