Guide pratique pour créer des compétences Claude : Structure, déclencheurs et scripts

Que sont les compétences Claude et comment elles fonctionnent

Les compétences Claude sont des manuels d'instructions qui automatisent des tâches spécifiques, distincts des Projets (bases de connaissances) et du Model Context Protocol (couche de connexion pour les données en direct). Si vous avez tapé les mêmes instructions au début de plus de trois conversations, c'est une compétence qui demande à être créée.

Structure et configuration des compétences

Une compétence est un dossier contenant un fichier appelé SKILL.md. La structure de base est :

nom-de-votre-compétence/
├── SKILL.md
└── references/
    └── votre-ref.md

Déposez le dossier dans ~/.claude/skills/ sur votre machine. Claude le trouve automatiquement.

Déclencheurs YAML : le mécanisme d'activation

En haut du fichier SKILL.md, écrivez les métadonnées entre les lignes --- pour indiquer à Claude quand s'activer. Exemple :

---
name: nettoyeur-csv
description: Transforme les fichiers CSV désordonnés en feuilles de calcul propres. Utilisez cette compétence chaque fois que l'utilisateur dit 'nettoyer ce CSV', 'corriger les en-têtes', 'formater ces données' ou 'organiser cette feuille de calcul'. NE PAS utiliser pour les PDF, documents Word ou fichiers image.
---

Suivez trois règles : écrivez à la troisième personne, listez les phrases déclencheuses exactes et définissez des limites négatives. Le champ de description est la ligne la plus importante de toute la compétence - une description faible signifie que la compétence ne se déclenche jamais.

Quand les instructions ne suffisent pas : le répertoire des scripts

Les instructions en anglais simple gèrent le jugement, le langage, le formatage et les décisions. Pour les tâches nécessitant un véritable calcul, ajoutez un dossier scripts/.

Utilisez les instructions pour : "réécrivez ceci dans notre ton de marque" ou "catégorisez ces notes de réunion".

Utilisez les scripts pour : "calculez la moyenne mobile de ces nombres", "analysez ce XML et extrayez des champs spécifiques" ou "redimensionnez toutes les images de ce dossier à 800x600".

Structure de dossier pour une compétence utilisant les deux :

analyseur-de-données/
├── SKILL.md
├── references/
│   └── modèle-analyse.md
└── scripts/
    ├── analyse-csv.py
    └── calcul-statistiques.py

Dans SKILL.md, référencez les scripts comme ceci :

## Flux de travail
1. Lisez le fichier CSV téléchargé pour comprendre sa structure.
2. Exécutez scripts/analyse-csv.py pour nettoyer les données :
   - Commande : `python scripts/analyse-csv.py [fichier_entrée] [fichier_sortie]`
   - Cela supprime les lignes vides, normalise les en-têtes et applique les types de données.
3. Exécutez scripts/calcul-statistiques.py sur les données nettoyées :
   - Commande : `python scripts/calcul-statistiques.py [fichier_nettoyé]`
   - Cela produit : moyenne, médiane, écart-type et valeurs aberrantes pour chaque colonne numérique.
4. Lisez la sortie statistique et écrivez un résumé compréhensible en suivant le modèle dans references/modèle-analyse.md. Mettez en évidence toute anomalie ou valeur aberrante qui pourrait inquiéter un lecteur non technique.

Les scripts gèrent le calcul ; les instructions gèrent le jugement. Une règle pour les scripts : un script, une tâche. analyse-csv.py ne devrait pas aussi calculer des statistiques. Gardez-les ciblés, acceptez les chemins de fichiers comme arguments, ne codez jamais les chemins en dur et incluez toujours la gestion des erreurs pour que Claude puisse lire les échecs et les communiquer clairement.

Références : la règle d'un seul niveau de profondeur

Si une compétence a besoin d'un guide de marque ou d'un modèle, déposez-le dans references/ et liez-le depuis SKILL.md. Ne faites jamais que des fichiers de référence pointent vers d'autres fichiers de référence - Claude tronquera sa lecture et manquera des éléments. Un seul niveau de profondeur.

nom-de-votre-compétence/
├── SKILL.md
└── references/
    └── guide-ton-marque.md ← liez ceci depuis SKILL.md ← ne liez jamais vers un autre fichier depuis ici

Dans SKILL.md : Avant de commencer la tâche, lisez le guide de ton de marque à references/guide-ton-marque.md

Orchestration multi-compétences : prévenir les conflits

Une fois que vous avez déployé cinq compétences ou plus, les conflits commencent - comme l'applicateur de ton de marque qui se déclenche alors que vous vouliez le rédacteur d'emails. Trois règles empêchent cela :

• Règle 1 : Territoires non chevauchants. Chaque compétence possède un domaine clairement défini (par exemple, l'applicateur de ton de marque gère la conformité du ton, le rédacteur d'emails gère la composition, le recycleur de contenu gère la transformation de format). Pas de débordement.
• Règle 2 : Limites négatives agressives.