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 hébergé sur 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 la « progressive disclosure » (divulgation progressive) : Claude charge les informations par étapes, au fur et à mesure des 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 : 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 faites une demande 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’à 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 conseils et des workflows 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’un Skill est déclenché, Claude utilise bash pour lire SKILL.md depuis le système de fichiers, ce qui introduit 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 cette architecture rend possible :

• 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 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 pendant la tâche.
• Aucune limite pratique au contenu inclus : Les fichiers ne consomment pas de contexte tant qu’ils ne sont pas consultés, de sorte que les Skills peuvent inclure une documentation API complète, de grands jeux de données ou de nombreux exemples. Le contenu inclus 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’« system prompt » (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 appelle : 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 Claude ne lit pas FORMS.md.
5. Claude accomplit la tâche : Utilise les instructions de SKILL.md.

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és : 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. Disponible avec les forfaits Pro, Max, Ultra, Team et Enterprise avec l’exécution de code activée.

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 :

• 64 caractères maximum
• 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
• 1 024 caractères maximum
• 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 auprès d’Anthropic. Les Skills donnent à Claude de nouvelles capacités par le biais d’instructions et de code, ce qui signifie également qu’un Skill malveillant peut amener Claude à appeler 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 inclus dans le 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é 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 appeler 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.
• Traitez-les 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 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 :

• Skill Claude API : 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 l’Agent 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 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 SkillAperçu disponible avec des liens vers la référence de l’API, appuyez sur Tab jusqu’à ce que le focus entre dans la carte, et sur Échap pour revenir. (GET /v1/skills/{skill_id}/versions/{version}/content) n’est pas disponible.

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 vers 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 sont 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 :

• 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 plugins Claude Code.

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 ou de l’administrateur, les Skills peuvent disposer d’un accès réseau complet, partiel ou inexistant. Pour plus de détails, consultez l’article d’assistance Créer et modifier des fichiers avec Claude.
• 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 disposent du 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 afin d’é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

Disponibilité