Les compétences sont disponibles pour les utilisateurs des plans gratuit, Pro, Max, Team et Enterprise. Cette fonctionnalité nécessite que l'exécution de code soit activée. Les compétences 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 compétences personnalisées 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 compétences.
Les compétences peuvent être aussi simples que quelques lignes d'instructions ou aussi complexes que des packages multi-fichiers avec du code exécutable. Les meilleures compétences :
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 elles doivent être utilisées
Se concentrent sur un flux de travail plutôt que d'essayer de tout faire
Créer un fichier skill.md
Chaque compétence se compose d'un répertoire contenant au minimum un fichier skill.md, qui est le cœur de la compétence. 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 compétence (64 caractères maximum)
Exemple : Directives de marque
description : Une description claire de ce que fait la compétence et quand l'utiliser.
C'est critique — Claude utilise ceci pour déterminer quand invoquer votre compétence (200 caractères maximum).
Exemple : Appliquer les directives de marque Acme Corp aux présentations et documents, y compris les couleurs officielles, les polices et l'utilisation du logo.
Champs de métadonnées facultatifs
dependencies : Packages logiciels requis par votre compétence.
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 la compétence doit être utilisée 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 la compétence.
Exemple skill.md
Compétence de directives de marque
## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents
## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.
## Brand Colors
Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)
## Typography
Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt
## Logo Usage
Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.
## When to Apply
Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients
## Resources
See the resources folder for logo files and font downloads.
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 de compétences. Par exemple, ajoutez un fichier REFERENCE.md contenant des informations supplémentaires et de référence à votre répertoire de compétences. Le référencer dans skill.md aidera Claude à décider s'il doit accéder à cette ressource lors de l'exécution de la compétence.
Ajouter des scripts
Pour les compétences plus avancées, joignez des fichiers de code exécutable à skill.md, permettant à Claude d'exécuter du code. Par exemple, nos compétences 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 des compétences. Il n'est pas possible d'installer des packages supplémentaires à l'exécution avec les compétences API — toutes les dépendances doivent être pré-installées dans le conteneur.
Empaqueter votre compétence
Une fois votre dossier de compétences complet :
Assurez-vous que le nom du dossier correspond au nom de votre compétence.
Créez un fichier ZIP du dossier.
Le ZIP doit contenir le dossier de compétences 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 compétence
Avant de télécharger
1. Vérifiez votre skill.md pour la clarté.
2. Vérifiez que la description reflète avec précision quand Claude doit utiliser la compétence.
3. Vérifiez que tous les fichiers référencés existent aux emplacements corrects.
4. Testez avec des invites d'exemple pour vous assurer que Claude l'invoque correctement.
Après le téléchargement sur Claude
1. Activez la compétence dans Personnaliser > Compétences.
2. Essayez plusieurs invites différentes qui devraient la déclencher.
3. Vérifiez la réflexion de Claude pour confirmer qu'il charge la compétence.
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 Provisionner et gérer les compétences pour votre organisation.
Meilleures pratiques
Restez concentré : Créez des compétences séparées pour différents flux de travail. Plusieurs compétences ciblées se composent mieux qu'une grande compétence.
Écrivez des descriptions claires : Claude utilise les descriptions pour décider quand invoquer votre compétence. Soyez spécifique sur quand elle s'applique.
Commencez simple : Commencez par des instructions de base en Markdown avant d'ajouter des scripts complexes. Vous pouvez toujours développer la compétence 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 une compétence complexe d'un seul coup.
Les compétences peuvent s'appuyer les unes sur les autres : Bien que les compétences ne puissent pas référencer explicitement d'autres compétences, Claude peut utiliser plusieurs compétences ensemble automatiquement. Cette composabilité est l'une des parties les plus puissantes de la fonctionnalité de compétences.
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 Meilleures pratiques de création de compétences 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 toutes les compétences que vous téléchargez avant de les activer.
Utilisez les connexions MCP appropriées pour l'accès aux services externes.
Exemples de compétences à consulter
Visitez notre référentiel sur GitHub pour des exemples de compétences que vous pouvez utiliser comme modèles : https://github.com/anthropics/skills/tree/main/skills.