SKILL.md — Le format pour les skills d'agents

SKILL.md est un standard ouvert pour packager des capacités réutilisables que les agents IA de développement peuvent découvrir et activer à la demande. Créé par Anthropic et standardisé sur agentskills.io, le format est supporté par plus de 27 agents IA dont Claude Code, Cursor, Codex, Gemini CLI et VS Code.

Quel problème cela résout-il ?

Sans les skills, vous répétez les mêmes prompts complexes à chaque fois que vous voulez qu'un agent fasse quelque chose de spécifique — générer un PDF, construire un design system, écrire des tests Playwright. SKILL.md regroupe ces instructions une fois pour toutes afin que tout agent compatible puisse les reprendre automatiquement. Les skills sont chargés à la demande, ils n'alourdissent donc pas la fenêtre de contexte de votre agent.

Comment ça fonctionne

Un skill est un dossier contenant un fichier SKILL.md avec un frontmatter YAML et des instructions en markdown. Au minimum, un skill a besoin d'un nom et d'une description.

---

name: pdf-processing

description: Extract text and tables from PDF files,

merge documents, fill forms, and convert to images.

license: MIT

compatibility:

- Claude Code

- Cursor

allowed-tools: Bash(python:*) Read Write

---

# PDF Processing

When the user asks you to work with PDF files, follow

these instructions...

Champs du frontmatter

Champ	Requis	Description
name	Oui	Identifiant unique. 64 caractères max, lettres minuscules, chiffres, tirets.
description	Oui	Ce que fait le skill et quand l'activer. 1024 caractères max.
license	Non	Identifiant de licence SPDX ou référence vers un fichier de licence.
compatibility	Non	Liste des agents compatibles et des prérequis d'environnement.
metadata	Non	Paires clé-valeur arbitraires (auteur, version, tags).
allowed-tools	Non	Liste d'outils pré-approuvés pour l'agent, séparés par des espaces.

Divulgation progressive

Les skills utilisent un modèle de chargement en trois phases pour préserver l'efficacité de la fenêtre de contexte :

Découverte — L'agent lit uniquement le nom et la description (~100 tokens)
Activation — Quand une tâche correspond, le SKILL.md complet est chargé (<5000 tokens)
Exécution — L'agent suit les instructions, chargeant les fichiers référencés au besoin

Qui le supporte

Le format SKILL.md est supporté par Claude Code, Cursor, OpenAI Codex, Gemini CLI, VS Code, GitHub Copilot, Amp, Roo Code, Goose, Windsurf, Continue, et bien d'autres. La liste complète des agents compatibles est maintenue sur agentskills.io.

Spécifications associées

AGENTS.md — contexte au niveau du projet (chargé à chaque prompt, pas à la demande)
CLAUDE.md — règles de projet spécifiques à Claude
MCP — pour connecter les agents à des outils et services externes

Spécification officielle

La spécification complète de SKILL.md est maintenue sur agentskills.io.

Lire la spécification complète