Agent Skills



Pourquoi utiliser les Skills

Les Skills sont des ressources réutilisables basées sur le système de fichiers qui fournissent à Claude une expertise spécifique à un domaine : des workflows, du contexte et des bonnes pratiques qui transforment des agents généralistes en spécialistes. Contrairement aux prompts (instructions au niveau de la conversation pour des tâches ponctuelles), les Skills se chargent à la demande et éliminent le besoin de fournir de manière répétée les mêmes directives au fil de multiples conversations.

Principaux avantages :

• Spécialiser Claude : adapter les capacités à des tâches spécifiques à un domaine
• Réduire la répétition : créer une fois, utiliser automatiquement
• Composer des capacités : combiner des Skills pour construire des workflows complexes



Utiliser les Skills

Anthropic fournit des Agent Skills préconstruits pour les tâches documentaires courantes (PowerPoint, Excel, Word, PDF), et vous pouvez créer vos propres Skills personnalisés. Les deux fonctionnent de la même manière. Claude les utilise automatiquement lorsqu'ils sont pertinents pour votre requête.

Les Agent Skills préconstruits sont disponibles sur claude.ai, l'API Claude, Claude Platform on AWS et Microsoft Foundry. Consultez Skills disponibles pour la liste complète.

Les Skills personnalisés vous permettent de regrouper une expertise de domaine et des connaissances organisationnelles. Ils sont disponibles dans tous les produits Claude : créez-les dans Claude Code, téléversez-les via l'API Claude ou ajoutez-les dans les paramètres de claude.ai. Sur Claude Platform on AWS et Microsoft Foundry, téléversez les Skills personnalisés via l'API Skills.



Fonctionnement des Skills

Les Skills exploitent l'environnement de machine virtuelle de Claude pour fournir des capacités allant au-delà de ce qui est possible avec les seuls prompts. Claude opère dans une machine virtuelle avec accès au système de fichiers, ce qui permet aux Skills d'exister sous forme de répertoires contenant des instructions, du code exécutable et des documents de référence, organisés comme un guide d'intégration que vous créeriez pour un nouveau membre de l'équipe.

Cette architecture basée sur le système de fichiers permet la divulgation progressive : Claude charge les informations par étapes selon les besoins, plutôt que de consommer du contexte dès le départ.



Trois types de contenu de Skill, trois niveaux de chargement

Les Skills peuvent contenir trois types de contenu, chacun chargé à des moments différents :



Niveau 1 : Métadonnées (toujours chargées)

Type de contenu : Instructions. Le frontmatter YAML du Skill fournit des informations de découverte :

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

Claude charge ces métadonnées au démarrage et les inclut dans l'invite système. Cette approche légère signifie que vous pouvez installer de nombreux Skills sans pénalité de contexte ; Claude sait seulement que chaque Skill existe et quand l'utiliser.



Niveau 2 : Instructions (chargées lors du déclenchement)

Type de contenu : Instructions. Le corps principal de SKILL.md contient des connaissances procédurales : workflows, bonnes pratiques et directives :

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:

```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see [FORMS.md](FORMS.md).

Lorsque vous demandez quelque chose qui correspond à la description d'un Skill, Claude lit SKILL.md depuis le système de fichiers via bash. Ce n'est qu'à ce moment que ce contenu entre dans la fenêtre de contexte.



Niveau 3 : Ressources et code (chargés selon les besoins)

Types de contenu : Instructions, code et ressources. Les Skills peuvent regrouper des éléments supplémentaires :

pdf-skill/
├── SKILL.md (main instructions)
├── FORMS.md (form-filling guide)
├── REFERENCE.md (detailed API reference)
└── scripts/
    └── fill_form.py (utility script)

Instructions : fichiers markdown supplémentaires (FORMS.md, REFERENCE.md) contenant des directives et des workflows spécialisés

Code : scripts exécutables (fill_form.py, validate.py) que Claude exécute via bash ; les scripts fournissent des opérations déterministes sans consommer de contexte

Ressources : documents de référence tels que des schémas de base de données, de la documentation d'API, des modèles ou des exemples

Claude accède à ces fichiers uniquement lorsqu'ils sont référencés. Le modèle basé sur le système de fichiers signifie que chaque type de contenu a des atouts différents : les instructions pour des directives flexibles, le code pour la fiabilité, les ressources pour la consultation factuelle.

La divulgation progressive garantit que seul le contenu pertinent occupe la fenêtre de contexte à tout moment.



L'architecture des Skills

Les Skills s'exécutent dans un environnement d'exécution de code où Claude dispose d'un accès au système de fichiers, de commandes bash et de capacités d'exécution de code. Voyez cela ainsi : les Skills existent sous forme de répertoires sur une machine virtuelle, et Claude interagit avec eux en utilisant les mêmes commandes bash que vous utiliseriez pour naviguer dans les fichiers de votre ordinateur.

Comment Claude accède au contenu des Skills :

Lorsqu'un Skill est déclenché, Claude utilise bash pour lire SKILL.md depuis le système de fichiers, intégrant ses instructions dans la fenêtre de contexte. Si ces instructions font référence à d'autres fichiers (comme FORMS.md ou un schéma de base de données), Claude lit également ces fichiers à l'aide de commandes bash supplémentaires. Lorsque les instructions mentionnent des scripts exécutables, Claude les exécute via bash et ne reçoit que la sortie (le code du script lui-même n'entre jamais dans le contexte).

Ce que cette architecture permet :

Accès aux fichiers à la demande : Claude lit uniquement les fichiers nécessaires pour chaque tâche spécifique. Un Skill peut inclure des dizaines de fichiers de référence, mais si votre tâche ne nécessite que le schéma des ventes, Claude charge uniquement ce fichier. Les autres restent sur le système de fichiers sans consommer aucun token.

Exécution efficace des scripts : lorsque Claude exécute validate_form.py, le code du script n'est jamais chargé dans la fenêtre de contexte. Seule la sortie du script (comme « Validation réussie » ou des messages d'erreur spécifiques) consomme des tokens. Cela rend les scripts bien plus efficaces que de demander à Claude de générer du code équivalent à la volée.

Aucune limite pratique sur le contenu regroupé : comme les fichiers ne consomment pas de contexte tant qu'ils ne sont pas consultés, les Skills peuvent inclure une documentation d'API complète, de grands ensembles de données, des exemples détaillés ou tout document de référence dont vous avez besoin. Il n'y a aucune pénalité de contexte pour le contenu regroupé qui n'est pas utilisé.

Ce modèle basé sur le système de fichiers est ce qui rend la divulgation progressive possible. Claude navigue dans votre Skill comme vous consulteriez des sections spécifiques d'un guide d'intégration, accédant exactement à ce que chaque tâche requiert.



Exemple : chargement d'un Skill de traitement PDF

Voici comment Claude charge et utilise un Skill de traitement PDF :

1. Démarrage : l'invite système inclut : PDF Processing - Extract text and tables from PDF files, fill forms, merge documents
2. Requête utilisateur : « Extrais le texte de ce PDF et résume-le »
3. Claude invoque : bash: read pdf-skill/SKILL.md → Instructions chargées dans le contexte
4. Claude détermine : le remplissage de formulaire n'est pas nécessaire, donc FORMS.md n'est pas lu
5. Claude exécute : utilise les instructions de SKILL.md pour accomplir la tâche

Le diagramme montre :

1. L'état par défaut avec l'invite système et les métadonnées du Skill préchargées
2. Claude déclenche le Skill en lisant SKILL.md via bash
3. Claude lit éventuellement des fichiers regroupés supplémentaires comme FORMS.md selon les besoins
4. Claude poursuit la tâche

Ce chargement dynamique garantit que seul le contenu pertinent du Skill occupe la fenêtre de contexte.



Où fonctionnent les Skills

Les Skills sont disponibles dans tous les produits d'agent de Claude :



API Claude

L'API Claude prend en charge à la fois les Agent Skills préconstruits et les Skills personnalisés. Les deux fonctionnent de manière identique : spécifiez le skill_id pertinent dans le paramètre container avec l'outil d'exécution de code.

Prérequis : l'utilisation des Skills via l'API nécessite trois en-têtes bêta :

• code-execution-2025-08-25 - Les Skills s'exécutent dans le conteneur d'exécution de code
• skills-2025-10-02 - Active la fonctionnalité Skills
• files-api-2025-04-14 - Requis pour téléverser/télécharger des fichiers vers/depuis le conteneur

Utilisez les Agent Skills préconstruits en référençant leur skill_id (par exemple, pptx, xlsx), ou créez et téléversez les vôtres via l'API Skills (points de terminaison /v1/skills). Les Skills personnalisés sont partagés à l'échelle de l'espace de travail ; tous les membres de l'espace de travail peuvent y accéder.

Pour en savoir plus, consultez Utiliser les Skills avec l'API Claude.



Claude Code

Claude Code prend en charge uniquement les Skills personnalisés.

Skills personnalisés : créez des Skills sous forme de répertoires avec des fichiers SKILL.md. Claude les découvre et les utilise automatiquement.

Les Skills personnalisés dans Claude Code sont basés sur le système de fichiers et ne nécessitent pas de téléversement via l'API.

Pour en savoir plus, consultez Utiliser les Skills dans Claude Code.



claude.ai

claude.ai prend en charge à la fois les Agent Skills préconstruits et les Skills personnalisés.

Agent Skills préconstruits : ces Skills fonctionnent déjà en arrière-plan lorsque vous créez des documents. Claude les utilise sans nécessiter de configuration.

Skills personnalisés : téléversez vos propres Skills sous forme de fichiers zip via Paramètres > Fonctionnalités. Disponible sur les forfaits Pro, Max, Team et Enterprise avec l'exécution de code activée. Les Skills personnalisés sont individuels à chaque utilisateur ; ils ne sont pas partagés à l'échelle de l'organisation et ne peuvent pas être gérés de manière centralisée par les administrateurs.

Pour en savoir plus sur l'utilisation des Skills dans claude.ai, consultez les ressources suivantes dans le Centre d'aide Claude :

• Que sont les Skills ?
• Utiliser les Skills dans Claude
• Comment créer des Skills personnalisés
• Apprenez à Claude votre façon de travailler grâce aux Skills



Structure d'un Skill

Chaque Skill nécessite un fichier SKILL.md avec un frontmatter YAML :

---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
[Clear, step-by-step guidance for Claude to follow]

## Examples
[Concrete examples of using this Skill]

Champs obligatoires : name et description

Exigences des champs :

name :

• Maximum 64 caractères
• Doit contenir uniquement des lettres minuscules, des chiffres et des tirets
• Ne peut pas contenir de balises XML
• Ne peut pas contenir de mots réservés : « anthropic », « claude »

description :

• Doit être non vide
• Maximum 1024 caractères
• Ne peut pas contenir de balises XML

La description doit inclure à la fois ce que fait le Skill et quand Claude doit l'utiliser. Pour des conseils complets sur la rédaction, consultez le guide des bonnes pratiques.



Considérations de sécurité

Utilisez uniquement des Skills provenant de sources de confiance : ceux que vous avez créés vous-même ou obtenus auprès d'Anthropic. Les Skills fournissent à Claude de nouvelles capacités via des instructions et du code, et bien que cela les rende puissants, cela signifie également qu'un Skill malveillant peut amener Claude à invoquer des outils ou à exécuter du code d'une manière qui ne correspond pas à l'objectif déclaré du Skill.

Principales considérations de sécurité :

• Auditez minutieusement : examinez tous les fichiers regroupés dans le Skill : SKILL.md, scripts, images et autres ressources. Recherchez des schémas inhabituels tels que des appels réseau inattendus, des schémas d'accès aux fichiers ou des opérations qui ne correspondent pas à l'objectif déclaré du Skill
• Les sources externes sont risquées : les Skills qui récupèrent des données depuis des URL externes présentent un risque particulier, car le contenu récupéré peut contenir des instructions malveillantes. Même des Skills dignes de confiance peuvent être compromis si leurs dépendances externes changent au fil du temps
• Utilisation abusive des outils : des Skills malveillants peuvent invoquer des outils (opérations sur fichiers, commandes bash, exécution de code) de manière nuisible
• Exposition des données : des Skills ayant accès à des données sensibles pourraient être conçus pour divulguer des informations vers des systèmes externes
• Traitez-les comme l'installation d'un logiciel : utilisez uniquement des Skills provenant de sources de confiance. Soyez particulièrement prudent lors de l'intégration de Skills dans des systèmes de production ayant accès à des données sensibles ou à des opérations critiques



Skills disponibles



Agent Skills préconstruits

Les Agent Skills préconstruits suivants sont disponibles pour une utilisation immédiate :

• PowerPoint (pptx) : créer des présentations, modifier des diapositives, analyser le contenu des présentations
• Excel (xlsx) : créer des feuilles de calcul, analyser des données, générer des rapports avec des graphiques
• Word (docx) : créer des documents, modifier du contenu, mettre en forme du texte
• PDF (pdf) : générer des documents et rapports PDF formatés

Ces Skills sont disponibles sur l'API Claude, Claude Platform on AWS, Microsoft Foundry et claude.ai. Consultez le tutoriel de démarrage rapide pour commencer à les utiliser dans l'API.



Skills open source

Anthropic publie également des Skills open source dans le dépôt skills :

• API Claude : fournit à Claude des documents de référence à jour sur l'API, de la documentation SDK et des bonnes pratiques pour 8 langages de programmation. Inclus avec Claude Code et également disponible pour installation depuis le dépôt skills.



Exemples de Skills personnalisés

Pour des exemples complets de Skills personnalisés, consultez le Skills cookbook.



Conservation des données

Les Agent Skills ne sont pas couverts par les accords ZDR. Les définitions de Skills et les données d'exécution sont conservées conformément à la politique standard de conservation des données d'Anthropic.

Pour l'éligibilité ZDR de toutes les fonctionnalités, consultez API et conservation des données.



Limitations et contraintes

Comprendre ces limitations vous aide à planifier efficacement le déploiement de vos Skills. Claude Platform on AWS et Microsoft Foundry suivent les mêmes limitations que l'API Claude dans les sous-sections suivantes.



Disponibilité inter-surfaces

Les Skills personnalisés ne se synchronisent pas entre les surfaces. Les Skills téléversés sur une surface ne sont pas automatiquement disponibles sur les autres :

• Les Skills téléversés sur claude.ai doivent être téléversés séparément sur l'API
• Les Skills téléversés via l'API ne sont pas disponibles sur claude.ai
• Les Skills de Claude Code sont basés sur le système de fichiers et distincts de claude.ai et de l'API

Vous devrez gérer et téléverser les Skills séparément pour chaque surface où vous souhaitez les utiliser.



Portée du partage

Les Skills ont différents modèles de partage selon l'endroit où vous les utilisez :

• claude.ai : utilisateur individuel uniquement ; chaque membre de l'équipe doit téléverser séparément
• API Claude : à l'échelle de l'espace de travail ; tous les membres de l'espace de travail peuvent accéder aux Skills téléversés
• Claude Code : personnel (~/.claude/skills/) ou basé sur le projet (.claude/skills/) ; peut également être partagé via les Claude Code Plugins

claude.ai ne prend pas en charge la gestion centralisée par les administrateurs ni la distribution à l'échelle de l'organisation des Skills personnalisés.



Contraintes de l'environnement d'exécution

L'environnement d'exécution exact disponible pour votre Skill dépend de la surface produit où vous l'utilisez.

• claude.ai :
  • Accès réseau variable : selon les paramètres utilisateur/administrateur, les Skills peuvent avoir un accès réseau complet, partiel ou nul. Pour plus de détails, consultez l'article d'assistance Créer et modifier des fichiers.
• API Claude :
  • Aucun accès réseau : les Skills ne peuvent pas effectuer d'appels d'API externes ni accéder à Internet
  • Aucune installation de packages à l'exécution : seuls les packages préinstallés sont disponibles. Vous ne pouvez pas installer de nouveaux packages pendant l'exécution.
  • Dépendances préconfigurées uniquement : consultez la documentation de l'outil d'exécution de code pour la liste des packages disponibles
• Claude Code :
  • Accès réseau complet : les Skills ont le même accès réseau que tout autre programme sur l'ordinateur de l'utilisateur
  • Installation globale de packages déconseillée : les Skills ne doivent installer des packages que localement afin d'éviter d'interférer avec l'ordinateur de l'utilisateur

Planifiez vos Skills pour qu'ils fonctionnent dans le cadre de ces contraintes.



Prochaines étapes