Créer un skill Claude Code sans être développeur : mode d'emploi

Un skill Claude Code est un ensemble d'instructions écrites en langage naturel, rangé dans un dossier dédié, que l'agent invoque pour appliquer une procédure précise et répétable. Pas de code à écrire : on décrit une méthode une fois, l'agent la réutilise ensuite chaque fois que le contexte y correspond. Si les mots « artefact », « skill » ou « hook » vous sont encore flous, le glossaire complet de Claude Code les définit un par un avant d'aller plus loin.

Qu'est-ce qu'un skill, concrètement ?

Un skill ressemble à une fiche de procédure interne, mais lisible par l'agent. Techniquement, c'est un ou plusieurs fichiers texte au format markdown, précédés d'un court en-tête qui décrit le nom du skill et son rôle. Le corps du fichier contient les consignes détaillées : la méthode à suivre, les points à vérifier, le format de sortie attendu.

Ce qui distingue un skill d'un simple message est sa portée : il n'est pas écrit pour une seule conversation, il est relu automatiquement, session après session, dès que la tâche correspondante se présente. L'agent le consulte, applique la procédure, et produit un résultat cohérent avec la première fois.

Pourquoi écrire un skill plutôt que retaper les mêmes consignes ?

Toute personne qui utilise un agent IA régulièrement finit par retaper les mêmes phrases : « vérifie le ton avant de publier », « structure ce compte-rendu en trois parties », « croise ces deux fichiers de cette façon précise ». Ces consignes répétées sont un signal : la tâche est stable, seule son exécution change à chaque fois.

Formaliser cette consigne en skill évite trois pertes courantes : l'oubli d'une étape en rédigeant trop vite, la dérive du résultat quand le prompt se simplifie au fil des sessions, et le temps perdu à retaper une explication déjà rodée. Le skill capitalise le savoir-faire une fois, pour de bon.

Comment repérer une tâche qui mérite de devenir un skill ?

Trois signes indiquent un bon candidat. La tâche revient au moins une fois par semaine sous une forme quasi identique. Elle suit une méthode qu'on pourrait expliquer à un stagiaire en quelques minutes, sans zone grise. Et le résultat attendu a une forme reconnaissable (un gabarit, une checklist, un rapport).

Un audit avant publication, un modèle de compte-rendu de réunion, une méthode d'analyse d'un devis avant validation : ce sont des candidats naturels. À l'inverse, une décision qui demande un jugement au cas par cas ne se prête pas bien à un skill.

Comment écrire un skill étape par étape ?

La démarche tient en quatre mouvements simples, sans connaissance technique préalable.

1. Nommer la tâche avec un intitulé clair (« vérification avant envoi », « gabarit de brief créatif »).
2. Décrire en une phrase à quel moment l'agent doit s'en servir : cette description est ce qui permet à l'agent de reconnaître la bonne occasion, il faut donc la rendre précise plutôt que vague.
3. Écrire la procédure pas à pas, comme on la formulerait à un collègue : les étapes dans l'ordre, les critères de validation, les erreurs à éviter.
4. Tester en demandant à l'agent d'exécuter la tâche concernée, puis ajuster le texte si le résultat s'écarte de ce qui était attendu.

À titre d'exemple pédagogique simplifié (la syntaxe exacte des fichiers dépend de la version en cours, à vérifier dans la documentation officielle au moment de la mise en place), un skill peut ressembler à ceci dans sa logique :

nom : checklist-avant-publication
description : à utiliser avant de publier un article de blog
---
1. Vérifier que le titre répond à une question.
2. Vérifier qu'aucune affirmation chiffrée n'est sans source.
3. Relire une fois à voix haute pour repérer les tournures artificielles.

Ce squelette illustre le principe (un en-tête qui identifie et décrit, un corps qui détaille la méthode) sans prétendre reproduire une syntaxe garantie.

Comment ça se fait concrètement selon l'outil ?

La bonne nouvelle : ce n'est pas un principe propre à Claude Code. Le format de skill (un dossier avec un fichier d'instructions et des métadonnées) est un standard ouvert publié par Anthropic, et adopté tel quel par plusieurs environnements agentiques majeurs. Un skill écrit une fois se réutilise sans adaptation d'un outil à l'autre.

Sur Claude (Claude Code / Claude Cowork)

Claude Code propose une fonctionnalité de skills packagés dans des dossiers dédiés, documentée officiellement par Anthropic. Claude Cowork, l'environnement de travail collaboratif d'Anthropic, s'appuie sur la même logique de procédures réutilisables partagées entre plusieurs membres d'une équipe.

Sur ChatGPT / Codex

Codex, l'agent de programmation d'OpenAI, adopte le même format ouvert SKILL.md que Claude Code : un dossier d'instructions invocable individuellement selon la tâche, portable d'un outil à l'autre. ChatGPT, de son côté, propose plutôt des instructions personnalisées et des configurations de projet qui préconfigurent le comportement de l'agent, une logique de contexte unique par projet, plus proche du prompt persistant que du skill packagé.

Sur Antigravity

Antigravity, l'environnement de développement agentique de Google, adopte lui aussi le format ouvert SKILL.md, stocké dans un dossier dédié au niveau du projet ou globalement sur la machine. Un skill écrit pour Claude Code s'y invoque de la même façon.

Quelles erreurs éviter en créant son premier skill ?

La description trop vague est l'erreur la plus fréquente : si elle ne précise pas quand utiliser le skill, l'agent ne l'invoquera pas au bon moment, ou l'invoquera à tort. Une deuxième erreur est de mélanger plusieurs procédures dans un seul skill : mieux vaut un skill par tâche, court et net.

Enfin, un skill n'est jamais figé : il vaut mieux le corriger dès qu'un résultat déçoit plutôt que de compenser à la main à chaque fois. C'est un investissement ponctuel qui continue de payer tant que la procédure reste d'actualité. Pour monter en compétence sur ces méthodes de façon structurée, la formation IA financée par l'OPCO couvre ce type de bonnes pratiques agentiques en entreprise.