Skill Guide pas à pas
La méthode que l'agent Writer de Moonrank applique pour écrire des guides pas à pas qui finissent vraiment le travail — un contrat clair, des étapes testées, des correctifs en ligne et une vérification.
Téléchargez la méthodologie, voyez comment l'agent structure une procédure, ou lancez-la dans l'agent Writer.
- Catégorie
- Writer
- Agent
- Writer Agent
- Format
- how-to-guide.md
- Prix
- Téléchargement gratuit
Le fichier de la skill
Qu'est-ce que la skill Guide pas à pas ?
La skill Guide pas à pas, c'est la façon dont l'agent Writer de Moonrank transforme une tâche en contenu que le lecteur peut terminer : le contrat annoncé d'entrée, une action testée par étape, des captures uniquement aux points de décision, les échecs corrigés en ligne, et une étape de vérification qui lève tout doute.
Elle est écrite au format SKILL.md, un format d'instructions en langage clair que les humains comme les agents IA peuvent suivre. Lisez-la pour réparer les tutoriels dont votre support s'excuse encore, ou laissez l'agent Writer rédiger vos contenus procéduraux à partir de vos briefs.
Le téléchargement est gratuit avec un compte Moonrank. Rédiger les guides et les signaler pour re-test quand le produit change, c'est le travail de l'agent Writer.
En situation
“Notre tutoriel d'installation est n°3 sur Google mais le support reçoit encore 30 tickets par semaine sur ce processus précis. Comment ?”
L'étape 2 du tutoriel cache quatre actions distinctes dans un seul paragraphe, trois étapes n'annoncent aucun résultat attendu — impossible de savoir si elles ont marché — et l'échec le plus fréquent, l'erreur de portée de clé API derrière 19 de vos 30 tickets hebdomadaires, est traité dans une FAQ que personne ne lit. La réécriture : 11 étapes à action unique avec résultat attendu, le symptôme et le correctif de cette erreur placés sous l'étape 5, et une vérification finale. Le volume de tickets chute sans toucher au positionnement.
De l'entrée à la liste de correctifs
- 1
Vous définissez la tâche
Le travail à accomplir, le point de départ du lecteur et l'état terminé vérifiable.
- 2
Moonrank annonce le contrat
Audience, prérequis, état terminé et durée estimée — avant la première étape.
- 3
Il rédige des étapes testées, à action unique
Chaque étape numérotée est une action au résultat visible, écrite en la faisant, pas de mémoire.
- 4
Il anticipe les échecs et vérifie
Symptôme et correctif en ligne sous les étapes qui échouent, puis une étape finale qui confirme le succès.
Tout ce qu'elle vérifie
Le contrat
Pour qui, ce qu'il faut avant de commencer, à quoi ressemble « terminé », et combien de temps.
Étapes à action unique
Une action par numéro, chacune avec son résultat attendu énoncé.
Visuels aux points de décision
Captures ou sorties là où le lecteur peut se tromper — pas de décoration à chaque étape.
Dépannage en ligne
Le symptôme et le correctif sous l'étape qui échoue, pas dans un cimetière de FAQ.
Étape de vérification
Un moyen sans ambiguïté pour le lecteur de confirmer que tout a fonctionné.
La tâche suivante
La seule chose logique qu'un lecteur qui a terminé doit faire ensuite.
Quand y recourir
- Désamorcer les tickets support que votre tutoriel actuel continue de générer.
- Gagner les requêtes « comment faire X » où la page 1 explique au lieu de guider.
- Documenter la place de votre produit dans le travail complet du lecteur.
- Uniformiser le contenu procédural entre docs, blog et centre d'aide.
- Signaler les guides à re-tester dès que le parcours produit change.