# Créer sa première compétence Claude

> Créer vos compétences (skills) Claude : différence avec un prompt, trois façons d’en ajouter une, fichier SKILL.md, déclencheurs négatifs puis débogage.

Adresse : https://www.pilote-expertise.fr/guides/creer-sa-premiere-competence-claude/
Auteur : Rémi Doyen, pour l'équipe Pilote Expertise. Mise à jour : 2026-11-12.

Une compétence, c'est un mode d'emploi que Claude garde sous la main et applique quand la situation s'y prête. Vous ne réexpliquez plus votre méthode : vous la déclenchez. Ce guide montre les trois façons d'en créer une, la structure qui fonctionne et la méthode de débogage quand elle refuse de se déclencher.

Il y a un moment, au bout de quelques semaines d'usage, où l'on se surprend à réécrire le même long prompt pour la troisième fois. La trame du compte rendu de visite. La structure de la proposition commerciale. La façon de préparer un entretien annuel. On l'a déjà formulée, elle marchait bien et elle a disparu dans une conversation qu'on ne retrouve plus.

Les **compétences**, *skills* dans la version anglaise, existent exactement pour ça. Une compétence, c'est un mode d'emploi que Claude garde sous la main et applique quand la situation s'y prête. Vous ne réexpliquez plus votre méthode : vous la déclenchez.

Ce guide montre comment en créer une qui fonctionne vraiment, ce qui distingue une compétence utile d'une compétence qui ne se déclenche jamais et comment diagnostiquer le cas, très fréquent, où elle reste muette alors qu'elle devrait s'activer.

## Ce que vous saurez faire

- Comprendre ce qu'une compétence apporte de plus qu'un prompt enregistré
- Repérer les tâches de votre quotidien qui méritent une compétence
- Créer une compétence par les trois voies disponibles
- Écrire une description qui déclenche au bon moment et seulement là
- Diagnostiquer une compétence qui ne se déclenche pas
- Piocher dans la bibliothèque de plugins plutôt que tout construire

- Un abonnement Claude payant
- Avoir déjà utilisé Claude quelques semaines
- Une tâche que vous répétez au moins deux fois par mois
- Aucune compétence technique : on ne code pas

## Ce qu'une compétence ajoute à un prompt rangé dans un fichier

La différence tient en un mot : le **déclenchement**. Un prompt rangé dans un fichier texte, il faut penser à aller le chercher, le copier, le coller. Une compétence, Claude sait quand elle s'applique. Vous écrivez « prépare-moi le compte rendu de la visite chez Dubois » et il reconnaît que votre méthode de compte rendu s'applique, sans que vous ayez rien invoqué.

Vous pouvez aussi la déclencher à la main, en tapant `/` dans la zone de saisie.

![Le menu des compétences qui apparaît en tapant une barre oblique](https://www.pilote-expertise.fr/images/guides/creer-sa-premiere-competence-claude/01-menu-competences.webp)
*Un « / » ouvre la liste. Continuer à taper filtre.*

- Les entrées du haut sont des actions intégrées à l'interface.
- Les suivantes sont les compétences installées ou créées.
- `skill-creator`, fournie par Anthropic, sert à en fabriquer d'autres.

Un projet dit à Claude **pour qui** il travaille. Une compétence lui dit **comment on s'y prend**. Le premier porte le contexte, la seconde porte le savoir-faire. Ils se cumulent : votre compétence « proposition commerciale » appliquera votre méthode et le projet lui donnera vos tarifs et votre ton.

## Quelles tâches méritent une compétence

Le critère n'est pas la complexité, c'est la **répétition avec exigence de forme**. Une tâche que vous faites souvent et dont le résultat doit toujours ressembler à la même chose est un candidat parfait. Une tâche que vous faites une fois, même compliquée, n'en est pas un.

| Bon candidat | Mauvais candidat |
| --- | --- |
| Le compte rendu de visite client, toujours structuré pareil | Une analyse ponctuelle sur un sujet nouveau |
| La trame de proposition commerciale | Une question dont vous ignorez la réponse |
| La préparation d'un entretien annuel | Un brainstorming où vous voulez justement de la variété |
| Le point hebdomadaire à la direction | Une tâche que vous n'avez jamais formalisée vous-même |
| La relecture d'un document selon vos critères qualité | Ce qui change complètement à chaque fois |

Si vous n'arrivez pas à expliquer votre méthode à un stagiaire en cinq minutes, la compétence ne marchera pas non plus. Une compétence n'invente pas votre savoir-faire : elle l'enregistre. Commencez par une tâche que vous savez décrire.

## Trois façons d'en créer une

Tout se passe dans **Réglages → Personnaliser → Compétences**. C'est là que vous voyez celles qui sont installées et que vous en ajoutez.

![L'écran des compétences dans les réglages de Claude](https://www.pilote-expertise.fr/images/guides/creer-sa-premiere-competence-claude/02-liste-competences.webp)
*Réglages → Personnaliser → Compétences.*

- La colonne « Auteur » distingue ce qui vient d'Anthropic de ce que vous avez créé.
- « Parcourir » ouvre la bibliothèque publique.
- « Ajouter » propose les trois voies de création.

![Le menu Ajouter avec les options Créer avec Claude, Rédiger les instructions, Téléverser](https://www.pilote-expertise.fr/images/guides/creer-sa-premiere-competence-claude/03-ajouter-competence.webp)
*Les trois voies, de la plus assistée à la plus manuelle.*

- « Créer avec Claude » : il vous interroge et rédige la compétence. Le meilleur choix pour la première.
- « Rédiger les instructions de la compétence » : vous écrivez vous-même. Rapide quand la méthode est déjà claire.
- « Téléverser une compétence » : vous importez un dossier existant, par exemple partagé par un collègue.

Pour une première compétence, prenez « Créer avec Claude », ou lancez `/skill-creator` depuis une conversation. Dans les deux cas, il vous pose des questions plutôt que d'écrire tout de suite : c'est précisément là que se joue la qualité du résultat.

« Je rédige des rapports » ne produira rien d'utile. « Je rédige un point hebdomadaire qui commence par les trois chiffres du mois, ne dépasse jamais une page, ne contient aucun adjectif d'appréciation et se termine par les décisions attendues de la direction » produit une compétence qui vous ressemble.

## Ce qu'il y a dedans

*Cinq blocs, dont un que presque tout le monde néglige.*

Une compétence est un dossier contenant un fichier principal, `SKILL.md`, écrit en texte simple. Vous n'avez pas à l'écrire à la main, mais savoir ce qu'il contient permet de le corriger quand le comportement ne convient pas.

\n  À utiliser pour rédiger un compte rendu de visite client ou de rendez-vous\n  commercial, à partir de notes brutes ou d'un enregistrement.\n  NE PAS utiliser pour : un compte rendu de réunion interne, un devis,\n  une relance commerciale, ou une note de synthèse stratégique.\n---\n\n# Compte rendu de visite\n\n## Structure imposée\n1. En-tête : client, date, participants, lieu\n2. Contexte en trois lignes maximum\n3. Ce qui a été dit : factuel, sans interprétation\n4. Signaux détectés : interprétation, clairement séparée du point 3\n5. Décisions et engagements pris, avec un porteur et une date\n6. Prochaine échéance\n\n## Règles d'écriture\n- Une page maximum. Si ça déborde, couper dans le point 3.\n- Aucun adjectif d'appréciation sur le client.\n- Les montants toujours en euros hors taxes, précisés comme tels.\n- Ce qui n'est pas certain est écrit comme incertain.\n\n## Avant de rendre\nVérifier que chaque engagement du point 5 a bien un nom et une date.\nSi une information manque, la demander plutôt que de l'inventer."} note="Un SKILL.md réel, volontairement court. La partie qui fait le plus de bien est le « NE PAS utiliser pour »." />

Les **déclencheurs négatifs**, le « ne pas utiliser pour », comptent davantage que les déclencheurs positifs. Une description trop large et la compétence s'invite dans des conversations qui n'ont rien à voir, imposant sa structure à un simple email. Consacrez autant de soin à dire quand elle ne s'applique pas qu'à dire quand elle s'applique.

## Quand elle ne se déclenche pas

*Le symptôme le plus courant et sa solution en une question.*

Une compétence ne prévient pas quand elle ne s'active pas. Il n'y a pas de message d'erreur : Claude répond simplement de façon ordinaire et vous vous demandez à quoi elle sert. Neuf fois sur dix, la cause est la même : la description ne correspond pas à votre manière de formuler les choses.

| Symptôme | Cause probable | Correction |
| --- | --- | --- |
| Elle ne se déclenche jamais | Description trop abstraite ou trop courte | Y mettre les mots que vous employez réellement dans vos demandes |
| Elle s'invite partout | Description trop large, pas de garde-fou | Ajouter un « ne pas utiliser pour » explicite et détaillé |
| Elle se déclenche mais bâcle | Rien à voir avec la compétence | Ajouter dans votre message : « prends ton temps, ne saute aucune étape » |
| Elle contredit votre ton habituel | Conflit avec votre contexte permanent | La compétence porte la méthode, pas le ton : retirer les consignes de style |

Si Claude escamote des étapes, le réflexe est de durcir le `SKILL.md`. Ça ne marche pas bien. Ce qui marche, c'est de le dire dans le message du moment : « prends ton temps, la qualité prime sur la vitesse, ne saute aucune étape ». La consigne ponctuelle pèse plus lourd que la consigne permanente.

## Ne pas tout construire soi-même

Avant de fabriquer, regardez ce qui existe. Anthropic et ses partenaires publient des collections de compétences par métier, appelées plugins, dans **Réglages → Personnaliser → Plugins → Parcourir**.

![Le répertoire des plugins Claude avec les collections par métier](https://www.pilote-expertise.fr/images/guides/creer-sa-premiere-competence-claude/04-repertoire-plugins.webp)
*Les collections officielles, avec leur nombre de téléchargements.*

- Productivity, Marketing, Data et Finance couvrent l'essentiel des besoins en PME.
- L'onglet « Partenaires » regroupe les collections d'éditeurs tiers.
- Installez-en une seule à la fois et testez avant d'en ajouter une autre.

Une collection installée vous donne aussi de très bons exemples : ouvrez les compétences fournies pour voir comment elles sont écrites. C'est la meilleure façon d'apprendre à formuler les vôtres.

## Ce qu'il ne faut pas en attendre

Une compétence bien écrite vous donne un point de départ solide, pas un livrable fini. Comptez sur un résultat correct à 80 %, qu'il faut relire et ajuster. Le gain n'est pas de supprimer votre travail : il est de supprimer la page blanche et l'irrégularité de forme.

Deux autres limites, honnêtement. Une compétence ne vous rendra pas meilleur sur une méthode que vous maîtrisez mal : elle fige ce que vous lui donnez, y compris vos approximations. Et elle ne remplace pas le jugement : elle applique la trame, elle ne sait pas que ce client-là mérite un traitement différent.

- Choisissez la tâche que vous avez le plus répétée le mois dernier.
- Lancez « Créer avec Claude » ou « / skill-creator » avec le message d'amorçage plus haut.
- Répondez avec des détails concrets, pas des intentions.
- Exigez un « ne pas utiliser pour » explicite avant de valider.
- Installez-la, puis testez-la avec trois formulations différentes de la même demande.
- Testez ensuite une demande sans rapport, pour vérifier qu'elle reste silencieuse.
- Corrigez la description, pas les instructions, si le déclenchement est mauvais.

Transformer les savoir-faire d'une équipe en compétences partagées, c'est le moment où l'IA arrête d'être un gadget individuel. Nous accompagnons ce passage : identification des processus, rédaction, déploiement et formation. [Parler de votre organisation](/formation-ia/)
