Nom de la compétence
Démarrage rapide
[Exemple minimal fonctionnel]
Workflows
[Processus étape par étape avec listes de contrôle pour les tâches complexes]
Fonctionnalités avancées
[Lien vers des fichiers séparés : Voir REFERENCE.md]
Exigences de description
La description est la seule chose que votre agent voit pour décider de charger la compétence. Elle est affichée dans le system prompt aux côtés de toutes les autres compétences installées. Votre agent lit ces descriptions et choisit la compétence pertinente en fonction de la demande de l'utilisateur.
Objectif : Donner à votre agent juste assez d'infos pour savoir :
- Quelle capacité cette compétence fournit
- Quand/pourquoi la déclencher (mots-clés spécifiques, contextes, types de fichiers)
Format :
- Max 1024 caractères
- Rédiger à la troisième personne
- Première phrase : ce qu'elle fait
- Deuxième phrase : « Utiliser quand [déclencheurs spécifiques] »
Bon exemple :
Extraire du texte et des tableaux de fichiers PDF, remplir des formulaires, fusionner des documents. Utiliser quand vous travaillez avec des fichiers PDF ou quand l'utilisateur mentionne des PDF, des formulaires ou l'extraction de documents.Mauvais exemple :
Aide avec les documents.Le mauvais exemple ne donne aucun moyen à votre agent de distinguer cette compétence des autres compétences de gestion de documents.
Quand ajouter des scripts
Ajouter des scripts utilitaires quand :
- L'opération est déterministe (validation, formatage)
- Le même code serait généré à plusieurs reprises
- Les erreurs nécessitent une gestion explicite
Les scripts économisent des tokens et améliorent la fiabilité par rapport au code généré.
Quand diviser les fichiers
Diviser en fichiers séparés quand :
- SKILL.md dépasse 100 lignes
- Le contenu a des domaines distincts (schémas financiers vs ventes)
- Les fonctionnalités avancées sont rarement nécessaires
Liste de contrôle de révision
Après la rédaction, vérifier :
- [ ] La description inclut les déclencheurs (« Utiliser quand... »)
- [ ] SKILL.md sous 100 lignes
- [ ] Pas d'infos sensibles au temps
- [ ] Terminologie cohérente
- [ ] Exemples concrets inclus
- [ ] Références un niveau profond