Agent Skills



Pourquoi utiliser les Skills

Les Skills sont des ressources réutilisables, basées sur le système de fichiers, qui donnent à Claude une expertise spécifique à un domaine : des flux de travail, du contexte et des bonnes pratiques qui transforment un agent généraliste en spécialiste. Contrairement aux prompts (instructions au niveau de la conversation pour des tâches ponctuelles), les Skills se chargent à la demande, vous n'avez donc pas à répéter les mêmes consignes d'une conversation à l'autre.

Avantages clés :

• Spécialiser Claude : Adaptez les capacités pour des tâches spécifiques à un domaine
• Réduire la répétition : Créez une fois, utilisez automatiquement
• Composer des capacités : Combinez des Skills pour des tâches complexes en plusieurs étapes



Utiliser les Skills

Anthropic fournit des Agent Skills préconstruites pour les tâches documentaires courantes (PowerPoint, Excel, Word, PDF), et vous pouvez créer vos propres Skills personnalisées. Les deux fonctionnent de la même manière : une fois qu'une Skill est disponible dans votre environnement, Claude l'utilise automatiquement lorsqu'elle est pertinente pour votre demande.

Les Agent Skills préconstruites sont disponibles sur claude.ai, l'API Claude, Claude Platform sur AWS et Microsoft Foundry. Sur Microsoft Foundry, les Agent Skills nécessitent un déploiement Hosted on Anthropic. Consultez Skills disponibles pour la liste complète.

Les Skills personnalisées vous permettent de regrouper une expertise de domaine et des connaissances organisationnelles. Elles 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 sur AWS et Microsoft Foundry, téléversez les Skills personnalisées via l'API Skills.



Comment fonctionnent les Skills

Les Skills utilisent l'environnement de machine virtuelle 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, 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 le contexte dès le départ.

Les Skills peuvent contenir trois types de contenu, chacun chargé à un moment différent :



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

Le frontmatter YAML de la Skill fournit les 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. La description est ce que Claude compare à votre demande pour déterminer s'il faut déclencher la Skill, elle doit donc indiquer à la fois ce que fait la Skill et quand l'utiliser. Cette approche légère signifie que vous pouvez installer de nombreuses Skills sans pénalité de contexte : tant qu'une Skill n'est pas déclenchée, seuls son nom et sa description occupent le contexte.



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

Le corps principal de SKILL.md contient les connaissances procédurales : flux de travail, bonnes pratiques et consignes :

# 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'une Skill, Claude lit SKILL.md depuis le système de fichiers en utilisant 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)

Les Skills peuvent regrouper des documents supplémentaires :

pdf-processing/
├── 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 consignes et des flux de travail spécialisés

Code : Scripts exécutables (fill_form.py, validate.py) que Claude exécute avec bash, fournissant des opérations déterministes sans charger leur code dans le contexte

Ressources : Documents 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 basé sur le système de fichiers signifie que chaque type de contenu a des atouts différents : les instructions pour des consignes 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 à un moment donné.



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. Les Skills existent sous forme de répertoires sur une machine virtuelle, et Claude interagit avec elles en utilisant les mêmes commandes bash que vous utiliseriez pour naviguer dans les fichiers de votre ordinateur.

Comment Claude accède au contenu d'une Skill :

Lorsqu'une Skill est déclenchée, Claude utilise bash pour lire SKILL.md depuis le système de fichiers, amenant ses instructions dans la fenêtre de contexte. Si ces instructions référencent 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 ne lit que les fichiers dont chaque tâche a besoin. Une Skill peut inclure des dizaines de fichiers de référence, mais si votre tâche n'a besoin que du schéma des ventes, c'est le seul fichier que Claude charge. Les autres restent sur le système de fichiers et ne coûtent aucun 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 sa sortie (comme « Validation passed » ou un message d'erreur spécifique) consomme des tokens, ce qui rend les scripts bien plus efficaces que de demander à Claude de générer un code équivalent à la volée.
• Aucune limite pratique sur le contenu regroupé : Les fichiers ne consomment pas de contexte tant qu'ils ne sont pas accédés, les Skills peuvent donc inclure une documentation API complète, de grands ensembles de données ou des exemples détaillés. Il n'y a aucune pénalité de contexte pour le contenu regroupé qui n'est pas utilisé.



Exemple : Chargement d'une Skill de traitement de PDF

Voici comment Claude charge et utilise la Skill personnalisée pdf-processing des exemples précédents (et non la Skill préconstruite pdf) :

1. Démarrage : L'invite système inclut : pdf-processing - 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.
2. Demande de l'utilisateur : « Extrais le texte de ce PDF et résume-le »
3. Claude invoque : bash: cat pdf-processing/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



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éconstruites et les Skills personnalisées. 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 l'outil d'exécution de code, dans le conteneur duquel les Skills s'exécutent, et un en-tête bêta :

• skills-2025-10-02 - Active la fonctionnalité Skills

Ajoutez un second en-tête, files-api-2025-04-14, lorsque vous utilisez l'API Files pour téléverser des fichiers d'entrée dans le conteneur ou télécharger des fichiers produits par une Skill.

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

Les Skills sur l'API s'exécutent dans un conteneur isolé (sandbox) sans accès réseau et sans installation de paquets à l'exécution. Consultez Limitations et contraintes pour plus de détails.

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



Claude Code

Claude Code prend en charge les Skills personnalisées. Les Skills documentaires préconstruites (PowerPoint, Excel, Word, PDF) ne sont pas disponibles dans Claude Code, bien que la skill API Claude open source soit fournie avec celui-ci. Consultez la liste complète des commandes et Skills intégrées livrées avec Claude Code.

Skills personnalisées : 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ées dans Claude Code sont basées sur le système de fichiers et ne nécessitent pas de téléversement via l'API : placez-les dans ~/.claude/skills/ (personnel) ou .claude/skills/ (projet).

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



claude.ai

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

Agent Skills préconstruites : Ces Skills sont actives lorsque vous créez des documents. Claude les utilise sans aucune configuration requise.

Skills personnalisées : 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ées sont individuelles pour chaque utilisateur. Elles ne sont pas partagées à l'échelle de l'organisation et ne peuvent pas être gérées 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ées
• Apprenez à Claude votre façon de travailler avec les Skills



Structure d'une 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 traits d'union
• Ne peut pas contenir de balises XML
• Ne peut pas contenir les 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 la Skill et quand Claude doit l'utiliser. Pour des consignes de rédaction complètes, consultez Bonnes pratiques de rédaction de Skills.



Considérations de sécurité

N'utilisez que des Skills provenant de sources fiables : celles que vous avez créées vous-même ou obtenues auprès d'Anthropic. Les Skills donnent à Claude de nouvelles capacités via des instructions et du code, ce qui signifie également qu'une Skill malveillante peut amener Claude à invoquer des outils ou à exécuter du code d'une manière qui ne correspond pas à l'objectif déclaré de la Skill.

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

• Auditez minutieusement : Examinez tous les fichiers regroupés dans la 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é de la 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 compromises si leurs dépendances externes changent au fil du temps
• Utilisation abusive des outils : Des Skills malveillantes 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çues pour divulguer des informations à des systèmes externes
• Traitez cela comme l'installation d'un logiciel : Soyez particulièrement prudent lorsque vous intégrez des Skills dans des systèmes de production ayant accès à des données sensibles ou à des opérations critiques

Pour des conseils sur la gouvernance, la vérification et le déploiement à l'échelle de l'organisation, consultez Skills pour l'entreprise.



Skills disponibles



Agent Skills préconstruites

Les Agent Skills préconstruites suivantes sont disponibles pour une utilisation immédiate :

• PowerPoint (pptx) : Créer des présentations, modifier des diapositives, analyser le contenu de 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 mis en forme

Ces Skills sont disponibles sur l'API Claude, Claude Platform sur 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 :

• Skill API Claude : Fournit à Claude des documents de référence API à jour, de la documentation SDK et des bonnes pratiques pour huit langages de programmation. Fournie avec Claude Code et également disponible pour installation depuis le dépôt skills.



Exemples de Skills personnalisées

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



Conservation des données

Les Agent Skills ne sont pas couvertes 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

Claude Platform sur AWS et Microsoft Foundry suivent les mêmes limitations que l'API Claude dans les sous-sections suivantes.



Disponibilité entre les surfaces

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

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

Gérez et téléversez les Skills séparément pour chaque surface où vous souhaitez les utiliser.



Portée du partage

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

• claude.ai : Utilisateur individuel uniquement. Chaque membre de l'équipe doit les 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ées.
• Claude Code : Personnel (~/.claude/skills/) ou basé sur le projet (.claude/skills/). Peuvent également être partagées via les plugins Claude Code.

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ées.



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 de l'utilisateur/administrateur, les Skills peuvent avoir un accès réseau complet, partiel ou inexistant. Pour plus de détails, consultez l'article d'assistance Create and Edit Files.
• API Claude :
  • Aucun accès réseau : Les Skills ne peuvent pas effectuer d'appels API externes ni accéder à Internet.
  • Aucune installation de paquets à l'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 uniquement : 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 globale de paquets déconseillée : Les Skills ne doivent installer des paquets que localement pour éviter d'interférer avec l'ordinateur de l'utilisateur.

Concevez vos Skills pour qu'elles fonctionnent dans le cadre de ces contraintes.



Prochaines étapes