Comment créer des Skills : étapes clés, limitations et exemples

Les Skills sont des instructions personnalisées qui étendent les capacités de Claude pour des tâches ou des domaines spécifiques. 

En créant une Skill à partir d'un fichier SKILL.md, vous apprenez à Claude à gérer des scénarios spécifiques plus efficacement. La puissance des Skills réside dans leur capacité à coder les connaissances institutionnelles, à standardiser les résultats et à gérer des flux de travail complexes en plusieurs étapes qui nécessiteraient autrement des explications répétées ou un investissement dans la création d’un agent personnalisé.

Découvrez comment créer des Skills, grâce auxquelles Claude ne sera plus simplement un assistant polyvalent, mais un expert spécialisé pour vos flux de travail spécifiques, avec notre modèle de création de Skills ou manuellement. (Conseil professionnel : pour vous simplifier la tâche, nous vous recommandons de créer votre fichier SKILL.md à partir de ce modèle, avant de le personnaliser.)

Création d’une Skill en 5 étapes

Suivez cette approche structurée pour créer des Skills au déclenchement plus fiable.

1. Comprendre les exigences de base

Avant de rédiger quoi que ce soit, précisez le problème résolu par votre Skill. Les Skills efficaces répondent à des besoins concrets et offrent des résultats mesurables. « Extraire les données financières de fichiers PDF et les mettre au format CSV » est préférable à « Aide pour mes finances », car la formulation spécifie le format de saisie, l'opération et le résultat attendu.

Commencez par vous demander : quelle tâche spécifique cette Skill peut-elle accomplir ? Quels sont les déclencheurs pour l'activer ? Quels sont les critères de réussite ? Quels sont les cas limites ou les restrictions ?

2. Rédiger le nom

Votre Skill doit comporter trois éléments principaux : un nom (identifiant clair), une description (quand l’activer) et des instructions (comment l’exécuter). En effet, seules le nom et la description du fichier SKILL.md ont une influence sur le déclenchement, c'est-à-dire sur la possibilité pour Claude de faire appel à une Skill pour des connaissances ou des flux de travail spécialisés. 

Le nom doit être simple et descriptif. Utilisez des lettres minuscules accompagnées de traits d’union (éditeur PDF, directives de marque, par exemple). Restez clair et concis.

3. Remplir le champ de description

La description est le composant le plus important, qui détermine quand votre Skill sera activée. Rédigez du point de vue de Claude, en mettant l'accent sur les déclencheurs, les capacités et les cas d'usage.

Une description solide tient compte de plusieurs éléments : capacités spécifiques, déclencheurs clairs, contexte pertinent et limites.

Mauvaise description :

Cette Skill est utile pour les fichiers PDF et les documents.

Description claire :

Boîte à outils complète de manipulation de PDF pour extraire du texte et des tableaux, créer de nouveaux fichiers PDF, fusionner/scinder des documents et gérer des formulaires. Lorsque Claude doit remplir un formulaire PDF ou traiter, générer ou analyser des documents PDF à grande échelle. À utiliser pour les flux de travail de documents et les opérations par lots. Ni pour la simple visualisation de PDF ni pour les conversions de base.

La version plus puissante permet à Claude de disposer de plusieurs niveaux de données : des verbes spécifiques (extraire, créer, fusionner), des cas d'usage concrets (remplissage de formulaires, opérations par lots) et des limites claires (pas de visualisation simple).

4. Rédiger les instructions principales

Vos instructions doivent être structurées, numérisables et exploitables. Les en-têtes doivent être en markdown. Utilisez des listes à puces pour les options et des blocs de code pour les exemples.

La structure doit répondre à une hiérarchie claire : présentation, conditions préalables, étapes d'exécution, exemples, gestion des erreurs et limites. Décomposez les flux de travail complexes en phases distinctes avec entrées/sorties claires.

Donnez des exemples concrets de bon usage. Précisez ce que la Skill ne peut pas empêcher les abus ni gérer les attentes. Votre fichier SKILL.md peut également inclure des fichiers de référence et des ressources supplémentaires pour vous aider à répondre aux demandes de l’agent lorsque la Skill est déclenchée. 

5. Charger votre Skill 

Voici comment votre Skill peut être utilisée en fonction de la surface  Claude utilisée : 

• Claude.ai (applications Claude) : accédez aux Paramètres, où vous pouvez ajouter votre Skill personnalisée. Les Skills personnalisées nécessitent Pro, Max, Team ou Enterprise plan avec exécution de code activée. Les Skills ajoutées ici sont individuelles et propres à chaque utilisateur : elles ne sont pas partagées à l'échelle de l'organisation et ne peuvent pas être gérées de manière centralisée par les administrateurs.
• Claude Code : créez un répertoire skills/ dans votre plugin ou la racine de votre projet et ajoutez des dossiers de skills contenant des fichiers SKILL.md. Claude les détecte et les utilise automatiquement une fois le plug-in installé. Exemple de structure :

• Claude Developer Platform : téléchargement de qualifications via l'API Skills (/v1/skills endpoints). Utilisez une requête POST avec les en-têtes bêta requis :

mon-project/
├── skills/
│ └── my-skill/
│ └── SKILL.md

4. Tests et validation

Testez votre Skill avec des scénarios réalistes avant de la déployer. Les tests systématiques révèlent des lacunes dans les instructions, des ambiguïtés dans les descriptions et des cas limites inattendus qui ne se révèlent que dans la pratique.

Créez une matrice de test couvrant trois scénarios :

curl -X POST "https://api.anthropic.com/v1/skills" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: skills-2025-10-02" \
  -F "display_title=My Skill Name" \
  -F "files[]=@my-skill/SKILL.md;filename=my-skill/SKILL.md"

• Opérations normales : testez la Skill avec les requêtes types qu’elle est censée gérer parfaitement. Si vous avez créé une Skill d’analyse financière, essayez « Analysez les derniers résultats de Microsoft ou créez un datapack pour ce dossier de 10 k ». Ces tests de base confirment que vos instructions fonctionnent correctement.
• Cas limites : test portant sur des données incomplètes ou inhabituelles. Que se passe-t-il en cas de données manquantes ? Quand les formats de fichier sont inattendus ? Lorsque les utilisateurs fournissent des instructions ambiguës ? Votre Skill devrait pouvoir les gérer facilement : produire des résultats dégradés mais utiles, ou expliquer les éléments manquants pour poursuivre.
• Requêtes hors portée : test avec des tâches liées en apparence, mais qui ne doivent pas déclencher votre Skill. Si vous avez créé une Skill pour la révision d’accords de confidentialité, essayez de demander à « réviser ce contrat de travail » ou « analyser ce bail ». La Skill doit rester inactive et laisser les autres Skills ou les capacités générales de Claude traiter la demande.

Pour une validation encore plus approfondie, envisagez de réaliser les tests suivants :

• Tests de déclenchement : la Skill s’active-t-elle comme prévu ? Test avec des requêtes explicites (« Utilisez la skill du pack de données financières pour analyser cette entreprise ») et naturelles (« Aidez-moi à comprendre les résultats financiers de cette entreprise »). Reste-t-elle inactive lorsqu'elle n'est pas pertinente ? Une Skill bien conçue se déclenche uniquement dans les cas pertinents. Testez des requêtes similaires mais différentes pour vérifier les limites.
• Tests fonctionnels : cohérence des résultats (plusieurs essais avec des entrées similaires produisent-ils des résultats comparables ?), facilité d’utilisation (une personne non experte du domaine peut-elle l’utiliser ?) et précision de la documentation (vos exemples correspondent-ils au comportement réel ?). 

5. Faire évoluer en fonction de l'usage

Surveillez les performances de votre Skill en conditions réelles. Affinez les descriptions si elle ne se déclenche pas à bon escient. Précisez les instructions si les résultats varient de manière inattendue. Comme les requêtes, les meilleures Skills sont celles qui ont évolué avec la pratique.

Bonnes pratiques générales pour la création de skills

Ces principes vous permettent de créer des Skills durables, réutilisables et réellement utiles, plutôt que théoriques.

Commencer par les cas d'usage

Ne faites pas de spéculations. Les Skills doivent être réservées aux vraies tâches répétées. Les meilleures Skills résolvent les problèmes auxquels vous êtes confronté régulièrement.

Avant de créer une Skill, demandez-vous : ai-je effectué cette tâche au moins cinq fois ? Vais-je devoir l’exécuter au moins dix fois plus ? Si oui, créez une Skill.

Définir des critères de réussite, et les inclure dans la Skill

Décrivez à Claude un résultat de qualité. Si vous créez des rapports financiers, veuillez préciser les sections requises, les normes de mise en forme, les contrôles de validation et les seuils de qualité. Incluez ces critères dans vos instructions pour que Claude puisse s’auto-corriger.

Utiliser la Skill Créateur de skills

Le créateur de Skills vous guide dans la création de Skills bien structurées. Il pose des questions pour clarifier, suggère des améliorations de la description et perfectionne la mise en forme. Disponible dans le référentiel de Skills sur GitHub et directement via Claude.ai, il est particulièrement utile pour vos premiers examens.

Limites des Skills et considérations

Comprendre le fonctionnement des Skills et leurs limites vous aide à concevoir des Skills plus efficaces et à définir des attentes appropriées.

Activation de la Skill

Claude évalue les descriptions de Skills en fonction de votre requête pour déterminer leur pertinence. Aucune correspondance de mots-clés n’est requise : Claude comprend les relations sémantiques. Toutefois, les descriptions vagues réduisent la précision des déclencheurs.

Plusieurs Skills peuvent être activées simultanément pour autant qu’elles traitent différents aspects d’une tâche complexe. Les descriptions trop génériques entraînent des activations intempestives, tandis que les cas d'usage manquants entraînent des défauts d’activation.

Tailles de fichiers appropriées

Lors de la rédaction, évitez d’engorger la fenêtre de contexte de contenu inutile. Demandez-vous pour chaque information si elle doit être chargée à chaque fois ou seulement à certaines conditions.

Approche par menu : si votre Skill couvre plusieurs processus ou des options distinctes, SKILL.md doit décrire ce qui est disponible et utiliser des chemins relatifs pour référencer des fichiers distincts pour chacun. Claude lit uniquement le fichier pertinent pour la tâche de cet utilisateur, les autres fichiers ne sont pas affectés pour la conversation.

Ces fichiers distincts ne doivent pas nécessairement représenter des chemins d’accès qui s’excluent mutuellement. Le principe clé est de diviser le contenu en portions raisonnables et de laisser Claude choisir ce qui lui convient en fonction de la tâche à accomplir.

‍Exemples concrets

Exemple de Skill n°1 : création de documents

Qualités : arbre de décision clair qui oriente Claude vers le flux de travail adapté au type de tâche, s’appuie sur une divulgation progressive qui permet de garder le fichier principal léger tout en référençant des fichiers de mise en œuvre détaillés uniquement si nécessaire. Exemples concrets, positifs ou négatifs, montrant exactement comment implémenter des schémas complexes comme les modifications enregistrées.

#---
nom : docx
description : « Création, édition et analyse complètes de documents, avec prise en charge des modifications suivies, des commentaires, de la préservation de la mise en forme et de l'extraction de texte. Lorsque Claude doit travailler avec des documents professionnels (fichiers .docx) pour : (1) créer de nouveaux documents, (2) modifier ou éditer du contenu, (3) travailler avec des modifications suivies, (4) ajouter des commentaires ou toute autre tâche documentaire »
licence : Propriétaire. Le fichier LICENSE.txt contient les conditions complètes
---

# Création, édition et analyse de DOCX

## Présentation

Un utilisateur peut vous demander de créer, de modifier ou d'analyser le contenu d'un fichier .docx. Un fichier .docx est essentiellement une archive ZIP contenant des fichiers XML et d'autres ressources que vous pouvez lire ou modifier. Différents outils et flux de travail sont disponibles pour différentes tâches.

## Arbre de décision de flux de travail

### Lecture/analyse de contenu
Utilisez les sections « Extraction de texte » ou « Accès XML brut » ci-dessous

### Création d'un nouveau document
Utiliser le flux de travail « Création d'un nouveau document Word »

### Modification du document existant
- **Votre propre document + modifications simples**
Utiliser le flux de travail « Edition OOXML de base »

- **Le document d'une autre personne**
Utilisez **« Flux de travail de redessinage » ** (par défaut recommandé)

- **Documents juridiques, universitaires, commerciaux ou administratifs**
Utilisez **« Flux de travail de redessinage » ** (obligatoire)

## Lecture et analyse de contenu

### Extraction de texte
Si vous avez uniquement besoin de lire le contenu textuel d'un document, vous devez convertir le document en markdown à l'aide de pandoc. Pandoc offre une excellente prise en charge pour la préservation de la structure des documents et peut afficher les modifications suivies :

```bash
# Convertir le document en markdown avec les modifications suivies
pandoc --track-changes=all path-to-file.docx -o output.md
# Options : --track-changes=accept/reject/all

Exemple de Skill n°2 : Directives de marque

Qualités : fournit des informations précises et exploitables que Claude ne peut avoir en sa possession (codes hexadécimaux exacts, noms de polices, seuils de taille), accompagnées d'une description claire indiquant à Claude sa fonction et quand elle doit être déclenchée.

Qualités : limites claires de la capacité créative, protection du droit d'auteur intégrée, support technique pour les non-initiés, normes de qualité.

#nom : directives de marque
description : applique les couleurs et la typographie officielles de la marque Anthropic à tout type d'artéfact pouvant bénéficier de l'image d'Anthropic. Utilisez-le lorsque les couleurs ou les directives de style de marque, la mise en forme visuelle ou les normes de conception de l'entreprise s'appliquent.
licence : remplir les conditions dans le fichier LICENSE.txt
---

# Styling de marque Anthropic

## Présentation

Pour accéder aux ressources officielles d'identité de marque et de style d'Anthropic, utilisez cette Skill.

**Mots-clés** : marque, identité d'entreprise, identité visuelle, post-traitement, stylisation, couleurs de marque, typographie, marque Anthropic, mise en forme visuelle, conception visuelle

## Directives de marque

### Couleurs

**Couleurs principales : **

- Sombre : `#141413` - Texte principal et arrière-plans sombres
- Clair : `#faf9f5` - Clarifier les arrière-plans et le texte sombre
- Gris moyen : `#b0aea5` - Éléments secondaires
- Gris clair : `#e8e6dc` - Arrière-plans subtils

**Couleurs accentuées : **

- Orange : `#d97757` - accent principal
- Bleu : `#6a9bcc` - Accent secondaire
- Vert : `#788c5d` - Accent tertiaire

### Typographie

- **Headings** : Poppins (avec basculement Arial)
- **Texte corporel** : Lora (avec recours à la Géorgie)
- **Remarque** : les polices doivent être préinstallées dans votre environnement pour obtenir de meilleurs résultats

## Fonctionnalités

### Application de polices intelligentes

- Applique la police Poppins aux titres (24 pts et plus)
- Applique la police Lora au corps de texte
- Revient automatiquement à Arial/Georgia si les polices personnalisées ne sont pas disponibles
- Préserve la lisibilité sur tous les systèmes

### Style de texte

- Titres (24 pts ou plus) : police Poppins
- Corps du texte : police Lora
- Sélection intelligente des couleurs en fonction de l'arrière-plan
- Préserve la hiérarchie du texte et la mise en forme

### Forme et couleurs d'accent

- Les formes non textuelles utilisent des couleurs d'accent
- Alternez les accents orange, bleu et vert
- Maintient l'intérêt visuel tout en restant fidèle à la marque

Exemple de Skill n°3 : Skill de conception de frontend

Qualités : limites claires de la capacité créative, protection du droit d'auteur intégrée, support technique pour les non-musiciens, normes de qualité.

name : frontend-design
description : créez des interfaces frontend distinctives et de qualité professionnelle avec une conception de haute qualité. Utilisez cette Skill lorsque l'utilisateur demande à créer des composants Web, des pages ou des applications. Génère un code créatif et raffiné qui évite l’esthétique générique de l’IA.
licence : remplir les conditions dans le fichier LICENSE.txt
---

Cette Skill guide la création d'interfaces frontend distinctives et de qualité professionnelle qui évitent les esthétiques génériques des « slops IA ». Implémentez un véritable code de travail avec une attention exceptionnelle portée aux détails esthétiques et aux choix créatifs.

L'utilisateur fournit les exigences du frontend : un composant, une page, une application ou une interface à créer. Elles peuvent inclure le contexte de l'objectif, du public ou des contraintes techniques.

## Conception Thinking

Avant le codage, comprenez le contexte et adoptez une esthétique BOLD :
- **Objectif** : quel problème cette interface résout-elle ? Qui l'utilise ?
- **Tone** : choisissez un extrême : brutalement minimal, chaos maximaliste, rétro-futuriste, organique/naturel, luxueux/raffiné, ludique/jouet, éditorial/magazine, brutaliste/brut, art déco/géométrique, souple/pastel, industriel/utilitaire, etc. Il y a tellement de variantes parmi lesquelles choisir. Utilisez-les pour vous inspirer, mais concevez un design fidèle à l'esthétique.
- **Contraintes** : Exigences techniques (cadre, performances, accessibilité).
- **Différenciation** : qu'est-ce qui rend cet objectif INOUBLIABLE ? De quoi se souviendra quelqu'un ?

**CRITIQUE** : choisissez une orientation conceptuelle claire et exécutez-la avec précision. Le maximalisme audacieux et le minimalisme raffiné fonctionnent tous deux : l'intentionnalité est la clé, pas l'intensité.

Ensuite, implémentez un code de travail (HTML/CSS/JS, React, Vue, etc.) qui :
- Adapté à la production et fonctionnel
- Visuellement saisissant et mémorable
- Cohésif avec un point de vue esthétique clair
- Méticuleusement affiné dans les moindres détails

## Directives esthétiques des frontend

Concentrez-vous sur :
- **Typographie** : choisissez des polices belles, uniques et intéressantes. Évitez les polices génériques comme Arial et Inter ; optez plutôt pour des choix distinctifs qui améliorent l'esthétique de l'interface ; des choix de polices inattendus et de caractère. Associez une police d'affichage distinctive à une police de corps affinée.
- **Couleur et thème** : choisissez une esthétique cohérente. Utilisez des variables CSS pour garantir la cohérence. Les couleurs dominantes avec des accents marqués l'emportent sur les palettes timides et uniformément réparties.
- **Motion** : utilisez des animations pour les effets et les micro-interactions. Priorisez les solutions CSS uniquement pour HTML. Utilisez la bibliothèque de mouvements pour React lorsque disponible. Concentrez-vous sur les moments à fort impact : un chargement de page bien orchestré avec des révélations décalées (retard d'animation) est plus attrayant que des micro-interactions éparpillées. Utilisez le déclenchement du défilement et les états surprenants.
- **Composition spatiale** : mises en page inattendues. Asymétrie. Se chevauchent. Flux diagonal. Éléments révolutionnaires. Espace négatif généreux OU densité contrôlée.
- **Arrière-plans et détails visuels** : créez une atmosphère et une profondeur plutôt que d'utiliser des couleurs unies par défaut. Ajoutez des effets contextuels et des textures qui correspondent à l'esthétique générale. Appliquez des formes créatives comme des maillages de dégradés, des textures de bruit, des motifs géométriques, des transparences superposées, des ombres spectaculaires, des bordures décoratives, des curseurs personnalisés et des superpositions de grain.

N'utilisez JAMAIS les esthétiques génériques générées par l'IA, comme les familles de polices surutilisées (Inter, Roboto, Arial, polices système), les schémas de couleurs clichés (notamment les dégradés violets sur des fonds blancs), les mises en page et les modèles standardisés et les modèles standardisés qui ne sont pas spécifiques au contexte.

Interprétez de manière créative et faites des choix inattendus qui semblent véritablement conçus pour le contexte. Aucune conception ne doit être identique. Variez entre des thèmes clairs et sombres, des polices et des esthétiques différentes. Les choix ne convergent JAMAIS vers des choix communs (Space Grotesk, par exemple) entre les générations.

**IMPORTANT** : faire correspondre la complexité de la mise en œuvre à la vision esthétique. Les designs maximalistes nécessitent un code élaboré avec des animations et des effets importants. Les conceptions minimalistes ou raffinées nécessitent retenue, précision et une attention particulière à l'espacement, à la typographie et aux détails subtils. L'élégance passe par la bonne exécution de la vision.

N'oubliez pas : Claude est capable de créativité extraordinaire. Ne vous retenez pas, montrez ce qui peut vraiment être créé en sortant des sentiers battus et en s'engageant pleinement dans une vision distinctive.

Questions courantes

Comment rédiger des descriptions permettant l’activation de la Skill ?

Concentrez-vous sur les capacités et les scénarios, pas sur les mots-clés génériques. Incluez des verbes d’action, des types de fichiers spécifiques et des cas d'usage clairs. Au lieu de « Skill de traitement de documents », je peux écrire « extraire des tableaux de fichiers PDF et les convertir au format CSV pour les flux de travail d'analyse de données ».

Comment Claude décide-t-il des Skills invoqués ?

Claude évalue votre demande en fonction des descriptions de skills par compréhension sémantique. Pas de correspondance de mots-clés : Claude détermine la pertinence contextuelle. Plusieurs Skills peuvent être activées selon différents aspects de votre demande.

Quelle est la granularité de mes descriptions ?

Vos Skills doivent être tournées vers un seul objectif. « Optimisation du référencement des articles de blog » est suffisamment ciblé pour des instructions spécifiques, mais trop général pour être réutilisable. Trop générale : « Assistant marketing pour création de contenu » Trop limitée : « Ajouter des méta-descriptions ».

Comment partager des Skills au sein de mon organisation ?

Quelle que soit la taille de votre équipe, nous vous suggérons de créer un référentiel de documents partagé, associé à des spécifications techniques. 

Pour les petites équipes, utilisez un modèle avec nom, description, instructions et version.

Pour les moyennes et grandes équipes, établissez un processus de gouvernance des Skills :

• Désignez des propriétaires de skills pour chaque domaine (finance, juridique, marketing)
• Gérez un wiki central ou un lecteur partagé comme bibliothèque de skills
• Exemples d’utilisation et solutions de dépannage courantes pour chaque skill
• Consignez les versions de vos Skills et vos modifications dans un journal des modifications
• Planifiez des examens trimestriels pour mettre à jour ou supprimer les informations obsolètes

Bonnes pratiques pour les équipes, de toute taille :

• Documents justifiant l’objectif de chaque skill
• Attribution d’un responsable unique de la maintenance et des mises à jour
• Créer des supports d’intégration expliquant aux nouveaux membres de l’équipe comment implémenter des compétences partagées
• Suivre les Skills qui offrent le plus de valeur pour hiérarchiser les efforts de maintenance
• Utiliser des conventions de dénomination cohérentes pour faciliter la recherche de Skills

Les clients professionnels peuvent travailler avec l'équipe Relation client d'Anthropic pour explorer d’autres options de déploiement et cadres de gouvernance.

Comment déboguer des Skills ?

Déclenchez les tests et l’exécution séparément. Si les Skills ne sont pas activées, élargissez votre description et ajoutez des cas d'usage. Si les résultats sont contradictoires, rendez vos instructions plus spécifiques et ajoutez des étapes de validation. Créez une bibliothèque de cas de test couvrant les utilisations normales, les cas extrêmes et les requêtes hors portée.

Comment partager des Skills au sein de mon organisation ?

‍Dans Claude.ai, les Skills sont actuellement individuelles pour chaque utilisateur, mais des fonctionnalités de gestion et de partage à l'échelle de l’organisation seront bientôt disponibles. En attendant, quelle que soit la taille de votre équipe, nous vous suggérons de créer un référentiel de documents partagé, associé à des spécifications de skills. Cela prépare votre organisation aux fonctionnalités à venir tout en mettant en place dès aujourd’hui de bonnes pratiques de gouvernance.

Démarrer

Prêt à utiliser des Skills ? Voici comment commencer :

Utilisateurs de Claude.ai :

• Activez les Skills dans Paramètres → Fonctionnalités
• Créez votre premier projet sur claude.ai/projects
• Essayez de combiner les connaissances de projet et des Skills dans votre prochaine tâche d'analyse

Développeurs d'API :

• Explorez la rubrique Skills dans la documentation
• Consultez notre guide de conception de Skills

Utilisateurs de Claude Code :

• Installez des Skills via les marketplaces de plug-in
• Consultez notre guide de conception de Skills