Compétence de rédaction d'agent
Objectif
Fournir un package d'instructions exécutables par un agent pour un travail cohérent et réutilisable. Ancrez-le dans la tâche, les exemples, l'environnement d'outils, les artefacts existants et les corrections de l'utilisateur. Si aucun exemple réel n'est disponible, étiquetez les hypothèses et rédigez des instructions minimales testables plutôt que d'inventer des API spécifiques à un produit. Terminez et présentez la compétence réellement demandée, et non seulement un plan, un rapport d'avancement ou une critique.
Définir le contrat
- Énoncez le déclencheur : la tâche et l'entrée qui doivent activer cette compétence, ainsi que les demandes adjacentes qui ne devraient pas. Rédigez la
descriptioncomme une règle de routage concise spécifiant ce qu'elle fait et quand l'utiliser. - Énoncez les entrées requises et facultatives, l'autorité autorisée de l'agent, le résultat attendu et la définition de la tâche terminée. Résolvez les chevauchements avec les compétences voisines lors du transfert ; ne fusionnez pas des étapes distinctes simplement parce qu'elles partagent un sujet.
- Marquez les comportements obligatoires (passerelles de sécurité ou de correction), les heuristiques par défaut et les améliorations facultatives. Les instructions ne peuvent pas appliquer les autorisations d'exécution : utilisez les contrôles de la plateforme pour l'accès au système de fichiers, au réseau et aux outils.
Rédiger SKILL.md
Utilisez un frontmatter YAML avec un name en minuscules avec traits d'union correspondant à son dossier et une description spécifique. Suivez le format et les capacités de la plateforme hôte ; ne présumez pas de métadonnées facultatives ou de allowed-tools appliquant l'accès sur toutes les plateformes.
Gardez le corps concis : tâche et limites, entrées, procédure de décision, gestion des arrêts/échecs, contrat de sortie et pièges non évidents. Donnez un chemin par défaut plutôt qu'un menu d'alternatives équivalentes. Donnez des étapes exactes pour les opérations fragiles ; laissez une place au jugement justifié dans la sélection du contexte. Évitez de reformuler la même interdiction dans chaque section ou d'intégrer la réponse d'une tâche ponctuelle comme une procédure générale.
Déplacez les grandes références de domaine vers des fichiers references/ ciblés et dites exactement à l'agent quand les lire. Ajoutez des scripts réutilisables pour un travail répétitif et déterministe uniquement après avoir confirmé leurs dépendances d'exécution et leur comportement de validation. Conservez les références directement accessibles depuis SKILL.md et ne prétendez pas qu'un brouillon a été installé, exécuté ou validé quand ce n'est pas le cas.
Tester et réviser
Commencez par 2 à 3 cas représentatifs, dont un cas limite ; ajoutez des cas de déclenchement négatif et adverses lorsque la compétence agit sur du contenu non fiable ou a des limites importantes. Exécutez des sessions fraîches avec et sans la compétence ou par rapport au brouillon précédent. Évaluez les sorties observables et le comportement des outils, pas la qualité stylistique des instructions. Inspectez les traces pour détecter les étapes inutiles, les preuves manquées, les activations erronées et l'élargissement du périmètre. Pour les vérifications mécaniques, utilisez du code ; pour les jugements substantiels, faites appel à des humains. Supprimez les instructions qui ajoutent du coût sans prévenir une défaillance réelle.
Vérification de livraison
Avant de répondre, vérifiez que l'artefact complet demandé est effectivement présent et cohérent en interne. Lorsque l'utilisateur demande le Markdown complet, livrez l'intégralité du SKILL.md actuel, pas des fragments de correctif. Si vous créez un fichier, vérifiez qu'il existe et contient le brouillon complet ; signalez honnêtement le statut non testé. Résumez brièvement ce qui a changé et les éventuels besoins de validation restants. Ne transformez pas une demande pour une compétence en une suite non liée sans une demande claire.