Passer au contenu principal
À la base, un skill est un dossier contenant un fichier SKILL.md. Ce fichier comprend des métadonnées (name et description, au minimum) et des instructions qui indiquent à un agent comment effectuer une tâche spécifique. Les Claude Skills peuvent également regrouper des scripts, des modèles et des documents de référence.
my-skill/
├── SKILL.md          # Requis : instructions + métadonnées
├── scripts/          # Optionnel : code exécutable
├── references/       # Optionnel : documentation
└── assets/           # Optionnel : modèles, ressources

Fonctionnement des Agent Skills

Les Agent Skills et Claude Skills utilisent la divulgation progressive pour gérer le contexte efficacement :
  1. Découverte : Au démarrage, les agents chargent uniquement le nom et la description de chaque skill disponible, juste assez pour savoir quand il pourrait être pertinent.
  2. Activation : Lorsqu’une tâche correspond à la description d’un skill, l’agent lit l’intégralité des instructions du fichier SKILL.md dans son contexte.
  3. Exécution : L’agent suit les instructions, chargeant éventuellement les fichiers référencés ou exécutant le code regroupé si nécessaire.
Cette approche permet aux agents utilisant des Claude Skills de rester rapides tout en leur donnant accès à plus de contexte à la demande.

Le fichier SKILL.md

Chaque skill commence par un fichier SKILL.md contenant un frontmatter YAML et des instructions Markdown :
---
name: pdf-processing
description: Extraire du texte et des tableaux de fichiers PDF, remplir des formulaires, fusionner des documents.
---

# Traitement PDF

## Quand utiliser ce skill
Utilisez ce skill lorsque l'utilisateur a besoin de travailler avec des fichiers PDF...

## Comment extraire du texte
1. Utilisez pdfplumber pour l'extraction de texte...

## Comment remplir des formulaires
...
Le frontmatter suivant est requis en haut de SKILL.md :
  • name : Un identifiant court
  • description : Quand utiliser ce skill
Le corps Markdown contient les instructions réelles et n’a aucune restriction spécifique sur la structure ou le contenu. Ce format simple présente des avantages clés :
  • Auto-documenté : Un auteur ou un utilisateur de skill peut lire un fichier SKILL.md et comprendre ce qu’il fait, ce qui rend les Claude Skills faciles à auditer et à améliorer.
  • Extensible : Les Claude Skills peuvent varier en complexité, allant de simples instructions textuelles à du code exécutable, des ressources et des modèles.
  • Portable : Les Claude Skills ne sont que des fichiers, ils sont donc faciles à éditer, à versionner et à partager.

Prochaines étapes