Aller au contenu principal
Zubnet AI › Apprendre › Wiki › Agent Skills
Utiliser l’AI

Agent Skills

Aussi appelé : SKILL.md, Compétences d'agent
Des dossiers d'instructions, de scripts et de ressources qu'un agent découvre de lui-même et ne charge que lorsqu'une tâche les demande.

Pourquoi c'est important

Les modèles généralistes sont capables, mais ils ne connaissent pas vos procédures : comment votre équipe met en forme ses rapports, quelles étapes exige votre déploiement, comment remplir tel formulaire PDF. Tout mettre dans le prompt système ne passe pas à l'échelle, car chaque instruction coûte du contexte à chaque requête, qu'elle soit pertinente ou non.

Les skills règlent ce problème par la divulgation progressive. L'agent ne voit au départ que le nom et la description de chaque skill, soit environ 100 tokens chacun. Quand une tâche correspond, il lit le SKILL.md complet. Si ces instructions mentionnent un autre fichier, il ne l'ouvre qu'en cas de besoin. Un agent peut avoir des centaines de skills installés et ne presque rien payer tant qu'aucun n'est utilisé.

En profondeur

Un skill d'agent est un dossier qui apprend à un agent d'IA à accomplir un type de tâche précis. Son cœur est un fichier, SKILL.md, qui commence par un court en-tête YAML (un nom et une description) suivi d'instructions en Markdown simple. Le dossier peut aussi contenir des scripts, des modèles de documents et des documents de référence auxquels les instructions renvoient.

Anthropic a lancé les Agent Skills pour Claude en octobre 2025 et a publié le format comme standard ouvert en décembre 2025. D'autres outils d'agents, dont Codex d'OpenAI, GitHub Copilot, Cursor et Gemini CLI, l'ont adopté depuis, si bien que le même dossier de skill peut fonctionner d'un produit à l'autre.

Anatomie d'un skill

pdf-forms/
├── SKILL.md          # name, description, instructions
├── reference.md      # extra detail, read only if needed
└── scripts/
    └── fill_form.py  # code the agent can run

L'en-tête en haut de SKILL.md comporte deux champs obligatoires :

name: pdf-forms
description: Fill in PDF forms. Use when the user asks to complete or extract fields from a PDF form.

La description est la ligne la plus importante. C'est tout ce que voit le modèle quand il décide de charger ou non le skill ; elle doit donc dire à la fois ce que fait le skill et quand l'utiliser.

Du code inclus

Les skills peuvent embarquer des scripts. C'est important, car certaines choses se font mieux avec du code qu'en générant des tokens : trier un tableur, extraire les champs d'un formulaire, valider une sortie. L'agent exécute le script et ne voit que le résultat, si bien que le code lui-même n'occupe jamais de contexte. C'est aussi pourquoi les skills ont besoin d'un environnement doté d'un système de fichiers et de l'exécution de code, comme un agent de codage ou un conteneur isolé en bac à sable.

Skills, MCP et prompts

  • MCP connecte un agent à des outils et à des données externes : votre base de données, votre système de tickets. Il donne à l'agent de nouvelles capacités.
  • Les skills apprennent à l'agent comment faire quelque chose avec les capacités qu'il a déjà. Un skill peut même décrire comment bien utiliser un serveur MCP donné.
  • Les prompts système et les fichiers d'instructions de projet (comme CLAUDE.md ou AGENTS.md) sont toujours chargés. Ils conviennent aux règles qui s'appliquent en permanence, alors que les skills conviennent aux connaissances qui ne servent que de temps en temps.

Écrire de bons skills

Partez d'échecs réels : observez où l'agent peine sur une tâche, puis notez ce qui lui manquait. Gardez SKILL.md court et déplacez les détails dans des fichiers séparés. Écrivez pour un nouveau venu intelligent : expliquez ce qui n'est pas évident et laissez de côté ce que le modèle sait déjà. Testez à la fois que le skill se déclenche quand il le faut et qu'il reste silencieux quand il ne le faut pas.

Sécurité

Un skill, ce sont des instructions plus du code exécutable, qui tournent avec tous les accès dont dispose l'agent. Un skill malveillant peut dire à l'agent de divulguer des données ou de lancer des commandes nuisibles, ce qui en fait une injection de prompt livrée sous forme de plugin. N'installez que des skills provenant de sources de confiance, et lisez leur contenu avant de les activer, en particulier les scripts et tout ce qui fait appel au réseau.

← Tous les termes
ESC