Skills & procédures
Vos procédures internes encodées en skills que vos agents chargent au bon moment, versionnées, testées et lisibles d'un outil à l'autre sans réécriture.
Brancher un agent sur vos outils ne lui apprend pas votre métier. Les skills (compétences d'agent) sont des dossiers versionnés qui encodent vos procédures : revue de contrat, format de reporting, conventions de code, checklist de mise en production. La formule vient d'Anthropic : expliquer comment faire, c'est une skill ; accéder à quelque chose, c'est MCP. L'agent ne charge la skill qu'au moment où elle sert. Le contexte est une ressource rare. Le format est lu par Claude Code, Codex, GitHub Copilot ou Cursor, mais la spécification reste gouvernée par Anthropic : ouverte par la licence, pas neutre par la gouvernance.
Repères
SKILL.md
un dossier versionné dans votre dépôt, sans serveur à héberger
mesuré
les tokens de contexte de vos agents, comptés avant et après
0
skill tierce en production sans revue ni version épinglée
Skills & procédures
Ce que je construis
Vos procédures encodées en skills
Revue de contrat, format de reporting, conventions de code, checklist de mise en production : je choisis les procédures qui méritent d'en devenir une. J'écris la description qui les déclenche au bon moment, et je livre un dossier versionné dans votre dépôt. Pas de serveur, pas de runtime, rien à héberger. La valeur n'est pas dans le fichier Markdown, elle est dans le tri et dans l'évaluation.
SKILL.md · Procédures internes · Versionné dans Git · Lisible ailleurs
Allègement du contexte de vos agents
Un agent branché sur dix serveurs MCP dépense son contexte avant d'avoir commencé à travailler. Je regarde ce que chaque intégration coûte vraiment, je reformule en skills ce qui relève du savoir-faire plutôt que de l'accès, et je mesure : tokens de contexte avant et après, taux de déclenchement correct sur des requêtes de test. Le MCP reste là où il faut un vrai accès.
Contexte · Tokens mesurés · Déclenchement testé · MCP
Inventaire et gouvernance des skills
Vos développeurs installent déjà des skills depuis des dépôts publics, souvent sans revue. J'inventorie ce qui tourne, j'applique la grille de risque publiée par Anthropic, je pose une politique de sourcing, l'épinglage de version et la séparation auteur-relecteur. Puis un harnais d'évaluation branché sur votre CI, pour qu'une skill n'atteigne la production qu'après avoir été testée.
Inventaire · Revue de sécurité · Épinglage de version · CI
La promesse
Un agent qui sait faire, pas seulement se brancher.
Démonstration
Un avoir arrêté par sa sixième règle
Un distributeur de matériel médical établit des avoirs clients toutes les semaines. La procédure tient en six règles que personne ne connaît par cœur, et une erreur de base de calcul ne se voit qu'à la clôture comptable.
Cas inventéCe cas n'est pas une mission. Il est inventé de bout en bout, et le code plus bas est le vrai code qui le ferait tourner.
HumainDemande du gestionnaire
Un client renvoie 24 pousse-seringues, référence PSE-4120, commandés en trop, le retour est arrivé hier. Merci de préparer l'avoir sur la facture FA-2026-04417.
L'agentChargement de la skill
La demande porte sur un avoir, ce qui correspond au déclencheur de la skill avoir-client. Je la charge et je suis ses six règles dans l'ordre. La règle 1 réclame la facture d'origine, les règles 2 à 5 le statut du retour, le conditionnement, la base de prix et la responsabilité de l'erreur. Je vais chercher tout cela dans l'ERP.
La skill se charge sur son déclencheur, pas dans chaque conversation. Le contexte reste court tant que le sujet ne se présente pas.
Appel d'outilLecture de la facture
{ "tool": "erp.get_invoice_line", "arguments": { "invoice_id": "FA-2026-04417", "product_ref": "PSE-4120", "include": [ "pricing", "return_status", "packaging", "liability" ] } }Retour de l'outilRéponse de l'ERP
{ "invoice_id": "FA-2026-04417", "order_id": "CDE-2026-09912", "product_ref": "PSE-4120", "quantity_invoiced": 24, "catalog_unit_price_ht": 512.0, "contract_discount_pct": 18, "net_unit_price_ht": 419.84, "shipping_charged_ht": 96.0, "error_liability": "client", "return_status": "recu_en_stock", "return_date": "2026-09-02", "sterile_packaging_opened": false }L'agentApplication des règles
Retour reçu en stock et conditionnement scellé, les règles 2 et 3 passent. Règle 4, je retiens le prix net remisé de 419,84 EUR, soit une base de 10 076,16 EUR HT. Règle 5, l'erreur vient du client, le port de 96,00 EUR reste acquis. Sans cette procédure, j'aurais pris le tarif catalogue et remboursé le port, soit 12 384,00 EUR, un montant plausible et faux. Règle 6, la base dépasse 5 000,00 EUR HT, je n'émets rien.
Sans la règle 4, l'avoir surévalué passe la validation commerciale sans bruit et ne ressort qu'à la clôture comptable.
Réponse rendueRéponse au gestionnaire
L'avoir est préparé, il n'est pas émis. Base retenue 10 076,16 EUR HT, 24 unités au prix net facturé, remise de 18 % déduite. Le port de 96,00 EUR n'est pas remboursé, le retour vient d'une erreur de commande côté client. Le montant dépasse le seuil de 5 000,00 EUR HT, il attend la validation nommée du responsable ADV. Indiquez le valideur et je consigne son nom, la date et le motif avant émission.
La réponse donne le montant et la règle qui l'a produit. Le gestionnaire peut la contredire sans ouvrir l'ERP.
La skill que l'agent charge sur déclencheur
---
name: avoir-client
description: Procédure interne d'émission d'un avoir client, à charger dès qu'une demande porte sur un avoir, un remboursement, un retour de matériel ou une facture à corriger.
---
# Avoir client
Six règles, dans l'ordre. Aucune n'est facultative.
## 1. Rattachement
L'avoir se rattache au numéro de la facture d'origine, jamais au numéro de
commande. Sans facture d'origine identifiée, la procédure s'arrête ici.
## 2. Retour physique
Rien n'est émis tant que le retour n'est pas reçu et remis en stock. Le statut
de l'entrepôt fait foi, pas la déclaration du client.
## 3. Conditionnement stérile
Un conditionnement stérile ouvert n'est jamais repris. Aucun avoir. La demande
part en garantie fabricant.
## 4. Base de calcul
La base est le prix net facturé, remise contractuelle déduite. Le tarif
catalogue n'est jamais la base d'un avoir.
## 5. Frais de port
Le port est remboursé seulement si l'erreur vient du distributeur. Erreur de
commande côté client, le port reste acquis.
## 6. Seuil de validation
Passé 5 000,00 EUR HT, aucun avoir ne part sans validation nommée du
responsable ADV. Le nom du valideur, la date et le motif sont consignés dans la
demande avant émission. Sous le seuil, émission directe.
## Sortie attendue
Un brouillon rattaché à la facture d'origine, avec le détail ligne à ligne, la
base retenue et la règle appliquée pour chaque écart au montant facturé. Si la
règle 6 s'applique, le brouillon reste en attente et la validation nommée est
réclamée avant toute émission. Ne jamais présenter un brouillon en attente
comme un avoir émis.Un agent ne devine pas une procédure interne, et sans elle il ne se trompe pas bruyamment, il se trompe de façon plausible.
Skills & procédures
Avant, après
Une procédure maison qui vit dans la tête de trois personnes
La même procédure chargée par l'agent au moment où elle sert
Un contexte saturé par dix serveurs MCP avant le premier travail
Un contexte rendu au travail, la skill chargée seulement au besoin
Des skills installées depuis des dépôts publics, sans revue
Chaque skill inventoriée, épinglée et testée avant la production
Skills & procédures
La stack
SKILL.md
Agent Skills
Claude Code
Codex
GitHub Copilot
Cursor
MCP
Context engineering
YAML
Git
CI
Evals
Skills & procédures
Questions franches
Quelle différence entre une skill et un serveur MCP ?
La formule d'Anthropic tranche : expliquer comment faire, c'est une skill ; accéder à quelque chose, c'est MCP. Les deux se complètent, ils ne se remplacent pas. Une skill peut d'ailleurs se servir des outils MCP déjà en place, et c'est souvent comme ça qu'on allège le contexte.
Installer une skill trouvée sur un dépôt public, c'est risqué ?
Oui. Les études publiées début 2026 sur les dépôts publics montrent qu'une part importante des skills analysées porte au moins une faille, et que celles qui embarquent des scripts sont les plus exposées. Une skill est du texte que l'agent traite comme une consigne de confiance : source connue, revue, version épinglée.
Qui contrôle ce standard ?
Anthropic. Le format est publié sous licence ouverte et lu par Codex, GitHub Copilot ou Cursor, mais il n'a pas été confié à une fondation neutre, contrairement à MCP. Ouvert par la licence, pas neutre par la gouvernance : la nuance compte si vous engagez vos procédures dessus.
C'est juste du Markdown, mon équipe peut le faire ?
Oui, et une partie de vos développeurs le fait déjà. Écrire le fichier n'est pas le travail : choisir quelles procédures méritent d'en devenir une, rédiger la description qui déclenche au bon moment, monter l'évaluation, voilà ce qui prend du temps. Si votre équipe tient ces trois points, vous n'avez pas besoin de moi.
Une skill écrite pour Claude marche-t-elle ailleurs ?
Au niveau du format, oui : le même dossier est lu par Codex, GitHub Copilot, Cursor ou Gemini CLI. Au niveau du comportement, pas toujours. Une skill qui suppose un environnement d'exécution ou un outil précis ne se comporte pas pareil ailleurs, et je le vérifie par des requêtes de test sur chaque cible.
Peut-on encoder tout le savoir-faire de l'entreprise ?
Non, et c'est le fantasme le plus courant. L'API d'Anthropic plafonne à vingt skills par requête, et la précision de sélection se dégrade souvent quand la bibliothèque grossit : les descriptions finissent par se voler mutuellement les déclenchements. On encode les procédures qui se répètent et qui coûtent cher, pas les autres.
À lire sur ce sujet
Contact
Prêt à passer de la démo à la production ?
Réponse sous 24 h · premier échange gratuit et sans engagement.