BWBYB/agent-skills

Constructeur de Compétences Personnelles

Créez des compétences petites et découvrables qui améliorent les décisions de l'agent pour un workflow reproductible spécifique.

Périmètre

Utilisez cette compétence pour une nouvelle compétence ou une modification ciblée d'une compétence existante. Préservez l'emplacement demandé par l'utilisateur, la politique d'invocation et les limites d'autorisation. Ne créez pas une compétence simplement pour contenir des conseils génériques que l'agent connaît déjà.

Workflow

1. Définissez la limite de la tâche avant d'écrire des fichiers :

   • Quel résultat reproductible la compétence fournit-elle ?
   • Quelles demandes devraient l'activer, et quelles demandes similaires ne devraient pas ?
   • Quelles entrées, outils, effets secondaires et vérifications d'achèvement sont importants ?

2. Inspectez une compétence existante avant de la modifier. Conservez les ressources et politiques utiles ; ne réinitialisez pas un répertoire existant.

3. Choisissez la structure la plus petite :

   • SKILL.md est obligatoire.
   • Ajoutez references/ uniquement pour du matériel conditionnel substantiel qui modifie les décisions.
   • Ajoutez scripts/ uniquement pour un travail répété ou déterministe où l'exécution améliore la fiabilité.
   • Ajoutez assets/ uniquement pour les fichiers utilisés dans la sortie générée.

4. Rédigez SKILL.md :

   • Le name dans le frontmatter doit être en minuscules avec des traits d'union, correspondre au répertoire, et faire au maximum 64 caractères.
   • La description doit indiquer à la fois ce que fait la compétence et quand elle s'applique ; incluez une limite pour éviter un mauvais routage.
   • Gardez le corps concentré sur les résultats, les règles non évidentes, l'ordre d'exécution, les points de confirmation et les vérifications d'achèvement.
   • Placez les détails conditionnels dans une ressource liée et indiquez exactement quand la lire.

5. Validez le résultat avec le validateur de compétences disponible lorsque l'environnement en fournit un (localisez quick_validate.py sous la compétence skill-creator installée) :

   python3 <skill-creator>/scripts/quick_validate.py /chemin/vers/la/competence
   

   Si aucun validateur n'est disponible, effectuez manuellement les vérifications équivalentes du frontmatter, du nommage, des liens de ressources, des espaces réservés et des scripts. Exécutez les scripts ajoutés lorsque c'est pratique.

Règles de Conception

• Traitez la description comme une condition de routage, pas un catalogue de fonctionnalités.
• Gardez les instructions partagées suffisamment courtes pour un chargement de routine ; ne copiez pas une spécification externe entière dans le point d'entrée.
• Préférez un périmètre explicite et des critères d'achèvement observables plutôt que des interdictions générales ou des adjectifs de qualité vagues.
• N'ajoutez pas de fichiers README, d'exemples, de modèles ou de répertoires de ressources sans un workflow concret qui les utilise.
• Préservez les champs existants du frontmatter et de agents/openai.yaml lors de la mise à jour d'une compétence.
• Laissez la découverte automatique activée sauf si l'utilisateur demande explicitement une invocation par nom uniquement.

Références

Lisez la spécification Agent Skills lorsque la portabilité, les champs du frontmatter, les limites de nommage ou le comportement de chargement sont incertains. Traitez tout guide de conception fourni par l'utilisateur ou local à la machine comme une source de préférences facultative : lisez-le uniquement lorsque l'utilisateur demande explicitement ces conventions ou que la tâche en dépend, et ne copiez pas son contenu intégral dans la compétence. Consultez une compétence skill-creator installée pour les détails d'initialisation, les métadonnées d'interface utilisateur ou la validation, plutôt que de dépendre d'un chemin absolu spécifique à la machine.