Claude Skills : le guide complet, par quelqu'un qui en fait tourner quatre-vingts

Un skill est un fichier texte qui contient vos instructions. Rien d'autre. Vous écrivez une fois comment vous voulez qu'une tâche soit faite, et Claude charge ce fichier chaque fois que la situation s'y prête. Pas de code, pas d'installation, pas de développeur.

Le fichier s'appelle SKILL.md, il est au format Markdown, et vous pouvez l'écrire dans le Bloc-notes. Voilà la forme, sur un exemple volontairement banal.

# Compte rendu de réunion

Quand je te donne des notes de réunion, rends-moi :
1. La décision prise, en une phrase
2. Qui fait quoi, avec une date
3. Les points restés ouverts

C'est tout. Une fois ce fichier en place, vous ne redonnez plus jamais la consigne : Claude la charge quand la situation correspond, et il l'applique de la même façon en janvier et en juillet.

Un skill sans connecteur sait quoi faire mais n'a accès à rien. Un connecteur sans skill a accès à tout mais ne sait pas comment vous travaillez. C'est en les combinant que ça devient intéressant, et c'est le sujet de mon article sur les connecteurs MCP.

Il y a trois chemins selon l'endroit d'où vous travaillez, et un seul demande de toucher à un terminal.

Depuis l'application, sans rien installer

Dans l'application de bureau, la gestion des skills se fait depuis Personnaliser, dans la barre latérale. Sur claude.ai, elle se fait dans les réglages, section capacités. Vous activez ceux qui vous intéressent, vous ajoutez les vôtres, c'est terminé.

En déposant un dossier

Un skill personnel est un dossier contenant un fichier SKILL.md, déposé dans ~/.claude/skills/. Un skill de projet va dans .claude/skills/ à la racine du dossier de travail, ce qui permet de le versionner et de le partager avec une équipe.

Depuis une bibliothèque

Deux commandes suffisent pour installer une collection entière. Voilà celles de la bibliothèque officielle d'Anthropic.

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

Anthropic fournit un skill dont le seul métier est de fabriquer des skills. Il s'appelle skill-creator. Vous décrivez ce que vous voulez, en français, et il génère la structure du dossier, met en forme le fichier et rassemble les ressources.

Ma méthode, celle que je fais appliquer en formation, tient en quatre étapes.

1. Repérez la répétition. Cherchez dans vos conversations récentes la consigne que vous avez recopiée trois fois. C'est votre premier skill, pas besoin d'en chercher un plus noble.
2. Dictez-la au skill-creator. Décrivez la procédure comme vous l'expliqueriez à un stagiaire. Les cas particuliers, les interdits, le format attendu.
3. Testez sur trois cas réels. Pas sur un exemple inventé. Un skill se juge sur ce qu'il produit quand la situation est bancale, pas quand elle est idéale.
4. Ajoutez ce qui a manqué. Un skill se corrige en ajoutant une ligne, pas en repartant de zéro. Les nôtres démarrent tous autour de quinze lignes et se stabilisent vers quarante après six mois d'usage.

C'est l'objection que je reçois systématiquement en formation. Si j'encode mes procédures dans un format propriétaire, je me lie à un éditeur.

La réponse est agentskills.io. Le format a été créé par Anthropic puis ouvert, avec une gouvernance communautaire et une spécification publique. Le site recense une quarantaine d'outils qui le lisent aujourd'hui : Claude Code bien sûr, mais aussi Cursor, GitHub Copilot, VS Code, OpenAI Codex, Gemini CLI, JetBrains, Databricks, Snowflake.

Autrement dit, un skill que vous écrivez ce mois-ci reste lisible si vous changez d'outil l'an prochain. C'est un fichier texte au format ouvert, pas une base de données enfermée dans un produit.

Deux détails qui ont leur importance. Les commandes personnalisées ont fusionné avec les skills : un fichier dans .claude/commands/ et un skill créent tous deux une commande utilisable directement. Et sur les quatre skills bureautiques officiels d'Anthropic, ceux qui produisent du Word, du PDF, du PowerPoint et de l'Excel, la licence est source-available et non pas ouverte. Les autres sont en Apache 2.0. La nuance compte si vous redistribuez.

C'est là que le terrain devient sale. J'ai passé les bibliothèques en revue une par une, et l'écart entre ce qui est annoncé et ce qui est utilisable est considérable.

Sur ces derniers, soyons précis, parce que c'est le genre de chiffre que tout le monde recopie sans vérifier. 2,4 millions, ce sont des fichiers ramassés automatiquement sur GitHub, pas des skills testés ni même fonctionnels. Cinq dépôts différents s'appellent « awesome-claude-skills ». La marque est diluée au point de ne plus rien signifier.

Un dernier point sur une commande qui circule beaucoup : npx skills add n'est pas une commande Anthropic. C'est un outil de Vercel Labs, sérieux et largement adopté, mais hors du standard officiel. Anthropic documente /plugin marketplace add.

Je vais être direct sur un point : je ne publie pas mes skills. Ce sont des procédures d'entreprise, construites sur des projets clients, et elles restent chez nous. Ce que je peux partager, c'est la méthode qui a permis de les construire, et ce que j'ai compris en chemin.

La bibliothèque de La Mine couvre aujourd'hui les mêmes familles que n'importe quelle entreprise de services : le cadrage de projet, l'avant-vente, le contrôle qualité avant livraison, la qualification des demandes entrantes, le reporting. Rien d'exotique. Ce sont les tâches qu'on refait toutes les semaines, et c'est exactement pour celles-là que le mécanisme est fait. Chacune s'appuie sur des outils que j'ai branchés en connecteurs.

Ce qui a réellement changé

Le gain que j'attendais était du temps. Le gain que j'ai obtenu est ailleurs : la régularité. Un livrable sorti en juillet a le même niveau qu'un livrable sorti en janvier, quelle que soit la personne qui l'a produit. C'est ce qui manque le plus dans une structure qui grossit, et c'est ce que personne ne pense à demander à un outil d'intelligence artificielle.

Le deuxième effet a été l'intégration des nouveaux. Avant, une méthode vivait dans la tête de deux personnes et se transmettait par compagnonnage. Maintenant elle est écrite, appliquée, et corrigée par tout le monde. Une associée d'Airtree, un fonds cité par Anthropic, dit la même chose avec ses mots : les skills construits par une personne sont devenus utilisables par tous, et l'outil est passé de gain individuel à infrastructure partagée.

Ce que je fais appliquer en formation

Commencez par ce qui vous agace. Pas par la tâche la plus stratégique. Par celle que vous réexpliquez pour la troisième fois cette semaine. Le premier skill sert à comprendre le mécanisme, pas à transformer l'entreprise.

Écrivez les interdits avant les consignes. Les nôtres consacrent environ un tiers de leur contenu à ce qu'il ne faut pas faire. C'est contre-intuitif et c'est ce qui évite les dérapages, parce qu'un modèle comble toujours un silence.

Un skill par procédure, jamais deux. La tentation est de tout mettre dans un seul fichier. Le résultat est un skill de trois cents lignes appliqué à moitié. Découpez, quitte à en avoir quarante.

Écrire un skill trop long

Un skill de trois cents lignes qui couvre huit cas de figure sera mal appliqué. Découpez-le. Un skill, une procédure.

Décrire ce qu'on veut sans dire ce qu'on refuse

Les meilleurs de mes skills consacrent un tiers de leur contenu aux interdits. Ne jamais promettre un délai sans cahier des charges. Ne jamais envoyer sans relecture. C'est ce qui évite les dérapages.

Confondre skill et prompt

Un prompt sert une fois. Un skill est une règle permanente que la machine applique sans qu'on la lui rappelle. Si votre contenu ne mérite pas d'être appliqué la prochaine fois sans y penser, ce n'est pas un skill.

Installer sans lire

Voir plus haut. Le format autorise des scripts. Un skill venu d'un dépôt inconnu mérite une lecture avant installation, exactement comme une extension de navigateur.