Utiliser une skill au quotidien
Formuler sa demande, laisser l'agent choisir la skill ou l'appeler par son nom, en combiner plusieurs et l'adapter à son projet.
Mis à jour le
Une skill installée n'a rien à configurer : vous décrivez votre tâche, et l'agent lit la skill si elle correspond. Ce guide montre comment formuler la demande, quand citer la skill par son nom, comment en enchaîner plusieurs et comment l'ajuster à votre projet.
Ce que l'agent voit d'une skill
Au démarrage, l'agent ne charge que le nom et la description de chaque skill. Le contenu complet du fichier SKILL.md n'est lu que lorsque la tâche correspond à la description. C'est le principe des Agent Skills : beaucoup de skills peuvent rester installées sans alourdir la conversation.
Conséquence pratique : la description est le seul élément qui décide du déclenchement. Lisez-la sur la fiche de la skill avant de formuler votre demande, et reprenez ses mots.
Laisser l'agent choisir
La méthode la plus simple est de décrire le résultat attendu dans les termes de la description.
- Peu efficace : « Regarde mon site. »
- Efficace : « Audite la page d'accueil de mon site : structure, titres, appel à l'action. »
Si la skill ne se déclenche pas, reformulez avec des mots plus proches de sa description. La documentation de Claude Code donne la même piste : vérifier que la description contient les mots que vous diriez naturellement, puis reformuler. Le détail des causes est dans l'article Pourquoi une skill ne se déclenche pas.
L'appeler par son nom
Quand vous voulez être certain qu'une skill est utilisée, nommez-la.
| Agent | Appel explicite |
|---|---|
| Claude Code | Tapez la barre oblique suivie du nom au début du message, par exemple /landing-page-audit. Ce qui suit le nom est transmis à la skill. |
| Codex | Dans la CLI ou l'extension d'éditeur, tapez le signe dollar pour mentionner une skill, ou lancez /skills pour la choisir dans la liste. |
Dans Claude Code, le nom compte seulement s'il ouvre le message. Écrit au milieu d'une phrase (« lance /deploy sur staging »), il autorise Claude à utiliser la skill mais ne la lance pas directement. Pour parler d'une skill sans l'autoriser, écrivez son nom sans la barre oblique.
Les autres agents ont leur propre syntaxe : consultez leur page dans le catalogue, par exemple celle de Claude Code ou de Codex.
Combiner plusieurs skills
Deux façons de faire, selon l'agent.
Dans une seule demande en langage naturel. Découpez la tâche : « Rédige la page de tarifs avec la skill de rédaction, puis fais-la relire avec la skill d'audit de conversion. » L'agent charge chaque skill au moment où l'étape la concerne.
En les empilant, dans Claude Code. Dans le terminal, plusieurs noms au début d'un message chargent plusieurs skills. Le texte qui suit est transmis comme argument à chacune :
/write-tests /fix-issue 123
Claude Code développe la première skill et jusqu'à cinq autres. L'empilement s'arrête à la première skill qui s'exécute dans un sous-agent. Avec claude -p ou le SDK, seule la première skill est chargée.
Ne combinez que des skills aux rôles distincts. Deux skills qui donnent des consignes contradictoires sur le même sujet (deux guides de style, par exemple) produisent un résultat imprévisible : choisissez-en une.
Exemples de demandes
| Besoin | Demande |
|---|---|
| Audit | « Audite l'accessibilité de la page de connexion et liste les corrections par ordre de priorité. » |
| Génération | « Crée un composant de tableau de bord à partir du DESIGN.md du projet. » |
| Revue | « Relis mes modifications en cours et signale les risques avant le commit. » |
| Enchaînement | « Écris les tests de ce module, puis corrige ce qui échoue. » |
Une bonne demande donne l'objet (quelle page, quel module), le critère (ce qui compte pour vous) et le format de sortie voulu (liste, correctif, résumé).
Adapter une skill à son projet
Une skill est un dossier de fichiers que vous possédez après l'installation. Pour l'ajuster :
- Installez-la au niveau du projet, par exemple dans
.claude/skills/pour Claude Code. Committez le dossier : toute l'équipe l'obtient. Les dossiers de chaque agent sont indiqués dans le catalogue des skills et sur la page de l'agent. - Modifiez
SKILL.md: ajoutez vos conventions (noms de dossiers, commandes de test, ton rédactionnel) ou retirez les étapes qui ne vous concernent pas. Claude Code détecte les changements pendant la session, sans redémarrage. - Restez bref. Une fois chargée, la skill reste dans le contexte de la conversation : chaque ligne a un coût à chaque tour. La documentation de Claude Code recommande de garder
SKILL.mdsous 500 lignes et de déplacer le détail dans des fichiers séparés. - Gardez la licence et la notice d'origine, et notez vos changements.
Deux réglages utiles dans Claude Code : disable-model-invocation: true dans le frontmatter empêche l'agent de lancer la skill de lui-même (utile pour un déploiement), et le texte tapé après le nom peut être repris dans la skill avec le marqueur $ARGUMENTS. Codex propose l'équivalent du premier avec allow_implicit_invocation: false. L'appel explicite par $ continue de fonctionner.
Pour une même skill présente à plusieurs endroits, Claude Code applique une priorité : une skill personnelle l'emporte sur celle du projet. Supprimez la copie dont vous ne voulez plus.
Pour aller plus loin
Si c'est votre première installation, commencez par Installer votre première ressource. Pour décider entre une skill et un simple prompt, lisez Ressource ou prompt seul.
Sources
Questions fréquentes
Dois-je citer le nom de la skill dans ma demande ?
Non. Une skill installée se déclenche quand votre demande correspond à sa description. Citer son nom est utile quand vous voulez être sûr qu'elle est utilisée.
Puis-je utiliser plusieurs skills dans la même demande ?
Oui. Décrivez la tâche en étapes, ou citez les skills. Claude Code accepte aussi plusieurs noms de skills au début d'un message tapé dans le terminal.
Puis-je modifier une skill installée ?
Oui, c'est un dossier de fichiers dans votre projet ou votre dossier personnel. Modifiez la copie, gardez la licence et la notice d'origine, et notez ce que vous avez changé.