Agent Skills

Un skill est une procédure réutilisable chargée seulement lorsqu’une tâche lui correspond. Le minimum est un dossier avec SKILL.md; scripts, références, assets et métadonnées d’interface restent facultatifs.

Ce qui mérite un skill

• un workflow répété entre sessions ou dépôts ;
• des règles de domaine qui changent réellement l’exécution ;
• une séquence fiable avec entrées, sorties, contrôles et arrêt clairs ;
• des scripts ou modèles plus sûrs à réutiliser qu’à régénérer.

Une préférence ponctuelle, un fait documentaire ou l’enveloppe d’une commande évidente n’en mérite pas.

Règles de conception

1. Faire de description un déclencheur précis, avec périmètre et exclusions.
2. Garder SKILL.md comme carte et contrat opératoire.
3. Déplacer les détails et la mécanique déterministe vers des fichiers ou scripts ciblés.
4. Garder les références peu profondes.
5. Définir les limites d’autorité et une validation proportionnelle au risque.
6. Tester le skill sur une vraie tâche.

La divulgation progressive charge la métadonnée au départ, les instructions à l’activation et les ressources seulement au besoin. Les instructions règlent le comportement général, le skill enseigne une méthode, MCP connecte des capacités vivantes et le harness exécute et observe.