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 flux de travail, du contexte et des bonnes pratiques qui transforment les 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 à plusieurs reprises les mêmes conseils dans plusieurs 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 les capacités : Combiner les Skills pour construire des flux de travail complexes

Utiliser les Skills

Anthropic fournit des Agent Skills pré-construits pour les tâches courantes de documents (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 quand c'est pertinent 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 Available Skills ci-dessous pour la liste complète.

Les Skills personnalisés vous permettent de regrouper l'expertise du domaine et les connaissances organisationnelles. Ils sont disponibles dans tous les produits de 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 fonctionne 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 du contexte à l'avance.

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 préambule 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 quand déclenchées)

Type de contenu : Instructions. Le corps principal de SKILL.md contient des connaissances procédurales : des flux de travail, des bonnes pratiques et des 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).

Quand 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 flux de travail

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 comme les schémas de base de données, la documentation API, les modèles ou les exemples

Claude accède à ces fichiers seulement quand ils sont référencés. Le modèle du 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 a accès au système de fichiers, aux commandes bash et aux capacités d'exécution de code. Pensez-y comme ceci : 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 Skill :

Quand 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. Quand les instructions mentionnent des scripts exécutables, Claude les exécute via bash et reçoit seulement 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 seulement 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 a seulement besoin du schéma de ventes, Claude charge seulement ce fichier. Le reste reste sur le système de fichiers consommant zéro token.

Exécution efficace des scripts : Quand Claude exécute validate_form.py, le code du script ne se charge jamais dans la fenêtre de contexte. Seulement la sortie du script (comme "Validation passed" ou des messages d'erreur spécifiques) consomme des tokens. Cela rend les scripts beaucoup plus efficaces que d'avoir Claude générer du code équivalent à la volée.

Pas de limite pratique sur le contenu regroupé : Parce que les fichiers ne consomment pas de contexte jusqu'à ce qu'ils soient 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 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 référenceriez des sections spécifiques d'un guide d'intégration, accédant exactement à ce que chaque tâche nécessite.

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 : "Extract the text from this PDF and summarize it"
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. État par défaut avec le prompt système et les métadonnées de skill pré-chargées
2. Claude déclenche le skill en lisant SKILL.md via bash
3. Claude lit optionnellement des fichiers regroupé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 d'agent de Claude :

Claude API

L'API Claude supporte à 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 ainsi que 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 (points de terminaison /v1/skills). Les Skills personnalisés sont partagés à l'échelle de l'organisation.

Pour en savoir plus, consultez Use Skills with the Claude API.

Claude Code

Claude Code supporte seulement les Skills personnalisés.

Skills personnalisés : Créez les 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 API.

Pour en savoir plus, consultez Use Skills in Claude Code.

Claude Agent SDK

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

Skills personnalisés : Créez les 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 alors automatiquement découverts quand le SDK s'exécute.

Pour en savoir plus, consultez Agent Skills in the SDK.

Claude.ai

Claude.ai supporte à 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 quand vous créez des documents. Claude les utilise sans nécessiter aucune configuration.

Skills personnalisés : Téléchargez vos propres Skills en tant que 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 pour 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 :

• What are Skills?
• Using Skills in Claude
• How to create custom Skills
• Teach Claude your way of working using Skills

Structure du Skill

Chaque Skill nécessite un fichier SKILL.md avec un préambule 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 seulement 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 devrait l'utiliser. Pour des conseils complets sur la création, consultez le guide des bonnes pratiques.

Considérations de sécurité

Nous recommandons fortement d'utiliser les Skills seulement à partir de sources de confiance : celles que vous avez créées vous-même ou obtenues d'Anthropic. Les Skills fournissent à Claude de nouvelles capacités via des instructions et du code, et bien que cela les rend puissants, cela signifie aussi qu'un Skill malveillant peut diriger Claude pour invoquer des outils ou exécuter du code de manière qui ne correspond pas à l'objectif déclaré du Skill.

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

• Auditer complètement : 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 à partir d'URL externes posent un risque particulier, car le contenu récupéré peut contenir des instructions malveillantes. Même les Skills fiables peuvent être compromis si leurs dépendances externes changent au fil du temps
• Mauvais usage des outils : Les Skills malveillants peuvent invoquer des outils (opérations sur fichiers, commandes bash, exécution de code) de manière nuisible
• Exposition des données : Les Skills ayant accès à des données sensibles pourraient être conçus pour fuir les informations vers des systèmes externes
• Traiter comme l'installation de logiciels : Utilisez seulement les Skills de sources fiables. Soyez particulièrement prudent lors de l'intégration des 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 les données, générer des rapports avec des graphiques
• Word (docx) : Créer des documents, modifier le contenu, formater le 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.

Limitations et contraintes

Comprendre ces limitations vous aide à planifier efficacement le déploiement de vos Skills.

Disponibilité entre les 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 voulez les utiliser.

Portée du partage

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

• Claude.ai : Utilisateur individuel seulement ; chaque membre de l'équipe doit télécharger séparément
• Claude API : À 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 Claude Code Plugins

Claude.ai ne supporte pas actuellement 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 Create and Edit Files.
• Claude API :
  • Pas d'accès réseau : Les Skills ne peuvent pas faire d'appels API externes ou accéder à Internet
  • Pas d'installation de paquets d'exécution : Seuls les paquets pré-installés sont disponibles. Vous ne pouvez pas installer de nouveaux paquets pendant l'exécution.
  • Dépendances pré-configurées seulement : Consultez la documentation de l'outil d'exécution de code pour la liste des paquets 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 paquets globaux déconseillée : Les Skills ne doivent installer des paquets que localement afin d'éviter d'interférer avec l'ordinateur de l'utilisateur

Planifiez vos Skills pour fonctionner dans ces contraintes.

Prochaines étapes