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 polyvalents 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 les mêmes instructions à plusieurs reprises dans de multiples conversations.

Avantages clés :

• Spécialiser Claude : Adapter les capacités pour 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 demande.

Les Agent Skills préconstruits sont disponibles pour tous les utilisateurs sur claude.ai et via l'API Claude. Consultez la section Skills disponibles ci-dessous 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échargez-les via l'API, ou ajoutez-les dans les paramètres de claude.ai.

Comment fonctionnent les Skills

Les Skills exploitent l'environnement VM de Claude pour fournir des capacités au-delà de ce qui est possible avec les prompts seuls. Claude opère dans une machine virtuelle avec accès au système de fichiers, permettant aux Skills d'exister en tant que répertoires contenant des instructions, du code exécutable et des matériaux 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 le contexte dès le départ.

Trois types de contenu 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 le prompt 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 conseils :

# 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. C'est seulement à 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 matériaux 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 conseils spécialisés et des workflows

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 : Matériaux de référence tels que des schémas de base de données, de la documentation API, des modèles ou des exemples

Claude accède à ces fichiers uniquement lorsqu'ils sont référencés. Le modèle de système de fichiers signifie que chaque type de contenu a des forces différentes : les instructions pour des conseils flexibles, le code pour la fiabilité, les ressources pour la recherche 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. Pensez-y ainsi : les Skills existent en tant que 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 sur 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, apportant 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 en utilisant des 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 ne lit que 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 n'a besoin que du schéma de ventes, Claude charge uniquement ce fichier. Le reste reste sur le système de fichiers en consommant zéro token.

Exécution efficace des scripts : Lorsque Claude exécute validate_form.py, le code du script ne se charge jamais 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 si Claude devait générer du code équivalent à la volée.

Aucune limite pratique sur le contenu groupé : Parce que les fichiers ne consomment pas de contexte tant qu'ils ne sont pas accédés, les Skills peuvent inclure une documentation API complète, de grands ensembles de données, des exemples étendus ou tout matériau de référence dont vous avez besoin. Il n'y a pas de pénalité de contexte pour le contenu groupé 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 référenceriez des sections spécifiques d'un guide d'intégration, en 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 : Le prompt système inclut : PDF Processing - Extract text and tables from PDF files, fill forms, merge documents
2. Demande de l'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 le prompt système et les métadonnées des skills préchargés
2. Claude déclenche le skill en lisant SKILL.md via bash
3. Claude lit optionnellement des fichiers groupés supplémentaires comme FORMS.md selon les besoins
4. Claude procède à la tâche

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

Où fonctionnent les Skills

Les Skills sont disponibles dans tous les produits agents 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écharger/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échargez les vôtres via l'API Skills (endpoints /v1/skills). Les Skills personnalisés sont partagés à l'échelle de l'organisation.

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

Claude Code

Claude Code ne prend en charge que les Skills personnalisés.

Skills personnalisés : Créez des Skills en tant que 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échargements via l'API.

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

Claude Agent SDK

Le Claude Agent SDK prend en charge les Skills personnalisés via une configuration basée sur le système de fichiers.

Skills personnalisés : Créez des Skills en tant que répertoires avec des fichiers SKILL.md dans .claude/skills/. Activez les Skills en incluant "Skill" dans votre configuration allowed_tools.

Les Skills dans l'Agent SDK sont ensuite automatiquement découverts lorsque le SDK s'exécute.

Pour en savoir plus, consultez Agent Skills dans le SDK.

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échargez vos propres Skills sous forme de fichiers zip via Paramètres > Fonctionnalités. Disponible sur les plans 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 avec les 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 requis : name et description

Exigences des champs :

name :

• Maximum 64 caractères
• Ne doit contenir que 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 :

• Ne doit pas être 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é

Nous recommandons vivement d'utiliser uniquement des Skills provenant de sources fiables : ceux que vous avez créés vous-même ou obtenus 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 diriger Claude pour invoquer des outils ou exécuter du code d'une manière qui ne correspond pas à l'objectif déclaré du Skill.

Considérations de sécurité clés :

• Auditer minutieusement : Examinez tous les fichiers regroupés dans le Skill : SKILL.md, scripts, images et autres ressources. Recherchez des modèles inhabituels comme des appels réseau inattendus, des modèles 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
• Mauvaise utilisation des outils : Des Skills malveillants peuvent invoquer des outils (opérations sur les 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 à des systèmes externes
• Traiter comme l'installation d'un logiciel : N'utilisez des Skills que provenant de sources fiables. 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, formater du texte
• PDF (pdf) : Générer des documents PDF formatés et des rapports

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

Exemples de Skills personnalisés

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

Conservation des données

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

Pour l'éligibilité ZDR sur 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.

Disponibilité inter-surfaces

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

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

Vous devrez gérer et télécharger 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écharger 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échargés
• Claude Code : Personnel (~/.claude/skills/) ou basé sur le projet (.claude/skills/) ; peut également être partagé via les Plugins Claude Code

Claude.ai ne prend actuellement pas en charge la gestion centralisée par les administrateurs ou 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 du produit où vous l'utilisez.

• Claude.ai :
  • Accès réseau variable : Selon les paramètres de l'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 :
  • Pas d'accès réseau : Les Skills ne peuvent pas effectuer d'appels API externes ni accéder à Internet
  • Pas d'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 de packages globaux 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 fonctionner dans ces contraintes.

Prochaines étapes