From pm-delivery
Create professional French documentation articles for Mayday's help center. Use when the user wants to write help documentation, says "rédige un article de doc", "crée la documentation", "écris l'article d'aide", or "génère la doc utilisateur".
How this skill is triggered — by the user, by Claude, or both
Slash command
/pm-delivery:delivery-documentationThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Ce skill vous aide à créer des articles de documentation Mayday professionnels en français, formatés selon les standards du centre d'aide Mayday (documentation.mayday.fr). Il guide l'utilisateur à travers un processus structuré : analyse des documents produit, validation du wording, proposition d'une architecture d'articles, puis rédaction itérative avec feedback.
Ce skill vous aide à créer des articles de documentation Mayday professionnels en français, formatés selon les standards du centre d'aide Mayday (documentation.mayday.fr). Il guide l'utilisateur à travers un processus structuré : analyse des documents produit, validation du wording, proposition d'une architecture d'articles, puis rédaction itérative avec feedback.
Le skill est conçu pour :
Demandez à l'utilisateur de fournir trois documents sources :
Si l'utilisateur ne fournit pas ces trois documents, demandez-les explicitement. Ces sources sont essentielles pour comprendre la feature et extraire le bon wording.
Format accepté : PDF, Markdown, liens Notion, Google Docs, ou fichiers texte.
Une fois les documents reçus, analysez-les pour identifier :
Créez une liste structurée de tous les wordings détectés, par exemple :
WORDINGS DÉTECTÉS :
Fonctionnalités :
- "Élément transverse" (ou "Élément partagé" / "Contenu réutilisable" ?)
- "Bibliothèque d'éléments transverses" (ou autre terme ?)
Actions :
- "Insérer un élément" (ou "Ajouter" / "Importer" ?)
- "Transformer en élément transverse" (dans le menu contextuel)
Sections interface :
- Bouton "Éléments transverses" (dans la barre latérale)
- Menu "Ajouter un contenu"
Présentez cette liste à l'utilisateur et demandez-lui de valider ou corriger chaque terme. Attendez sa validation avant de passer à l'étape suivante.
⚠️ Point critique : Le wording doit être validé AVANT de rédiger quoi que ce soit. Des termes incorrects dans la documentation créent de la confusion pour les utilisateurs finaux.
Après validation du wording, proposez une structure d'articles :
Format de proposition :
STRUCTURE PROPOSÉE : 6 articles
Article 1 : Introduction aux éléments transverses
Article 2 : Comment créer un élément transverse
Article 3 : Comment insérer un élément transverse
Article 4 : Comment gérer et maintenir un élément transverse
Article 5 : Comment suivre l'utilisation d'un élément transverse
Article 6 : Comment gérer le multilingue avec les éléments transverses
Demandez validation : "Cette structure vous convient-elle, ou souhaitez-vous modifier le nombre d'articles ou leurs titres ?"
Attendez la validation avant de continuer.
Pour chaque article validé, proposez un plan détaillé multi-niveaux avec bullets longs si nécessaire.
Niveau de détail requis : Niveau 3 minimum, rentrer vraiment dans le contenu.
Exemple de plan détaillé :
ARTICLE 2 : Comment créer un élément transverse
👋 Introduction
- Contexte : L'utilisateur veut centraliser une information
- Bénéfice : Créer une seule fois, réutiliser partout
- Annonce des deux méthodes disponibles
🤔 Comment ça marche ?
- Présentation des deux approches principales
🆕 Création à partir de zéro
- Étape 1 : Accéder à la bibliothèque
* Localisation : Bouton "Éléments transverses" dans barre latérale
* Contexte : Disponible depuis n'importe quelle collection
- Étape 2 : Cliquer sur "Ajouter un contenu"
* Similarité avec création d'article classique
- Étape 3 : Renseigner un titre clair et explicite
* Importance du titre pour la recherche
* Exemples de bons vs mauvais titres
- Étape 4 : Rédiger le contenu à partager
* Utilisation de l'éditeur Mayday
* Fonctionnalités disponibles (formatage, images, tableaux)
♻️ Création à partir d'un contenu existant
- Cas d'usage : Réutiliser un paragraphe existant
- Étape 1 : Sélectionner le contenu à extraire
* Types de contenu supportés (texte, tableau, image)
- Étape 2 : Cliquer sur "Transformer en élément transverse"
* Localisation dans le menu contextuel
- Étape 3 : Donner un titre à l'élément
- Étape 4 : Sélectionner la collection de destination
✨ Bonnes pratiques
- Rédaction : Contenu autonome, éviter références locales
* Exemple : Ne pas dire "comme mentionné ci-dessus"
* Rester concis et aller à l'essentiel
- Titrage : Titres descriptifs pour faciliter la recherche
* Exemple : "Politique de retour" meilleur que "Retours"
Présentez ce plan détaillé pour tous les articles d'un coup, puis demandez validation : "Ces plans détaillés vous conviennent-ils ?"
Attendez la validation. Si l'utilisateur demande des modifications, ajustez les plans et revalidez.
Une fois les plans validés, rédigez les articles un par un dans l'ordre.
Processus pour chaque article :
Important : Ne passez à l'article suivant que lorsque l'article en cours est complètement validé par l'utilisateur.
Rappel du plan : Après validation de chaque article, rappelez le plan global avec indication de la progression :
✅ Article 1 : Introduction aux éléments transverses [VALIDÉ]
✅ Article 2 : Comment créer un élément transverse [VALIDÉ]
⏳ Article 3 : Comment insérer un élément transverse [EN COURS]
⬜ Article 4 : Comment gérer et maintenir un élément transverse
⬜ Article 5 : Comment suivre l'utilisation d'un élément transverse
⬜ Article 6 : Comment gérer le multilingue avec les éléments transverses
Une fois tous les articles validés, générez un fichier markdown consolidé contenant tous les articles dans l'ordre.
Format du fichier consolidé :
# Documentation Mayday : [Nom de la feature]
---
## Article 1 : [Titre]
[Contenu complet de l'article 1]
---
## Article 2 : [Titre]
[Contenu complet de l'article 2]
---
[... etc pour tous les articles]
Sauvegardez ce fichier dans le dossier de travail de l'utilisateur et donnez le lien computer:// à l'utilisateur.
Tous les articles doivent respecter ces règles impérativement :
Chaque article doit suivre cette structure :
👋 Introduction
[Contexte, problème résolu, annonce du contenu]
[Sections métier avec emojis]
[Contenu principal organisé en sections thématiques]
ℹ️ Pour en savoir plus
[Si plusieurs articles : liens vers les autres articles de la série]
Titres et dividers :
---) sous chaque titre (H1, H2, H3)Exemple de formatage correct :
## 🆕 Création à partir de zéro
---
La création d'un élément transverse se fait depuis la bibliothèque d'éléments transverses de Mayday.
Étapes à suivre :
1. Accédez à la bibliothèque
2. Cliquez sur "Ajouter un contenu"
## ♻️ Création à partir d'un contenu existant
---
Vous avez déjà rédigé un excellent paragraphe dans un article et souhaitez le réutiliser ailleurs ?
Prose vs Bullets :
Exemple - MAUVAIS (trop de bullets) :
Les éléments transverses sont particulièrement utiles pour :
- Centraliser des informations communes
- Politiques d'entreprise
- Disclaimers légaux
- Coordonnées de contact
- Maintenir des procédures transverses
- Procédures d'escalade
- Étapes de dépannage
Exemple - BON (prose + bullets judicieux) :
Les éléments transverses sont particulièrement utiles pour centraliser des informations communes (politiques d'entreprise, disclaimers légaux, coordonnées de contact) et maintenir des procédures transverses utilisées dans plusieurs contextes.
**Exemples concrets** :
- Politique de retour : Créez-la une fois, insérez-la dans 15 articles. Une modification met à jour les 15 instantanément ✨
- Procédure d'escalade : Synchronisée automatiquement dans tous les guides support
Obligatoires pour tous les titres de sections. Choisissez des emojis pertinents et cohérents.
Exemples d'emojis par type de section :
Utilisez des callouts pour les informations importantes :
Info/Note :
ℹ️ **Bon à savoir** : Les modifications sont enregistrées automatiquement.
Attention/Warning :
⚠️ **Point critique** : Lors de l'insertion, vous devez sélectionner manuellement la bonne version linguistique.
Astuce/Tip :
💡 **Astuce** : Utilisez Ctrl+clic (Cmd+clic sur Mac) pour ouvrir un article dans un nouvel onglet.
Incluez toujours des exemples concrets et réalistes pour illustrer les concepts abstraits.
Exemple - MAUVAIS (abstrait) :
Les éléments transverses sont utiles pour centraliser du contenu.
Exemple - BON (concret) :
**Exemple** : Votre politique de retour apparaît dans 15 articles. Créez-la une fois comme élément transverse et insérez-la partout. Lorsque la politique change, une seule modification met à jour les 15 articles instantanément. ✨
Si vous créez plusieurs articles sur une même feature, ajoutez une section finale avec liens vers les autres articles :
ℹ️ Pour en savoir plus, consultez la documentation dédiée aux éléments transverses :
- Article 1 : Introduction aux éléments transverses
- Article 2 : Comment créer un élément transverse
- Article 3 : Comment insérer un élément transverse
- Article 4 : Comment gérer et maintenir un élément transverse
- Article 5 : Comment suivre l'utilisation d'un élément transverse
- Article 6 : Comment gérer le multilingue avec les éléments transverses
Note : Laissez les liens vides (pas d'URLs) - ils seront ajoutés par l'équipe Mayday lors de la publication.
Pour vous inspirer du style Mayday, consultez les exemples de référence :
references/example_article_1_introduction.md : Exemple d'article d'introductionreferences/example_article_2_howto.md : Exemple d'article "Comment faire"Ces exemples montrent le ton, la structure, et le formatage attendus.
Les articles de documentation sont un contenu public (documentation.mayday.fr). Respecter impérativement les guidelines de la marque Mayday.
Lire : shared/brand-voice/mayday-brand-voice-guidelines.md (depuis la racine du repo)
Règles critiques pour ce contexte (ton : "clair, orienté bénéfice") :
Avant de présenter chaque article à l'utilisateur, vérifiez :
✅ Wording : Tous les termes validés sont utilisés correctement
✅ Structure : Introduction + Sections métier + Pour en savoir plus
✅ Emojis : Présents dans tous les titres de sections
✅ Dividers : --- sous chaque titre (H1, H2, H3)
✅ Espacement : Ligne vide entre section et prochain titre
✅ Ton : Vouvoiement, chaleureux, accessible
✅ Prose : Préférée aux bullets excessifs
✅ Exemples : Concrets et réalistes
✅ Callouts : Utilisés pour les points importants
✅ Langue : 100% français
✅ Brand voice : Conforme aux guidelines Mayday (voir shared/brand-voice/mayday-brand-voice-guidelines.md)
Lorsque l'utilisateur active ce skill, commencez par :
👋 Bonjour ! Je vais vous aider à créer la documentation Mayday pour votre feature.
Pour commencer, j'ai besoin de trois documents :
1. **Product brief** : Description de la feature, contexte, objectifs
2. **Success toolkit** : Guide d'utilisation, cas d'usage, bonnes pratiques
3. **Board d'user stories** : Stories techniques, acceptance criteria
Pouvez-vous me fournir ces documents ? (PDF, Markdown, liens Notion, Google Docs acceptés)
Si la feature est simple et ne nécessite qu'un seul article, suivez quand même le processus :
Si la feature nécessite plus de 6 articles, proposez une organisation en "groupes thématiques" :
STRUCTURE PROPOSÉE : 8 articles
Groupe "Introduction et concepts"
- Article 1 : Introduction
- Article 2 : Concepts clés
Groupe "Utilisation"
- Article 3 : Créer
- Article 4 : Insérer
- Article 5 : Modifier
- Article 6 : Supprimer
Groupe "Cas avancés"
- Article 7 : Multilingue
- Article 8 : Permissions
Si l'utilisateur demande de mettre à jour de la doc existante :
example_article_1_introduction.md : Exemple complet d'article d'introductionexample_article_2_howto.md : Exemple complet d'article "Comment faire"Provides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
npx claudepluginhub mathieu-cozian/mathieu-pm-toolkit --plugin pm-delivery