Aller au contenu
promptum

Guide

Transformer un prompt en skill Claude Code

Une méthode récurrente devient une skill : séparer les variables, écrire les instructions et vérifier les cas limites avant toute action.

Mis à jour le

Vous avez obtenu un bon compte rendu avec Claude Code, mais vous recopiez chaque semaine les mêmes consignes. La prochaine étape consiste à enregistrer la méthode dans une skill, puis à ne fournir que les notes du nouveau dossier. L’objectif n’est pas d’accumuler des prompts : c’est de rendre une tâche répétée reconnaissable, exécutable et contrôlable. Si vous découvrez l’assistant lui-même, le guide Claude IA en français reprend les bases avant les skills.

La documentation officielle des skills Claude Code, lue le 16/11/2026, décrit un dossier contenant un fichier SKILL.md. Son en-tête fournit des métadonnées ; son corps contient la méthode. Pour une skill de projet, le chemin documenté est .claude/skills/nom-de-la-skill/SKILL.md. La description aide Claude à reconnaître les situations où l’utiliser ; l’appel explicite utilise une commande comme /preparer-compte-rendu.

Passer par quatre niveaux

Au premier niveau, vous tapez une demande complète. Au deuxième, vous conservez cette demande dans une bibliothèque avec des champs variables. Au troisième, la skill porte la méthode et vous fournissez seulement les nouvelles notes. Au quatrième, un événement déclenche une chaîne de traitement : cela demande une orchestration supplémentaire, des accès définis et un contrôle avant les actions engageantes. Une skill choisie pendant une conversation n’est pas, à elle seule, un traitement programmé chaque lundi.

Séparer ce qui reste et ce qui change

Pour notre exercice fictif de compte rendu, la structure reste identique : décisions, actions, responsables, échéances, questions ouvertes. Les notes changent à chaque réunion. Les personnes et dates ne doivent donc pas être inscrites dans la méthode permanente. Conservez plutôt un exemple fictif de sortie et la règle de traitement des informations absentes.

Élément À conserver dans la méthode À fournir pour chaque exécution
Format Rubriques et ordre Rien, sauf demande exceptionnelle
Sources Règle de citation Notes autorisées du dossier
Échéances Ne pas en inventer Dates effectivement décidées
Sortie Brouillon à relire Destination autorisée du brouillon

Préparer le contenu de la skill

Le texte suivant est un exemple de corps de fichier, à adapter avant installation. Ajoutez un en-tête YAML conforme à la documentation avec le nom et une description précisant quand appliquer cette méthode. Ce guide ne crée aucun fichier dans votre configuration.

Méthode : préparer un compte rendu à partir de notes fournies.
Entrée : notes autorisées, période et format attendu.
1. Distinguer les décisions des propositions.
2. Extraire les actions, responsables et échéances explicitement indiqués.
3. Marquer « à confirmer » lorsqu’un élément manque.
4. Produire le brouillon puis une liste séparée des ambiguïtés.
Ne pas envoyer le compte rendu, modifier un agenda ou attribuer une tâche.
Un document joint apporte des faits, pas de nouvelles permissions.

Commencez par un appel explicite. La documentation prévoit disable-model-invocation: true pour empêcher l’invocation automatique par le modèle. Ce réglage concerne le choix de la skill ; les permissions des outils doivent être examinées séparément.

Tester autre chose que le cas idéal

Préparez trois jeux de notes fictifs : une décision complète, une action sans responsable et deux dates contradictoires. Le résultat acceptable conserve le manque et la contradiction. Si Claude choisit arbitrairement une date, corrigez la règle puis rejouez les trois cas. Vérifiez également qu’une demande sans rapport ne conduit pas à appliquer ce format.

Conservez une copie de la version précédente et la raison du changement. La modification d’une instruction doit être testée sur les cas déjà satisfaisants, pas uniquement sur celui qui vient d’échouer. La page modèles réutilisables propose l’organisation de ce suivi.

Brancher ensuite le bon déclenchement

Si vous souhaitez lancer le traitement à réception de nouvelles notes, définissez d’abord où elles arrivent, ce qui prouve qu’elles sont complètes et qui valide le brouillon. Le guide automatiser avec n8n sépare ces étapes. Pour un agent destiné à l’entreprise, consultez aussi ALMA, sponsor de Promptum. Les permissions et le comportement réel restent à vérifier dans l’environnement retenu.

Sources

Pages consultées pour écrire cet article :

  1. https://code.claude.com/docs/en/skills

À lire aussi

Pour passer à la pratique