Les Skills sont disponibles pour les utilisateurs des plans Pro, Max, Team et Enterprise. Cette fonctionnalité nécessite que l'exécution de code soit activée. Les Skills sont également disponibles en version bêta pour les utilisateurs de Claude Code et pour tous les utilisateurs d'API utilisant l'outil d'exécution de code.
Les Skills personnalisés vous permettent d'améliorer Claude avec des connaissances spécialisées et des flux de travail spécifiques à votre organisation ou à votre style de travail personnel. Cet article explique comment créer, structurer et tester vos propres Skills.
Les Skills peuvent être aussi simples que quelques lignes d'instructions ou aussi complexes que des packages multi-fichiers avec du code exécutable. Les meilleurs Skills :
Résolvent une tâche spécifique et répétable
Ont des instructions claires que Claude peut suivre
Incluent des exemples si utile
Définissent quand ils doivent être utilisés
Se concentrent sur un flux de travail plutôt que d'essayer de tout faire
Créer un fichier Skill.md
Chaque Skill se compose d'un répertoire contenant au minimum un fichier Skill.md, qui est le cœur du Skill. Ce fichier doit commencer par un préambule YAML pour contenir les champs de nom et de description, qui sont des métadonnées obligatoires. Il peut également contenir des métadonnées supplémentaires, des instructions pour Claude ou des fichiers de référence, des scripts exécutables ou des outils.
Champs de métadonnées obligatoires
name : Un nom convivial pour votre Skill (64 caractères maximum)
Exemple : Directives de marque
description : Une description claire de ce que fait le Skill et quand l'utiliser.
C'est essentiel — Claude utilise ceci pour déterminer quand invoquer votre Skill (200 caractères maximum).
Exemple : Appliquer les directives de marque d'Acme Corp aux présentations et documents, y compris les couleurs officielles, les polices et l'utilisation du logo.
Champs de métadonnées optionnels
dependencies : Packages logiciels requis par votre Skill.
Exemple : python>=3.8, pandas>=1.5.0
Les métadonnées du fichier Skill.md servent de premier niveau d'un système de divulgation progressive, fournissant juste assez d'informations pour que Claude sache quand le Skill doit être utilisé sans avoir à charger tout le contenu.
Corps Markdown
Le corps Markdown est le deuxième niveau de détail après les métadonnées, donc Claude y accédera si nécessaire après avoir lu les métadonnées. Selon votre tâche, Claude peut accéder au fichier Skill.md et utiliser le Skill.
Exemple de Skill.md
Skill Directives de marque
## Métadonnées
name: Directives de marque
description: Appliquer les directives de marque d'Acme Corp à toutes les présentations et documents
## Aperçu
Ce Skill fournit les directives de marque officielles d'Acme Corp pour créer des matériaux cohérents et professionnels. Lors de la création de présentations, de documents ou de matériaux marketing, appliquez ces normes pour assurer que tous les résultats correspondent à l'identité visuelle d'Acme. Claude doit référencer ces directives chaque fois qu'il crée des matériaux destinés à l'externe ou des documents qui représentent Acme Corp.
## Couleurs de marque
Nos couleurs de marque officielles sont :
- Primaire : #FF6B35 (Corail)
- Secondaire : #004E89 (Bleu marine)
- Accent : #F7B801 (Or)
- Neutre : #2E2E2E (Charbon)
## Typographie
En-têtes : Montserrat Gras
Texte du corps : Open Sans Régulier
Directives de taille :
- H1 : 32pt
- H2 : 24pt
- Corps : 11pt
## Utilisation du logo
Utilisez toujours le logo en couleur complète sur les fonds clairs. Utilisez le logo blanc sur les fonds sombres. Maintenez un espacement minimum de 0,5 pouce autour du logo.
## Quand appliquer
Appliquez ces directives chaque fois que vous créez :
- Présentations PowerPoint
- Documents Word pour partage externe
- Matériaux marketing
- Rapports pour les clients
## Ressources
Consultez le dossier des ressources pour les fichiers de logo et les téléchargements de polices.
Ajouter des ressources
Si vous avez trop d'informations à ajouter à un seul fichier Skill.md (par exemple, des sections qui ne s'appliquent qu'à des scénarios spécifiques), vous pouvez ajouter plus de contenu en ajoutant des fichiers dans votre répertoire Skill. Par exemple, ajoutez un fichier REFERENCE.md contenant des informations supplémentaires et de référence à votre répertoire Skill. Le référencer dans Skill.md aidera Claude à décider s'il doit accéder à cette ressource lors de l'exécution du Skill.
Ajouter des scripts
Pour les Skills plus avancés, joignez des fichiers de code exécutable à Skill.md, permettant à Claude d'exécuter du code. Par exemple, nos Skills de document utilisent les langages de programmation et packages suivants :
Python (pandas, numpy, matplotlib)
JavaScript/Node.js
Packages pour aider à l'édition de fichiers
outils de visualisation
Remarque : Claude et Claude Code peuvent installer des packages à partir de référentiels standard (Python PyPI, JavaScript npm) lors du chargement de Skills. Il n'est pas possible d'installer des packages supplémentaires à l'exécution avec les Skills d'API — toutes les dépendances doivent être pré-installées dans le conteneur.
Empaqueter votre Skill
Une fois votre dossier Skill complet :
Assurez-vous que le nom du dossier correspond au nom de votre Skill.
Créez un fichier ZIP du dossier.
Le ZIP doit contenir le dossier Skill comme racine (pas un sous-dossier).
Structure correcte :
my-Skill.zip
└── my-Skill/
├── Skill.md
└── resources/
Structure incorrecte :
my-Skill.zip
└── (fichiers directement à la racine du ZIP)
Tester votre Skill
Avant le téléchargement
1. Vérifiez votre Skill.md pour la clarté
2. Vérifiez que la description reflète avec précision quand Claude doit utiliser le Skill
3. Vérifiez que tous les fichiers référencés existent aux emplacements corrects
4. Testez avec des invites d'exemple pour assurer que Claude l'invoque correctement
Après le téléchargement sur Claude
1. Activez le Skill dans Paramètres > Capacités.
2. Essayez plusieurs invites différentes qui devraient le déclencher
3. Vérifiez la réflexion de Claude pour confirmer qu'il charge le Skill
4. Itérez sur la description si Claude ne l'utilise pas quand prévu
Remarque pour les plans Team et Enterprise : Pour rendre une compétence disponible à tous les utilisateurs de votre organisation, consultez Provisioning and managing Skills for your organization.
Meilleures pratiques
Restez concentré : Créez des Skills séparés pour différents flux de travail. Plusieurs Skills concentrés se composent mieux qu'un grand Skill.
Écrivez des descriptions claires : Claude utilise les descriptions pour décider quand invoquer votre Skill. Soyez spécifique sur quand il s'applique.
Commencez simplement : Commencez par des instructions de base en Markdown avant d'ajouter des scripts complexes. Vous pouvez toujours développer le Skill plus tard.
Utilisez des exemples : Incluez des exemples d'entrées et de sorties dans votre fichier Skill.md pour aider Claude à comprendre ce que la réussite ressemble.
Testez progressivement : Testez après chaque changement significatif plutôt que de construire un Skill complexe d'un seul coup.
Les Skills peuvent s'appuyer les uns sur les autres : Bien que les Skills ne puissent pas référencer explicitement d'autres Skills, Claude peut utiliser plusieurs Skills ensemble automatiquement. Cette composabilité est l'une des parties les plus puissantes de la fonctionnalité Skills.
Consultez la spécification Agent Skills ouverte : Suivez les directives sur agentskills.io, afin que les compétences que vous créez puissent fonctionner sur les plateformes qui adoptent la norme.
Pour un guide plus approfondi de la création de compétences, consultez Skill authoring best practices dans notre Claude Docs.
Considérations de sécurité
Soyez prudent lors de l'ajout de scripts à votre fichier Skill.md.
Ne codez pas en dur les informations sensibles (clés API, mots de passe).
Vérifiez tous les Skills que vous téléchargez avant de les activer.
Utilisez les connexions MCP appropriées pour l'accès aux services externes.
Exemples de Skills à consulter
Visitez notre référentiel sur GitHub pour des exemples de Skills que vous pouvez utiliser comme modèles : https://github.com/anthropics/skills/tree/main/skills.