« J’ai peur de ne pas pouvoir utiliser l’IA parce que je n’ai aucune connaissance en programmation… »
« Je redoute de voir l’écran noir du terminal, ça ne me dit rien. »
« Mais je suis anxieux à l’idée de me faire distancer par la tendance de l’IA 😱 »
Même dans cet état, en laissant Claude Code apprendre mes « propres schémas d’action », une tâche qui prenait 30 minutes à chaque fois n’en prend plus que 5.
En réalité, l’opportunité se présente justement pour les non-ingénieurs.
La clé, ce sont les Skills.
En termes Pokémon, c’est une « Capsule Technique » (CT).
En utilisant Claude Code, ne vous êtes-vous jamais dit :
- Il est certes intelligent. Mais à chaque fois, je dois définir le format, les critères de jugement et le contexte moi-même.
- Même avec l’IA, il y a beaucoup de travail manuel. « N’est-ce pas la même chose que de tout faire moi-même ? »
- Les autres l’utilisent-ils plus efficacement ?
- Je l’utilise, mais sans le maîtriser. Je ne vois pas la différence.
À la fin de cet article, vous serez capable de créer un environnement où il vous suffit de définir votre flux de travail une fois dans l’IA, et où une production de même qualité sort à chaque fois.
Santiago (@santtiagom_), ingénieur chez MercadoLibre, la plus grande entreprise de e-commerce d’Amérique du Sud, a publié un guide complet sur les Skills en espagnol qui devient viral avec plus de 580 000 vues.
Il dit avoir créé plus de 50 Skills lui-même et en avoir supprimé la plupart en deux jours. Ce guide est basé sur son expérience réelle de ce qui est resté et a complètement changé sa façon de travailler avec Claude.
J’ai deux requêtes avant de commencer.
- Sauvegardez cet article et réservez 20 minutes cette semaine.
- Si vous connaissez quelqu’un qui utilise Claude Code, partagez-le avec lui.
Cette fois, je vais expliquer le contenu de manière simple.
Voici le post original.
https://x.com/santtiagom_/status/2030305647535751338
Pourquoi Claude a besoin d’une configuration à chaque fois
D’abord, laissez-moi parler de la prémisse principale.
Claude Code est très intelligent. Cependant, il ne connaît pas « votre façon de travailler ».
Ce n’est pas un problème de performance, mais une question de fonctionnement.
Claude repart d’une page blanche à chaque nouvelle session. À moins que vous ne le lui disiez à chaque fois, Claude ne sait pas quel format vous préférez, quel type de rapport votre patron veut, ou quel ton vous utilisez dans les e-mails aux clients. Ce sont « vos critères de jugement uniques ».
Ce mécanisme entraîne trois problèmes.
Problème 1 : Manque de cohérence
Même avec la même demande de « créer un rapport hebdomadaire », aujourd’hui il pourrait faire une version détaillée de 2 000 caractères, et demain trois points clés. Comme votre format souhaité n’est pas défini, Claude doit décider tout seul à chaque fois.
Problème 2 : Vos critères de jugement uniques sont absents
Claude est excellent en général. Mais il ne connaît pas les règles qui ne s’appliquent que dans votre environnement, comme « dans votre entreprise, il faut commencer par la conclusion » ou « votre patron ne lit pas les documents de plus de 3 pages ».
Donc, à chaque fois, vous devez configurer ce contexte à partir de zéro.
Problème 3 : L’effort de configuration s’accumule
Saisir les spécifications de format, expliquer les critères de jugement et partager le contexte.
Combien de temps passez-vous sur cette « configuration » en une journée ? Même en utilisant l’IA, vous vous fatiguez rien qu’avec la préparation.
santtiagom_ écrit :
« Et si vous pouviez écrire une instruction une fois et que tout soit parfait ensuite sans donner d’autres instructions ? C’est ce que sont les Skills. »
Un Skill est un mécanisme où vous écrivez votre flux de travail dans un seul fichier et le définissez dans Claude. Une fois défini, Claude agira en conséquence la prochaine fois sans que vous ayez rien à dire.
À partir de là, je vais expliquer la vue d’ensemble des Skills dans l’ordre.
Les Skills sont les « Capsules Techniques » de Claude
Avez-vous déjà utilisé une « Capsule Technique » (CT) dans Pokémon ?
Il suffit de charger un disque pour que ce Pokémon apprenne une nouvelle capacité. Une fois apprise, la capacité peut être utilisée autant de fois que vous le voulez dans chaque combat. Pour toujours, à moins que vous ne la fassiez oublier.
Les Skills sont exactement comme ces « Capsules Techniques ».
Vous créez un fichier appelé SKILL.md et vous le définissez dans Claude.
Ensuite, Claude agira selon ces instructions à chaque ouverture de session. Vous n’avez plus besoin de tout configurer à chaque fois.
Pour organiser simplement la correspondance :
- Une CT → Un fichier SKILL.md
- Un Pokémon qui a appris une capacité l’utilise dans chaque combat → Claude avec un Skill défini l’applique dans chaque session
- Remplaçable (peut réapprendre) → Les Skills peuvent aussi être ajoutés/supprimés/remplacés librement
- La compatibilité existe (certaines capacités ne peuvent pas être apprises) → Certains Skills ne correspondent pas au projet
L’important est que votre travail comporte aussi des « tâches qui peuvent être transformées en CT ».
Par exemple, pour faire un rapport :
« Écris la conclusion en premier. N’utilise pas plus de 3 données. Utilise un format que le patron peut juger en 5 secondes. »
Si vous définissez cela comme un Skill, Claude suivra automatiquement cette règle la prochaine fois.
Pour faire un rapport hebdomadaire :
« Trois parties : Résultats de la semaine dernière → Plans de cette semaine → Problèmes.
Écris les chiffres en comparaison d’une semaine sur l’autre. » Vous pouvez aussi définir cela comme un Skill.
Pour écrire un e-mail à un client :
« Exprime ta gratitude au début. Garde l’essentiel en 3 lignes. Indique clairement une seule action suivante. » Cela aussi.
Comparons un monde avec des Skills et un monde sans.
[Sans Skills]
Vous demandez de « créer un rapport hebdomadaire » → Claude produit dans son propre format → Vous corrigez : « Non, la conclusion d’abord », « Limite les données à 3 points » → La semaine suivante, vous recommencez à tout taper à zéro.
[Avec Skills]
Vous demandez de « créer un rapport hebdomadaire » → Claude produit selon les Skills → Dès le début, c’est dans le format « Conclusion → 3 Données → Problèmes » → Les corrections sont quasi nulles.
santtiagom_ insiste à plusieurs reprises sur cette façon de penser dans son article :
« Un Skill fonctionnel de 5 lignes a plus de valeur qu’un Skill parfait avec 80 règles. »
Vous n’avez pas besoin de créer des instructions parfaites. Même deux lignes comme « Écris à partir de la conclusion. Jusqu’à 3 données » seront efficaces si elles sont définies comme un Skill.
Et c’est la partie que je veux personnellement le plus transmettre.
L’essence des Skills n’est pas « l’automatisation du travail ».
C’est « l’acte de verbaliser vos critères de jugement et de les définir dans l’IA ».
« Écris à partir de la conclusion », « Limite les données à 3 points ». Ce ne sont pas des procédures de travail, mais vos critères de jugement. Quelles informations prioriser, dans quel ordre les transmettre, et avec quel niveau de détail les écrire.
Vous laissez ces jugements dans un fichier. Tout comme une capacité apprise d’une CT devient la force d’un Pokémon, les critères de jugement verbalisés deviennent la force de Claude.
L’actifisation du jugement. Si je devais décrire les Skills en un mot, c’est cela.
Tout ce dont vous avez besoin est un seul fichier : SKILL.md
Le mécanisme des Skills est bien plus simple que vous ne le pensez.
Tout ce dont vous avez besoin est un fichier appelé SKILL.md.
Le contenu de ce fichier est divisé en deux parties.
Partie 1 : La « couverture » avec le nom et la description
En haut du fichier, vous écrivez le nom du Skill et une description de « quand il doit être utilisé ».
Claude regarde cette « couverture » et juge « s’il doit utiliser ce Skill pour la tâche en cours ». Si c’est ambigu, Claude ne trouvera pas le Skill que vous avez travaillé dur à créer.
Par exemple, avec seulement le nom « Création de rapport », Claude se demandera « Quel rapport ? Quand l’utiliser ? »
Si vous écrivez « Créer un rapport de ventes hebdomadaire pour le manager Tanaka. Structure : Conclusion → Chiffres → Problèmes », Claude sélectionnera automatiquement ce Skill dès qu’une demande de rapport hebdomadaire arrivera.
En termes de CT, cette couverture correspond au jugement de « quel Pokémon peut apprendre cette capacité ».
Partie 2 : Le « corps » avec les instructions spécifiques
C’est votre façon de travailler réelle.
Vous écrivez des procédures et des règles spécifiques comme « Écris dans cet ordre », « Suis ce format », et « Assure-toi de vérifier uniquement ce point ».
Les Skills fonctionnent avec seulement ces deux parties.
C’est plus rapide de regarder un fichier réel, alors voici un exemple. Il suppose une situation où une équipe de vente soumet un rapport hebdomadaire à son patron chaque semaine.
1---2name: Rapport de ventes hebdomadaire3description: À utiliser lors de la création du rapport hebdomadaire pour l’équipe de vente chaque lundi. Pour le manager Tanaka.4---56# Rapport de ventes hebdomadaire78## Format9- Écris la conclusion (prévision d’atterrissage pour cette semaine) sur la première page10- Inclus toujours les chiffres en comparaison d’une semaine sur l’autre (ex. : +12% vs la semaine dernière)11- Classe les affaires en trois niveaux : A/B/C12- Limite les problèmes à un, et ajoute une action spécifique d’une ligne pour la semaine prochaine1314## Règles du manager Tanaka15- Il ne lit pas plus de 3 pages. Reste dans les 2 pages16- Il préfère les tableaux aux graphiques17- N’écris pas « en cours d’examen ». Convertis toujours en « ce qui sera fait et quand »
Voilà la vue d’ensemble de SKILL.md.
En regardant la description sur la « couverture » disant « chaque lundi… pour le manager Tanaka », Claude juge automatiquement : « Oh, c’est à propos du rapport hebdomadaire. »
Ensuite, en suivant les instructions dans le « corps », il crée un rapport de 2 pages ou moins commençant par la conclusion dans le même format à chaque fois.
Des règles comme « Règles du manager Tanaka », qui ne s’appliquent que dans votre lieu de travail, sont la vraie valeur des Skills. Aussi intelligent que soit Claude, il ne connaîtra pas les préférences du manager Tanaka à moins que vous ne les lui enseigniez.
Il y a deux façons de l’activer.
La première est de l’appeler directement vous-même, comme « /creation-rapport ». Utilisez cela quand vous voulez être sûr qu’il s’active.
La seconde est que Claude lise la description de la couverture et juge automatiquement que « cela devrait être utilisé maintenant ». Si la description est bien écrite, il s’activera tout seul sans que vous donniez d’instructions.
Si cela devient un Skill plus important, vous pouvez ajouter des dossiers auxiliaires pour les documents de référence et les modèles, mais un seul SKILL.md suffit au début.
Claude ne ralentira pas même avec 50 Skills
« Si je mets beaucoup de Skills, est-ce que Claude ne va pas ralentir ? »
Je pense que c’est une question que tout le monde se pose au début.
La réponse est : ça ne ralentira pas.
Claude ne charge pas tous les Skills à la fois ; il est conçu pour ne charger que ce qui est nécessaire par étapes.
En termes de CT, un Pokémon ne pense pas à toutes ses capacités tout le temps. Il choisit la capacité à utiliser en fonction de la situation du combat. Claude est pareil.
Niveau 1 : D’abord, jeter un coup d’œil aux noms
Il vérifie d’abord légèrement uniquement le « nom et la description » de tous les Skills. Il n’a pas encore lu le contenu des fichiers.
Niveau 2 : Lire le texte intégral de seulement ce qui est nécessaire
S’il trouve un Skill qui semble lié à la demande en cours, il lit le texte intégral de ce seul Skill. Il ne touche pas au reste.
Niveau 3 : Lire les documents connexes supplémentaires si nécessaire
Si le Skill spécifie « veuillez aussi lire ce document de référence », il lit également ce fichier.
En d’autres termes, même s’il y a 50 Skills, seuls « 1 ou 2 liés au travail en cours » sont réellement chargés. Cela n’a presque aucun impact sur les performances.
Cependant, il y a une chose à surveiller.
Si la « description » sur la couverture est bâclée, Claude ne pourra pas trouver le Skill nécessaire.
Au niveau 1, il pourrait être mal jugé comme « cela ne semble pas lié cette fois » et être ignoré.
C’est pourquoi j’ai dit que la description de la couverture est la plus importante. Il est vital d’écrire clairement « quand et pour quel type de tâche ce Skill doit être utilisé ».
En guide pratique, il n’y a aucun problème tant que le total de tous les noms et descriptions de Skills reste dans les 15 000 caractères. Vous n’atteindrez probablement jamais cette limite avec une utilisation normale.
Votre premier Skill est terminé en 6 étapes
Passons maintenant à la partie pratique.
Je vais décomposer les « 6 étapes pour créer votre premier Skill » présentées par santtiagom_.
Cependant, identifiez d’abord le moment de créer un Skill. Si ne serait-ce qu’une des trois conditions suivantes s’applique, c’est le moment pour un Skill :
- Il y a des informations de contexte que vous tapez manuellement (format, règles, ton, etc.)
- Il y a une tâche que vous voulez voir produite avec la même qualité à chaque fois
- Il y a une étape que vous oubliez toujours
Inversement, les Skills ne conviennent pas aux tâches ponctuelles ou aux travaux où les conditions sont complètement différentes à chaque fois.
Regardons les 6 étapes dans l’ordre.
1️⃣ Les graines des Skills sont dans la répétition
« Si vous avez tapé les mêmes informations de contexte 3 fois ou plus, c’est un candidat pour un Skill. »
santtiagom_ l’affirme.
Formats de compte-rendu de réunion, règles de structure de rapport, tons d’e-mail. S’il y a des informations de contexte que vous tapez à chaque fois, c’est un signe qu’elles devraient être définies dans un Skill.
À partir d’aujourd’hui, pendant une semaine, essayez de noter ce que vous tapez manuellement dans Claude. Vous trouverez des choses que vous répétez 3 fois ou plus.
2️⃣ Préparez-vous avec un dossier et un fichier
Créez un dossier appelé .claude/skills/ dans votre projet Claude Code, créez un dossier avec le nom du Skill à l’intérieur, et placez le fichier SKILL.md là.
1.claude/skills/2 └── weekly-report/3 └── SKILL.md
C’est tout ce dont vous avez besoin pour vous préparer.
3️⃣ 5 lignes suffisent au début
Souvenez-vous des mots de santtiagom_ : « Un Skill fonctionnel de 5 lignes a plus de valeur qu’un Skill parfait avec 80 règles. »
Ne visez pas la perfection dès le départ.
Même pour l’exemple du rapport hebdomadaire plus tôt, cela suffit au début :
1---2name: Rapport de ventes hebdomadaire3description: À utiliser lors de la création du rapport hebdomadaire pour l’équipe de vente chaque lundi4---56Écris la conclusion en premier. Les chiffres sont en comparaison d’une semaine sur l’autre. Limite les problèmes à un. Dans les 2 pages.
Fait. Le corps ne fait qu’une ligne.
Qu’en pensez-vous ? Si c’est juste ça, vous pourriez le faire dès aujourd’hui, non ?
Au fur et à mesure que vous l’utilisez, si vous remarquez que « le manager Tanaka préfère les tableaux aux graphiques » ou « si j’écris “en cours d’examen”, ça me revient », vous pouvez simplement les ajouter à chaque fois.
La version finale vue plus tôt est le résultat d’une croissance de cette façon.
4️⃣ L’effet est clair avec des tests de comparaison
Essayez la même demande à la fois avec le Skill activé et avec le Skill désactivé.
S’il y a une différence claire dans la production, c’est la preuve que le Skill fonctionne.
S’il n’y a pas de différence, le contenu du Skill pourrait ne contenir que des choses que « Claude sait déjà ». Essayez d’ajouter des critères de jugement que vous seul connaîtriez.
5️⃣ Les Skills grandissent à chaque échec
Si vous sentez que « cette partie est encore fausse » après le test, ajoutez cela à SKILL.md à chaque fois.
Pour reprendre les mots de santtiagom_, « Si vous avez fait la même correction 3 fois, ajoutez-la au Skill. »
Un Skill parfait n’est pas quelque chose que vous créez dès le départ ; c’est quelque chose que vous faites grandir en l’utilisant. Ce processus « d’apprendre de l’échec et de grandir » est l’acte de rendre vos critères de jugement de plus en plus précis.
6️⃣ Claude lui-même donnera des suggestions d’amélioration
C’est la partie intéressante.
En utilisant le Skill skill-creator fourni officiellement par Anthropic, Claude lui-même suggérera des choses comme « Que diriez-vous de faire ceci pour rendre ce Skill encore meilleur ? »
Une fois que vous avez défini votre flux de travail dans l’IA, l’IA revient avec « Il serait plus efficace de faire comme ça ». Ce cycle est le plaisir et la force des Skills.
3 Drapeaux Rouges pour Développer des Skills Utiles
Une fois que vous avez créé un Skill, vous devez vérifier s’il fonctionne correctement.
santtiagom_ ne liste qu’une seule méthode de jugement.
Si vous exécutez la même tâche 3 fois et obtenez des résultats différents à chaque fois, ce Skill a besoin d’amélioration.
Plus précisément, surveillez ces trois drapeaux rouges :
Drapeau Rouge 1 : Les instructions sont ignorées
Cela se produit lorsque le libellé du Skill est ambigu.
Par exemple, même si vous spécifiez « écris clairement », les critères de « clair » ne sont pas clairs pour Claude. Dans ce cas, Claude n’a d’autre choix que d’écrire en fonction de son propre jugement.
« Écris la conclusion en premier. Garde une phrase dans les 40 caractères. N’utilise pas de termes techniques. »
Si vous écrivez spécifiquement à ce point, Claude n’hésitera pas. L’astuce est d’écrire avec des chiffres et des règles spécifiques plutôt qu’avec des adjectifs ambigus.
Drapeau Rouge 2 : Le Skill ne s’active pas
C’est un cas où il y a un problème avec la description de la « couverture ».
Souvenez-vous de la discussion sur le chargement par étapes. Claude juge en ne regardant que le « nom et la description » au niveau 1. Si la description ici est ambiguë, elle sera ignorée comme « cela ne semble pas lié cette fois ».
Vérifiez si la description indique clairement en un coup d’œil « quand et pour quelle tâche elle doit être utilisée ».
Drapeau Rouge 3 : La production est générique, aucune différence avec/sans Skill
C’est un état où le contenu écrit dans le Skill ne contient que des choses que « Claude sait déjà ».
Claude est intelligent, donc il peut juger des choses générales tout seul sans qu’on lui apprenne. La bonne façon est d’écrire des critères de jugement que vous seul connaissez dans les Skills.
« Le patron lit à partir de la conclusion », « Il saute les données si elles dépassent 3 points », « Il se fâche si ce n’est pas écrit en comparaison d’une semaine sur l’autre ». Ces règles, nécessaires précisément à cause de votre environnement, déterminent la valeur d’un Skill.
Parmi les meilleures pratiques de santtiagom_, j’ai sélectionné 4 points particulièrement importants à présenter.
① Claude est intelligent. Pas besoin de lui apprendre ce qu’il sait.
Les instructions générales comme « produire au format JSON » sont inutiles. Claude le sait déjà. Enseignez-lui les critères de jugement de votre travail, comme « pourquoi vous faites cela de cette façon » et « dans quel ordre vous le faites ».
② Divisez si cela dépasse 500 lignes
Il dit 500 lignes, mais en fonctionnement réel, environ 100 lignes pour skill.md lui-même est bien. Si le volume augmente trop, la qualité du jugement de Claude Code baissera.
Donc, si un Skill devient trop gros, stockez les documents de référence dans un dossier séparé. L’astuce pour une utilisation à long terme est de garder le corps de SKILL.md concentré uniquement sur les instructions de base.
③ Testez avec des cas réels, pas des idéaux
Tester avec une demande fictive n’a aucun sens. Essayez avec un travail que vous faites réellement le lundi en utilisant les Skills. C’est dans le travail réel que vous verrez les instructions manquantes.
④ Faites-le grandir en l’utilisant plutôt que de viser la perfection
Si vous faites la même correction 3 fois, ajoutez-la à SKILL.md. Cette répétition est le chemin le plus court pour développer un Skill qui vous est dédié.
Pour Ceux Qui Veulent L’Utiliser Plus en Profondeur
C’est la section avancée.
Tout le monde n’a pas besoin de faire cela tout de suite, mais je vais le présenter pour ceux qui veulent « l’utiliser davantage ».
1️⃣ Il existe des Skills officiels que vous pouvez utiliser immédiatement
Anthropic, le développeur de Claude, a officiellement publié 5 types de Skills.
Traitement de fichiers Word, analyse de fichiers Excel, lecture de PDF, génération de PowerPoint, et design front-end. Vous pouvez les utiliser immédiatement simplement en les installant depuis GitHub.
Il existe aussi un site appelé skills.sh qui collecte les Skills créés par la communauté. Cependant, comme ils sont créés par des tiers, je recommande de vérifier le contenu avant de les utiliser. Il est possible que des choses risquées soient incluses, alors soyez très attentif.
2️⃣ Il y a deux emplacements de stockage : pour vous et pour l’équipe
Les Skills ont deux emplacements de stockage.
Pour vous seul :
Si vous le placez dans .claude/skills/ dans votre dossier personnel, cela devient un Skill qui vous est dédié et qui peut être utilisé quel que soit le projet que vous ouvrez.
Pour le partage en équipe :
Si vous le placez dans .claude/skills/ dans un projet, il est inclus dans le contrôle de version, donc tous les membres de l’équipe peuvent utiliser le même Skill.
Personnellement, je pense que ce partage en équipe est l’essence cachée des Skills.
Le fait que vos critères de jugement deviennent un fichier signifie que même si un membre de l’équipe change, la qualité du travail est maintenue. Les critères de jugement ne dépendent plus des individus. C’est un changement assez important pour une organisation.
3️⃣ Les Skills se connectent aussi avec des services externes
En combinant les Skills avec MCP, un mécanisme pour se connecter à des outils externes, Claude devient capable d’interagir directement avec des services externes.
santtiagom_ décrit cela comme « devenir capable de déléguer des processus au lieu d’instructions ».
Cependant, c’est une utilisation avancée pour les ingénieurs. Je recommande de commencer par les 6 étapes de base présentées dans la section précédente.
Résumé
Je vais résumer les points de cet article en 6 éléments. Sauvegardez-le pour pouvoir vous y référer.
- Les Skills sont des « fichiers pour définir des flux de travail dans l’IA ». Comme une CT Pokémon, une fois définie, elle s’active à chaque fois.
- Claude est intelligent mais ne connaît pas « votre façon de travailler ». Sans Skills, vous devez tout configurer vous-même à chaque fois.
- Tout ce dont vous avez besoin est un seul fichier : SKILL.md. Le contenu est juste « Nom + Description + Instructions ».
- Vous pouvez en mettre 50. Claude sélectionne et charge uniquement les Skills nécessaires.
- Commencer petit et le faire grandir est la bonne façon. Un Skill fonctionnel de 5 lignes bat un Skill parfait avec 80 règles.
- L’essence des Skills n’est pas l’automatisation du travail mais « l’actifisation du jugement ». L’acte de verbaliser vos critères de jugement et de les définir dans l’IA.
À ceux qui ont trouvé cet article ne serait-ce qu’un peu utile.
Le Laboratoire Claude Code de l’Université de Tokyo (@ClaudeCode_UT) est un compte qui publie quotidiennement, centré sur des membres qui sont des passionnés de Claude Code et des étudiants actuels de l’Université de Tokyo.
Nous diffusons chaque jour des informations et un savoir-faire « vraiment utiles » spécialisés pour une utilisation pratique en entreprise.
En suivant, vous pouvez obtenir des informations comme celles-ci 👇
- Guides pratiques pour les « techniques pour faire apprendre le travail à l’IA » comme les Skills et CLAUDE.md
- Explications des derniers sujets d’utilisation de l’IA venant de l’étranger pour les non-ingénieurs
- C’est le seul endroit où vous pouvez recevoir des compétences Claude Code « vraiment utiles » gratuitement
Si cela vous intéresse, suivez et venez voir ! 👀
Aussi, nous avons lancé une LINE officielle, donc si vous voulez obtenir rapidement des informations limitées, rejoignez-nous ! Accélérons notre apprentissage et surmontons ensemble l’ère des agents IA ! ❗️
