> ## Documentation Index
> Fetch the complete documentation index at: https://docs.llmskills.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Que sont les Agent Skills ?

> Agent Skills (Claude Skills) : un format ouvert et léger pour étendre les agents IA avec des connaissances et des flux de travail spécialisés.

À 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.

```directory theme={null}
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 :

```mdx theme={null}
---
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

* [Consulter la spécification](/fr/specification) pour comprendre le format complet.
* [Ajouter le support des skills à votre agent](/fr/integrate-skills) pour construire un client compatible.
* [Voir des exemples de skills](https://github.com/anthropics/skills) sur GitHub.
* [Lire les meilleures pratiques de rédaction](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) pour écrire des skills efficaces.
* [Utiliser la bibliothèque de référence](https://github.com/agentskills/agentskills/tree/main/skills-ref) pour valider les skills et générer du XML de prompt.