Les Agent Skills, sorties du presse-papiers
Les consignes données aux assistants se trouvent là où rien n’est relu : dans des conversations et des fichiers personnels. Pour les en sortir, il suffit de les traiter comme le reste du code.
Le symptôme est facile à reconnaître. Dans une équipe qui utilise un assistant depuis quelques mois, une consigne donne de bons résultats : celle qui produit une note de conception au bon format, ou qui vérifie un livrable selon une norme métier. Elle se trouve dans le presse-papiers de son auteur. Elle a été collée dans une conversation privée, envoyée à deux collègues, modifiée par l’un d’eux, et il en existe maintenant trois versions sans que personne sache laquelle est la bonne.
Les scripts d’exploitation étaient dans le même état il y a vingt ans, et le remède est le même : les placer dans un dépôt, leur donner un format, et soumettre les modifications à une revue. Il manquait jusqu’ici un format et un moyen de distribution, qu’une spécification ouverte et un utilitaire en ligne de commande fournissent désormais.
Le format est minimal : un dossier, un fichier Markdown avec quelques métadonnées en tête, et les fichiers auxquels la consigne renvoie. Cette simplicité est son principal avantage, car il n’y a rien à apprendre, et un rédacteur qui n’écrit pas de code peut proposer une modification.
design-note-review/
├── SKILL.md # the instruction itself, and when it applies
├── references/
│ └── internal-standard.md
└── scripts/
└── check_headings.pyL’élément décisif est la description en tête du fichier, car c’est elle qui détermine si la consigne est utilisée au bon moment. Une description vague produit une consigne qui ne se déclenche jamais, ou qui se déclenche partout. C’est le seul endroit où la rédaction demande du soin, et c’est souvent celui qu’on néglige.
L’utilitaire installe une consigne à partir d’un dépôt au lieu d’une machine. Cela suffit : dès que l’adresse d’installation est celle du compte de l’entreprise, la consigne n’est plus personnelle. Elle est relue avant d’être fusionnée, elle a un historique, et on la retire une seule fois pour tout le monde.
# Install from the company account rather than from a public repository
npx skills install github:company/skills/design-note-review
# Whatever gets installed must be listable and removable
npx skills list
npx skills remove design-note-reviewLa conséquence sur l’organisation est plus intéressante que la technique. Une consigne soumise à revue a un responsable, et cela change ce qu’on y écrit : les formulations approximatives, qui passaient inaperçues dans une conversation privée, sont contestées dès qu’un relecteur les lit. Le mécanisme est celui de la revue de code, et l’effet sur la qualité moyenne est le même.
Je n’ai pas de méthode pour évaluer une consigne. On peut constater qu’une modification améliore un résultat sur trois essais, mais pas vérifier qu’elle n’en dégrade pas un autre, et la revue humaine ne le permet pas non plus. Tant que ce manque persiste, une consigne partagée est un texte qu’on relit sans pouvoir le tester, ce qui vaut mieux que le presse-papiers, et moins que du code.
Une réserve enfin. La facilité d’installation incite à en accumuler, et une bibliothèque de quarante consignes dont six servent est moins utile que ces six consignes seules, car elle rend le choix difficile au moment où il devrait être évident. Le retrait doit devenir aussi courant que l’ajout, ce qui n’arrive jamais spontanément.