Les compétences sont disponibles pour les utilisateurs des plans Free, 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
Enregistrer une compétence
L'enregistrement d'une compétence est disponible sur les plans Pro, Max et Team, dans Cowork dans Claude pour Mac. Ce n'est pas disponible dans le chat, sur Windows, ou sur les plans Free et Enterprise.
Au lieu d'écrire une compétence à la main, vous pouvez vous enregistrer en train d'effectuer une tâche et laisser Claude construire la compétence à partir de ce qu'il observe. Vous envoyez à Claude une vidéo de votre écran, de vos clics, de votre saisie et de votre voix, et Claude propose une compétence que vous pouvez examiner avant de la sauvegarder.
Avant d'enregistrer
Mettez à jour vers la dernière version de Claude pour Mac.
Accordez les autorisations macOS que Claude demande la première fois que vous enregistrez : Accessibilité pour le suivi de la souris et du clavier, et Enregistrement d'écran pour la visibilité de l'écran. macOS peut vous demander de redémarrer Claude.
Fermez tous les fichiers, applications ou conversations que vous ne souhaitez pas capturer.
Avertissement : Ne tapez pas de mots de passe ou de secrets, et n'affichez pas d'informations sensibles ou de conversations privées lors de l'enregistrement. Tout ce qui se trouve sur votre écran est capturé pendant la durée de la session, ainsi que tout ce que vous dites.
Enregistrez votre flux de travail
Ouvrez Cowork dans Claude pour Mac.
Commencez un enregistrement de deux façons :
Cliquez sur le bouton « + » dans le compositeur, puis sélectionnez « Enregistrer une compétence ».
Allez à Personnaliser > Compétences, cliquez sur « Ajouter », puis sélectionnez « Enregistrer votre écran ».
Cliquez sur « Commencer l'enregistrement ». Pour narrer pendant que vous travaillez, laissez le microphone activé. Utilisez la commande du microphone pour le désactiver ou choisir une entrée différente.
Effectuez la tâche comme vous le feriez normalement. La barre de capture montre que l'enregistrement est en cours et compte les étapes qu'elle a capturées.
Cliquez sur « Terminé » quand vous avez fini, ou « Abandonner » pour supprimer l'enregistrement sans rien créer.
Un enregistrement peut durer environ 10 minutes. Un compte à rebours apparaît dans la barre de capture quand il vous reste environ une minute. Quand il atteint zéro, l'enregistrement s'arrête et tout ce que vous avez capturé jusqu'à ce moment est envoyé à Claude, comme si vous aviez cliqué sur « Terminé ».
Conseil : Parlez de ce que vous faites pendant que vous enregistrez. La narration donne à Claude un contexte qu'il ne peut pas obtenir de votre écran seul, comme pourquoi vous sautez une étape ou comment vous choisissez entre deux options.
Ce qui se passe après que vous ayez cliqué sur Terminé
Claude démarre une tâche Cowork et examine l'enregistrement, puis propose une compétence. Selon ce qu'il trouve, vous verrez l'une de deux choses :
Une nouvelle compétence, marquée NOUVELLE sur la carte de proposition. Cliquez sur « Enregistrer » pour la conserver, ou « Rejeter » pour abandonner la proposition.
Une mise à jour d'une compétence existante. Si l'enregistrement chevauche une compétence que vous avez déjà, Claude propose des modifications à cette compétence à la place. La carte indique sur quelle compétence la proposition est basée. Cliquez sur « Mettre à jour » pour appliquer les modifications, ou « Rejeter » pour les abandonner.
Développez Contenu sur la carte de proposition pour lire la compétence avant de décider.
Les compétences que vous enregistrez à partir d'un enregistrement apparaissent dans Personnaliser > Compétences et fonctionnent comme n'importe quelle autre compétence. Vous pouvez les modifier, les partager et les supprimer selon les mêmes conditions.
Ce qui est conservé d'un enregistrement
La vidéo et l'audio de votre enregistrement ne sont pas conservés. Après avoir envoyé votre enregistrement à Claude, Claude examine l'enregistrement pour construire la compétence. Ce qui est sauvegardé par la suite est un ensemble de captures d'écran de la session, que vous pouvez consulter en développant l'étape Démonstration enregistrée dans la tâche.
Parce que ces captures d'écran se trouvent dans la tâche Cowork, la suppression de la tâche les supprime. Consultez Commencer avec Claude Cowork pour savoir comment fonctionne la suppression et la rétention des tâches.
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 frontmatter YAML pour contenir les champs de nom et de description, qui sont des métadonnées requises. 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 requis
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 : Appliquez 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 optionnels
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 la lecture des métadonnées. Selon votre tâche, Claude peut accéder au fichier skill.md et utiliser la compétence.
Exemple skill.md
Directives de marque pour les compétences
## 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 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étence terminé :
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étence 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)
Testez 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 le moment où 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 vers 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 comme prévu.
Lorsque vous itérez sur une compétence avec Claude en chat, vous pouvez modifier les fichiers de compétence directement où ils s'ouvrent à côté de la conversation. Mettez en surbrillance le texte que vous souhaitez modifier, cliquez sur « Modifier avec Claude » et tapez votre demande. Pour les compétences avec plusieurs fichiers, laissez les demandes de modification dans les fichiers et envoyez-les ensemble, et Claude les applique en une seule passe. En savoir plus sur l'édition d'artefacts.
Remarque pour les plans Team et Enterprise : Pour mettre une compétence à la disposition de tous les utilisateurs de votre organisation, consultez Provisionner et gérer les compétences de 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 précis sur le moment où elle s'applique.
Commencez simplement : 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 de manière incrémentale : 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 ouverte Agent Skills : 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 sur la création de compétences, consultez Meilleures pratiques de création de compétences dans notre documentation Claude.
Considérations de sécurité
Soyez prudent lorsque vous ajoutez des scripts à votre fichier skill.md.
Ne codez pas en dur les informations sensibles (clés API, mots de passe).
Vérifiez les compétences que vous téléchargez avant de les activer.
Utilisez les connexions MCP appropriées pour accéder 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.