Vue d’ensemble

Pourquoi utiliser Skills

Skills sont des ressources réutilisables fondées sur le système de fichiers. Elles donnent à Claude une expertise propre à un domaine : workflows, contexte et bonnes pratiques qui transforment des agents généralistes en spécialistes. Contrairement aux prompts, qui sont des instructions au niveau d’une conversation pour des tâches ponctuelles, Skills se chargent à la demande et évitent de répéter les mêmes consignes dans plusieurs conversations.

Principaux avantages:

• Spécialiser Claude: adapter ses capacités à des tâches propres à un domaine
• Réduire la répétition: créer une fois, réutiliser automatiquement
• Composer des capacités: combiner plusieurs Skills pour construire des workflows complexes

Utiliser Skills

Anthropic fournit des Agent Skills préconstruites pour les tâches documentaires courantes (PowerPoint, Excel, Word, PDF), et vous pouvez aussi créer vos propres Skills personnalisées. Les deux fonctionnent de la même façon. Claude les utilise automatiquement lorsqu’elles sont pertinentes pour votre demande.

Les Agent Skills préconstruites sont disponibles pour tous les utilisateurs sur claude.ai et via la Claude API. Consultez la section Skills disponibles ci-dessous 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 les produits Claude : créez-les dans Claude Code, téléversez-les via l’API ou ajoutez-les dans les paramètres de claude.ai.

Fonctionnement de Skills

Skills exploitent l’environnement VM de Claude pour fournir des capacités au-delà de ce que les prompts seuls permettent. Claude fonctionne 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 pour un nouveau membre d’équipe.

Cette architecture basée sur le système de fichiers permet la divulgation progressive: Claude charge les informations par étapes, selon les besoins, au lieu de consommer le contexte dès le départ.

Trois types de contenu Skill, trois niveaux de chargement

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 YAML frontmatter 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 le prompt système. Cette approche légère permet d’installer de nombreuses Skills sans pénalité de contexte; Claude sait seulement que chaque Skill existe et quand l’utiliser.

Niveau 2: Instructions (chargées au déclenchement)

Type de contenu: instructions. 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 votre demande correspond à la description d’une Skill, Claude lit SKILL.md depuis le système de fichiers via 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)

Types de contenu: instructions, code et ressources. Skills peuvent regrouper des éléments 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 workflows.

Code: scripts exécutables (fill_form.py, validate.py) que Claude lance via bash; les scripts fournissent des opérations déterministes sans consommer de contexte.

Ressources: documents de référence comme 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 de système de fichiers donne à chaque type de contenu des forces différentes: les instructions pour une guidance flexible, 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 instant donné.

L’architecture de Skills

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. On peut le voir ainsi : les Skills existent comme des répertoires sur une machine virtuelle, et Claude interagit avec elles avec 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 et amener 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 les lit aussi avec des 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 nécessaires à chaque tâche précise. Une Skill peut inclure des dizaines de fichiers de référence, mais si votre tâche n’a besoin que du schéma sales, Claude ne charge que ce fichier. Les autres restent sur le système de fichiers et ne consomment aucun token.

Exécution efficace des scripts: Lorsque Claude lance validate_form.py, le code du script n’est jamais chargé dans la fenêtre de contexte. Seule la sortie du script, comme "Validation passed" ou des messages d’erreur précis, consomme des tokens. Les scripts sont donc beaucoup plus efficaces que demander à Claude de générer un code équivalent à la volée.

Aucune limite pratique sur le contenu regroupé: Comme les fichiers ne consomment pas de contexte tant qu’ils ne sont pas consultés, les Skills peuvent inclure une documentation API complète, de grands jeux de données, de nombreux exemples ou tout document de référence nécessaire. Le contenu regroupé non utilisé n’a pas de pénalité de contexte.

Ce modèle basé sur le système de fichiers rend possible la divulgation progressive. Claude navigue dans votre Skill comme vous consulteriez des sections précises d’un guide d’intégration, en accédant exactement à ce que chaque tâche exige.

Exemple: charger une Skill de traitement PDF

Voici comment Claude charge et utilise une Skill de traitement PDF:

1. Démarrage: le prompt système contient PDF Processing - Extract text and tables from PDF files, fill forms, merge documents
2. Demande utilisateur: "Extrais le texte de ce PDF et résume-le"
3. Claude invoque: bash: read pdf-skill/SKILL.md -> les instructions sont 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: il utilise les instructions de SKILL.md pour accomplir la tâche

Le schéma montre:

1. L’état par défaut avec le prompt système et les métadonnées de Skill préchargées
2. Claude déclenche la Skill en lisant SKILL.md via bash
3. Claude lit éventuellement d’autres fichiers regroupés, comme FORMS.md, selon les besoins
4. Claude poursuit la tâche

Ce chargement dynamique garantit que seul le contenu pertinent de la Skill occupe la fenêtre de contexte.

Où Skills fonctionne

Skills sont disponibles dans les produits agent de Claude.

Claude API

La Claude API prend en charge les Agent Skills préconstruites et les Skills personnalisées. Les deux fonctionnent de manière identique: indiquez le skill_id pertinent dans le paramètre container avec l’outil d’exécution de code.

Prérequis: utiliser Skills via l’API nécessite trois en-têtes beta:

• code-execution-2025-08-25 - 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éverser et télécharger des fichiers vers ou depuis le conteneur

Utilisez les Agent Skills préconstruites en référençant leur skill_id (par exemple pptx, xlsx), ou créez et téléversez les vôtres via la Skills API (endpoints /v1/skills). Les Skills personnalisées sont partagées à l’échelle de l’organisation.

Pour en savoir plus, consultez Utiliser Skills avec la Claude API.

Claude Code

Claude Code ne prend en charge que les Skills personnalisées.

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 API.

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

Claude.ai

Claude.ai prend en charge les Agent Skills préconstruites et les Skills personnalisées.

Agent Skills préconstruites: ces Skills fonctionnent déjà en arrière-plan lorsque vous créez des documents. Claude les utilise sans configuration.

Skills personnalisées: téléversez vos propres Skills sous forme de fichiers zip via Settings > Features. Disponibles sur les plans 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 centralement par des administrateurs.

Pour en savoir plus sur l’utilisation de Skills dans Claude.ai, consultez ces ressources du Claude Help Center:

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

Structure d’une Skill

Chaque Skill nécessite un fichier SKILL.md avec un YAML frontmatter:

---
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

Ce sont les deux seuls champs pris en charge dans le YAML frontmatter.

Limites du frontmatter:

• name: 64 caractères maximum
• description: 1024 caractères maximum

La description doit indiquer à la fois ce que fait la Skill et quand Claude doit l’utiliser. Pour des conseils complets de rédaction, consultez le guide des bonnes pratiques.

Considérations de sécurité

Nous recommandons fortement de n’utiliser Skills qu’à partir de sources fiables: celles que vous avez créées vous-même ou obtenues d’Anthropic. Skills donne à Claude de nouvelles capacités via des instructions et du code. Cela les rend puissantes, mais signifie aussi qu’une Skill malveillante peut demander à Claude d’invoquer des outils ou d’exécuter du code d’une manière qui ne correspond pas à l’objectif déclaré de la Skill.

Principales considérations de sécurité:

• Auditer soigneusement: examinez tous les fichiers regroupés dans la Skill: SKILL.md, scripts, images et autres ressources. Recherchez des motifs inhabituels comme 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é
• 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 fiables peuvent être compromises si leurs dépendances externes changent avec le temps
• Mauvais usage des outils: des Skills malveillantes peuvent invoquer des outils (opérations de 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
• Traiter comme une installation logicielle: utilisez uniquement Skills provenant de sources fiables. 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

Skills disponibles

Agent Skills préconstruites

Les Agent Skills préconstruites suivantes sont disponibles immédiatement:

• 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 graphiques
• Word (docx): créer des documents, modifier le contenu, mettre en forme le texte
• PDF (pdf): générer des documents et rapports PDF formatés

Ces Skills sont disponibles sur Claude API et claude.ai. Consultez le tutoriel de démarrage rapide pour commencer à les utiliser dans l’API.

Exemples de Skills personnalisées

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

Limites et contraintes

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

Disponibilité entre 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 Claude Code sont basées sur le système de fichiers et distinctes à la fois de Claude.ai et de l’API

Vous devrez gérer et téléverser les Skills séparément pour chaque surface où vous souhaitez les utiliser.

Portée du partage

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
• Claude API: à l’échelle du workspace; tous les membres du workspace peuvent accéder aux Skills téléversées
• Claude Code: personnel (~/.claude/skills/) ou basé sur le projet (.claude/skills/)

Claude.ai ne prend actuellement pas en charge la gestion centralisée par administrateur ni la distribution de Skills personnalisées à l’échelle de l’organisation.

Contraintes de l’environnement d’exécution

Skills s’exécutent dans le conteneur d’exécution de code avec ces limites:

• Pas d’accès réseau: Skills ne peuvent pas appeler des API externes ni accéder à internet
• Pas d’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

Planifiez vos Skills pour fonctionner dans ces contraintes.

Étapes suivantes