Agent Skills

Pourquoi utiliser les Skills

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

Principaux avantages :

• Spécialiser Claude : Adaptez les capacités aux 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éconçus 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 : une fois qu'un Skill est disponible dans votre environnement, Claude l'utilise automatiquement lorsqu'il est pertinent pour votre demande.

Les Agent Skills préconçus sont disponibles sur claude.ai, l'API Claude, Claude Platform on 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és vous permettent de regrouper une expertise de domaine et des connaissances organisationnelles. Ils sont disponibles dans tous les produits de 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 des Skills personnalisés 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 invites seules. 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 une divulgation progressive : Claude charge les informations par étapes selon les besoins, plutôt que de consommer du 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 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. La description est ce à quoi Claude compare votre demande pour déterminer s'il faut déclencher le Skill, elle doit donc indiquer à la fois ce que fait le Skill et quand l'utiliser. Cette approche légère signifie que vous pouvez installer de nombreux Skills sans pénalité de contexte : jusqu'à ce qu'un Skill soit déclenché, seuls son nom et sa description occupent du contexte.

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

Le corps principal de SKILL.md contient des 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 à l'aide de bash. Ce n'est qu'à ce moment que ce contenu entre dans la « context window » (fenêtre de contexte).

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

Les Skills peuvent regrouper des éléments supplémentaires :

• pdf-processing/
  • SKILL.md (instructions principales)
  • FORMS.md (guide de remplissage de formulaires)
  • REFERENCE.md (référence API détaillée)
  • scripts/
    • fill_form.py (script utilitaire)

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 à l'aide de 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 d'API, des modèles ou des exemples.

Claude n'accède à ces fichiers que 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 à l'aide des mêmes commandes bash que celles que vous utiliseriez pour parcourir des fichiers sur votre ordinateur.

Comment Claude accède au contenu des Skills :

Lorsqu'une Skill est déclenchée, Claude utilise bash pour lire SKILL.md depuis le système de fichiers, ce qui fait entrer 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 permet cette architecture :

• 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 n'est jamais chargé 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 du code équivalent à la volée.
• Aucune limite pratique au contenu regroupé : les fichiers ne consomment pas de contexte tant qu'ils ne sont pas consultés, de sorte que les Skills peuvent inclure une documentation d'API complète, de grands jeux de données ou de nombreux exemples. Le contenu regroupé qui n'est pas utilisé n'entraîne aucune pénalité de contexte.

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édéfinie 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 formulaires n'est pas nécessaire, donc FORMS.md n'est pas lu.
5. Claude exécute : il utilise les instructions de SKILL.md pour accomplir la tâche.

Où fonctionnent les Skills

Les Skills sont disponibles dans l'ensemble des produits d'agent de Claude :

API Claude

L'API Claude prend en charge à la fois les Agent Skills prédéfinies 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.

Utilisez les Agent Skills prédéfinies 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édéfinies (PowerPoint, Excel, Word, PDF) ne sont pas disponibles dans Claude Code, bien que la Skill Claude API open source y soit intégrée. Consultez la liste complète des commandes et Skills intégrées fournies avec Claude Code.

Skills personnalisées : créez des Skills sous forme de répertoires contenant 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/ (personnelles) 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édéfinies et les Skills personnalisées.

Agent Skills prédéfinies : 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 Settings > Features. Disponible avec les forfaits Pro, Max, Team et Enterprise avec l'exécution de code activée. Les Skills personnalisées sont propres à 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 du 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 grâce aux 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 requis : name et description

Exigences des champs :

name :

• Maximum 64 caractères
• Ne doit contenir que des lettres minuscules, des chiffres et des traits d'union
• 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 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 : ceux que vous avez créés vous-même ou obtenus d'Anthropic. Les Skills confèrent à Claude de nouvelles capacités via des instructions et du code, ce qui 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 modèles inhabituels tels que 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 les Skills dignes de confiance peuvent être compromis si leurs dépendances externes changent au fil du temps
• Mauvaise utilisation des outils : Les 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 : Les Skills ayant accès à des données sensibles pourraient être conçus pour divulguer des informations à des systèmes externes
• Traitez-les comme l'installation d'un logiciel : 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

Pour des consignes de gouvernance, de vérification et de déploiement à l'échelle de l'organisation, consultez Skills pour l'entreprise. Les organisations Claude Enterprise peuvent également activer l'analyse du contenu des Skills pour les Skills personnalisés téléversés dans claude.ai et Claude Cowork. L'analyse ne couvre pas les Skills téléversés via l'API Skills ou la Claude Console.

Skills disponibles

Agent Skills préconçus

Les Agent Skills préconçus 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 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 :

• Claude API skill : Fournit à Claude des documents de référence API à jour, de la documentation SDK et des bonnes pratiques pour huit langages de programmation. Fourni 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 sur toutes les fonctionnalités, consultez API et conservation des données.

Pour la journalisation d'audit des opérations de l'API Skills, consultez Journalisation d'audit dans Utiliser les Agent Skills avec l'API.

Limitations et contraintes

Claude Platform on AWS et Microsoft Foundry sont soumis aux mêmes limitations que l'API Claude dans les sous-sections suivantes. En outre, sur Microsoft Foundry, le point de terminaison de téléchargement des versions de Skill (GET /v1/skills/{skill_id}/versions/{version}/content) n'est pas pris en charge.

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 à la fois 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 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 administrative centralisée 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'aide 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 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 devraient installer des packages que localement pour é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