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'un Skill, Claude lit SKILL.md depuis le système de fichiers à l'aide de bash. Ce n'est qu'alors 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 (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 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 consignes 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 à 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 eux à l'aide des 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, amenant ses instructions dans la fenêtre de contexte. Si ces instructions référencent d'autres fichiers (tels que 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. Un 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 coûtent 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 sa sortie (telle que « Validation réussie » ou un message d'erreur spécifique) consomme des tokens, ce qui rend les scripts bien plus efficaces que de faire générer à Claude un code équivalent à la volée.
• Aucune limite pratique sur le contenu regroupé : Les fichiers ne consomment pas de contexte jusqu'à ce qu'ils soient accédés, de sorte que les Skills peuvent 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'un Skill de traitement PDF

Voici comment Claude charge et utilise le Skill personnalisé pdf-processing des exemples précédents (et non le Skill préconçu 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 d'agent de Claude :

API Claude

L'API Claude prend en charge à la fois les Agent Skills préconçus 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 l'outil d'exécution de code, dans le conteneur duquel les Skills s'exécutent.

Utilisez les Agent Skills préconçus 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és sont partagés à 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 en bac à sable sans accès réseau et sans installation de packages à 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és. Les Skills documentaires préconçus (PowerPoint, Excel, Word, PDF) ne sont pas disponibles dans Claude Code, bien que le Claude API skill open source soit fourni avec lui. Consultez la liste complète des commandes et Skills intégrés fournis avec Claude Code.

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éversements 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éconçus et les Skills personnalisés.

Agent Skills préconçus : Ces Skills sont actifs lorsque vous créez des documents. Claude les utilise sans configuration requise.

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 de Claude :

• What are Skills?
• Using Skills in Claude
• How to create custom Skills
• Teach Claude your way of working using 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 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 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 à 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