Comprendre les skills

Un skill est un savoir-faire qu’on donne à un agent IA : une procédure, des règles, des modèles, parfois des scripts. L’agent le charge de lui-même quand la tâche correspond, et l’ignore le reste du temps.

Un savoir-faire qu’on donne à l’agent

C’est l’équivalent de la fiche qu’on remet à un nouveau collègue : « voici comment on fait un compte rendu chez nous », « voici comment on vérifie un fichier de positions ». Concrètement, c’est un dossier qui contient au minimum un fichier SKILL.md, et au besoin des scripts, de la documentation et des modèles.

Anatomie d’un SKILL.md

L’en-tête YAML sert à la découverte, le corps en Markdown donne les instructions. Voici le début d’un vrai SKILL.md du dépôt.

skills/charte-graphique-adalan/SKILL.md, en-tête complet et début du corps

---

L’en-tête YAML : c’est tout ce que l’agent lit au démarrage.

name: charte-graphique-adalan

Le nom du dossier, en minuscules, chiffres et tirets. C’est aussi celui de l’appel explicite.

description: Charte graphique d'adalan pour construire tout support web aux… À utiliser dès qu'on crée, habille ou relit…

Ce que fait le skill et quand s’en servir : c’est elle qui le déclenche.

metadata:

author: adalan

version: "3.0"

évolution.correction : on compare ce numéro à celui de sa copie.

---

# Charte graphique adalan

Le corps : les instructions, lues seulement quand la demande correspond.

Les lignes directrices pour construire un support web…

Dans le dossier	Rôle
`SKILL.md`	Obligatoire : en-tête YAML et instructions, moins de 500 lignes.
`references/`	Documentation lue à la demande, quand les instructions y renvoient.
`scripts/`	Code que l’agent exécute : un calcul, une conversion, un contrôle de format.
`assets/`	Modèles, images, données.

Chargement progressif

Un agent peut avoir des dizaines de skills installés sans encombrer son contexte, parce qu’il les lit en trois temps. La conséquence pratique : c’est la description qui décide si le skill se déclenche. Elle dit ce que fait le skill et quand l’utiliser, avec les mots que l’utilisateur emploiera.

Niveau 1 : Métadonnées
name et description
Au démarrage, pour tous les skills installés
~100 tokens par skill
Niveau 2 : Instructions
Le corps de SKILL.md
Quand la demande correspond à la description
moins de 5 000 tokens conseillés
Niveau 3 : Ressources
Les fichiers de references/, scripts/, assets/
Seulement si les instructions y renvoient
rien tant qu’ils ne sont pas lus

Un script exécuté ne coûte que sa sortie.

Skill, prompt, CLAUDE.md, MCP

	Chargé	Sert à
Prompt	Dans une conversation	Une consigne ponctuelle
`CLAUDE.md`, `AGENTS.md`	À chaque session, dans un projet	Le contexte permanent d’un projet
Serveur MCP	À la connexion	Donner accès à des outils et à des données externes
Skill	À la demande, quand la tâche correspond	Un savoir-faire réutilisable, d’un projet ou d’un outil à l’autre

Un skill et un serveur MCP se complètent : le serveur MCP donne l’accès (à une base, à une API), le skill dit comment s’en servir correctement.

Un standard ouvert

Le format a été créé par Anthropic pour Claude, puis publié comme standard ouvert : la spécification est sur agentskills.io. Un skill écrit une fois fonctionne dans tous les outils compatibles : voir où l’installer.

Versions

Chaque skill porte un numéro évolution.correction dans metadata.version, affiché sur sa page. Une copie téléversée sur claude.ai ou ChatGPT, ou installée dans un agent, ne suit pas le dépôt d’elle-même : on compare son numéro à celui du site.

Modification	Exemple	Version
Évolution : le skill fait autre chose, ou autrement	Consigne ajoutée, changée ou retirée ; nouvelle référence, script ou modèle ; description réécrite	`2.1` → `3.0`
Petite correction : la même chose, mieux	Coquille, tournure plus claire, lien cassé, bug de script	`2.1` → `2.2`

Sécurité

Un skill peut faire exécuter du code et des commandes à l’agent. On n’installe que des skills de sources de confiance, après avoir relu SKILL.md et les scripts. Un skill qui va chercher du contenu sur internet peut y trouver des instructions malveillantes : à éviter, ou à encadrer.

Créer un skill

Dans le dépôt, depuis sa racine :

Copier le gabarit et renommer son fichier.

$cp -R template skills/mon-skill && mv skills/mon-skill/SKILL.template.md skills/mon-skill/SKILL.md

Dans SKILL.md, mettre name: mon-skill, écrire la description et les instructions. La version reste à "1.0".
Valider le format avec skills-ref, l’outil de référence du standard.
```
$uvx --from skills-ref agentskills validate skills/mon-skill
```
L’essayer dans Claude Code en le liant à ses skills personnels.
```
$ln -s "$PWD/skills/mon-skill" ~/.claude/skills/mon-skill
```
L’ajouter au catalogue du README, puis pousser sur main : ce site se reconstruit, zip compris.