Qu'est-ce qu'une compétence d'agent (SKILL.md) et comment l'examiner

Une compétence est un dossier contenant un fichier SKILL.md qui se trouve là où votre agent de codage le cherche. L'agent lit le fichier uniquement lorsque votre demande correspond. Jusque-là, la compétence coûte environ une centaine de tokens, tandis qu'un prompt voyage avec chaque message dans lequel vous le collez.

Vous avez probablement rencontré ce mot dans un README : « installez la compétence, puis demandez à l'agent de... ». Rien de mystérieux. Ci-dessous : ce qu'il y a à l'intérieur, quand elle entre dans la fenêtre de contexte, et comment en examiner une avant de la laisser entrer sur votre machine.

Ce qu'est une compétence, et en quoi elle diffère d'un prompt#

La documentation Agent Skills d'Anthropic (consultée le 30 octobre 2026) décrit une compétence comme une ressource réutilisable basée sur le système de fichiers : un répertoire contenant un fichier SKILL.md, plus des scripts, des modèles et des fichiers de référence facultatifs. SKILL.md commence par un petit en-tête YAML (un nom et une description) et se poursuit par des instructions en texte brut.

Pensez à un nouveau collègue. Un prompt, c'est vous debout derrière sa chaise, répétant les règles chaque matin. Une compétence, c'est un classeur sur l'étagère avec une étiquette sur le dos : « Style des messages de commit. À lire quand on vous demande de commiter. » Il ne le descend que lorsqu'il en a besoin.

Deux champs d'en-tête sont obligatoires, et le format a des règles. Dans le format Skills de Claude, le name fait au maximum 64 caractères : lettres minuscules, chiffres et traits d'union, et il ne peut pas contenir les mots « anthropic » ou « claude ». Le description ne peut pas être vide, est limité à 1 024 caractères, et doit indiquer à la fois ce que fait la compétence et quand l'utiliser.

Comment une compétence entre dans la fenêtre de contexte#

La documentation appelle cela la divulgation progressive : l'agent lit une compétence en trois étapes, et chaque étape n'est payée que si elle est atteinte.

• Niveau 1, toujours chargé. Le nom et la description de chaque compétence installée, environ 100 tokens par compétence.
• Niveau 2, lorsqu'elle est déclenchée. Le corps de SKILL.md, moins de 5 000 tokens.
• Niveau 3, uniquement si nécessaire. Fichiers joints et scripts. Lorsque l'agent exécute un script, le code du script n'entre pas dans le contexte, seulement sa sortie.

Les chiffres de tokens sont les approximations de la documentation, pas des comptes exacts.

Voici pourquoi cela compte pour votre facture. Supposez que vous ayez installé 20 compétences. 20 × 100 = 2 000 tokens accompagnent chaque message dès le premier. Un agent renvoie son contexte à chaque étape (l'exemple en 20 étapes montre pourquoi), donc une session de 50 étapes transporte 50 × 2 000 = 100 000 tokens d'entrée d'étiquettes de compétences. Sur DeepSeek-V4-Flash, cela représente $0.0015 aux prix actuels.

Maintenant, dans l'autre sens. Si ces vingt compétences étaient collées comme un seul gros prompt, chaque corps serait présent dans chaque requête : jusqu'à 20 × 5 000 = 100 000 tokens par requête, pas par session. Cet écart est tout l'intérêt du chargement à la demande. Si le terme « fenêtre de contexte » reste flou, cette explication couvre ce qui la remplit.

Les compétences vivent dans le contexte, donc le modèle derrière l'agent a besoin de place pour elles. DeepSeek-V4-Flash sur CheapTokens (id deepseek-ai/DeepSeek-V4-Flash-0731) dispose d'une fenêtre de contexte de 380K et de jusqu'à 32 768 tokens de sortie par réponse, un seul prix à toute heure de la journée, et une API compatible OpenAI et Anthropic. Pour l'agent en terminal, suivez comment connecter Claude Code à CheapTokens ; pour tout autre outil, commencez par la documentation. La page du modèle se trouve ici.

Écrire une compétence minimale en deux minutes#

La lecture est plus facile après en avoir écrit une. Cette compétence fait écrire à l'agent des messages de commit dans un format fixe. Dans Claude Code, les compétences personnelles vivent dans ~/.claude/skills/ et les compétences de projet dans .claude/skills/, donc une compétence de projet peut voyager avec le dépôt.

mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

Collez ceci dans le fichier :

---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

Ouvrez maintenant l'agent dans un dépôt avec des modifications indexées et demandez : « écris un message de commit pour ce que j'ai indexé ». L'agent voit la description, décide qu'elle correspond, lit les quatre règles et les suit. S'il ignore la compétence, regardez d'abord le description : il doit nommer la situation, ici « commit », avec les mots que vous utiliseriez réellement.

Un piège : les compétences ne se synchronisent pas entre claude.ai, l'API et Claude Code. Une compétence créée à un endroit doit être ajoutée séparément aux autres.

Skill, AGENTS.md, MCP : lequel est lequel#

Ces trois-là sont confondus en permanence. Un fichier de règles tel que AGENTS.md ou CLAUDE.md est lu au début d'une session et contient des faits sur le projet (comment ce fichier peut mal tourner dans un dossier Téléchargements). Un serveur MCP donne à l'agent de nouveaux outils et données à atteindre (MCP en langage clair). Une compétence est une procédure : comment faire un type de travail, chargée quand ce travail se présente.

Examiner une compétence tierce avant de l'installer#

Une compétence est du texte que l'agent suit, et parfois du code que l'agent exécute. La documentation indique de n'utiliser des compétences que provenant de sources fiables, d'auditer chaque fichier joint (SKILL.md, scripts, ressources), et de rechercher des appels réseau ou des accès aux fichiers inattendus. Les compétences qui récupèrent des URL externes sont plus risquées. Dans Claude Code, une compétence a le même accès réseau que n'importe quel programme sur votre ordinateur, donc traitez l'installation comme l'installation d'un logiciel.

Un bon spécimen est universal-modder, une boîte à outils de modding de jeux. Son README (consultée le 30 octobre 2026) décrit un ensemble de compétences sous licence MIT au format Agent Skills, une CLI Python appelée um, un serveur MCP pour la génération d'assets via fal, et une base de connaissances partagée de notes de terrain. La compétence principale, mod-any-game, couvre la reconnaissance, l'ingénierie inverse, la génération d'assets, les tests en jeu et le packaging. Le README liste Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot et OpenCode comme outils pris en charge, et indique que la boîte à outils refuse de contourner les anti-triche ou les DRM. Dans Claude Code, elle s'installe avec /plugin marketplace add rehan-remade/universal-modder, et la génération d'assets nécessite une clé API fal distincte.

Remarquez ce que contient cette liste : des compétences, un programme en ligne de commande et un serveur. Lire un seul SKILL.md ne couvrirait qu'une partie de ce que vous installez. Parcourez donc les pièces :

La règle clé se trouve dans comment stocker une clé API en toute sécurité. La page du dépôt n'affiche aucune date du dernier commit, donc vérifiez la fraîcheur de la mise à jour du projet avant de vous y fier.