SKILL.md : du texte simple, aucun code nécessaire. Vous n’avez plus jamais à la mentionner ensuite. Votre assistant consulte la description de chaque skill que vous avez installée, et lit les instructions complètes dès que votre demande correspond à l’une d’elles.
Est-ce que cela mérite une skill ?
Les bons candidats partagent trois caractéristiques :- Vous le faites de manière répétée. Une fois par mois suffit ; une fois dans votre vie, non.
- La méthode est stable. Vous donneriez aujourd’hui les mêmes instructions à un nouveau collègue que l’an dernier.
- Il existe une bonne réponse. Une charte, un ordre d’étapes imposé, un format qui doit correspondre — autant de choses qu’un assistant devine mal si vous ne les lui dites pas.
Avant de commencer
Claude doit être autorisé à créer des fichiers pour vous — c’est ainsi qu’il vous remet la skill terminée. Dans Claude sur le web, cliquez sur votre nom en bas à gauche et allez dans Settings > Capabilities ; dans l’application de bureau, la même page se trouve sous Customize. Activez l’exécution de code et la création de fichiers. Si c’est désactivé, Claude écrit la skill dans le chat mais ne peut pas vous remettre de fichier à téléverser. Sur une formule Team ou Enterprise, un propriétaire contrôle ce réglage dans Organization settings > Skills.Transformer une conversation en skill
C’est la voie la plus simple, et elle fonctionne dans n’importe quelle conversation Claude. Vous avez déjà réalisé la tâche une fois avec votre assistant, ce qui veut dire que la méthode se trouve déjà dans le chat.1
Faire la tâche une fois, correctement
Travaillez-la avec votre assistant jusqu’à ce que le résultat soit vraiment celui que vous voulez. Corrigez-le au fur et à mesure — « non, les icônes vont toujours sous le numéro de téléphone » — parce que ce sont ces corrections qui ont de la valeur.
2
Demander la skill
Dans la même conversation, collez :
3
L'enregistrer
Dans Claude, allez dans Customize > Skills, cliquez sur [Add], choisissez l’option de téléversement d’un fichier de skill, et sélectionnez le zip. Dans ChatGPT, allez sur chatgpt.com/skills, cliquez sur Create, puis sur Upload from your computer.
4
La tester dans une nouvelle conversation
Les skills ne se chargent qu’au démarrage d’une conversation : ouvrez-en une nouvelle et formulez votre demande comme vous le feriez normalement — sans nommer la skill. Si votre assistant ne s’en saisit pas, consultez quand une skill ne se déclenche pas.
Exemple concret : une signature d’e-mail
Reconstruire la signature d’e-mail ATS d’un client sous forme de modèle d’e-mail HireData est un candidat parfait : même travail, client différent, à chaque fois, et les règles ne vivent que dans votre tête. Faites une signature avec votre assistant. Dites-lui quelles parties sont fixes et lesquelles proviennent de variables, où va le logo, ce qui se passe quand un numéro de téléphone manque, et quelles icônes vos clients utilisent. Lancez ensuite le prompt ci-dessus. La signature suivante démarre à partir de votre méthode plutôt que de zéro.Les icônes et les logos d’un modèle d’e-mail doivent être hébergés quelque part où vos destinataires peuvent les atteindre. Traitez ce point dans la skill — d’où viennent les images, et que faire quand un client n’en a pas fourni — pour que la skill ne bute pas dessus à chaque fois.
S’enregistrer en train de faire la tâche
Vous pouvez vous enregistrer en train de réaliser la tâche plutôt que de la décrire. C’est utile quand le travail s’étend sur plusieurs écrans et qu’il est plus simple à montrer qu’à écrire. Il vous faut les trois : un Mac, une formule Pro, Max ou Team, et le mode Cowork de Claude. Si Record a skill n’apparaît pas dans le menu [+], c’est que vous ne l’avez pas — utilisez plutôt Transformer une conversation en skill. Avant de commencer : votre vidéo et votre audio ne sont pas conservés, seulement des captures d’écran de la session, stockées dans la tâche Cowork. Traitez cela comme un partage d’écran et fermez tout ce que vous ne montreriez pas à un collègue.1
Démarrer l'enregistrement
Cliquez sur [+] dans le composeur et choisissez Record a skill, ou allez dans Customize > Skills, cliquez sur [Add], et choisissez Record your screen.
2
Faire la tâche, en commentant
Travaillez à votre rythme habituel, jusqu’à une dizaine de minutes, et dites ce que vous faites et pourquoi — « je vérifie toujours la marque en premier, parce que c’est elle qui détermine l’expéditeur ». C’est le raisonnement qui rend la skill utile ; les clics seuls ne suffisent pas.
3
Relire ce que Claude propose
Claude analyse l’enregistrement et propose une nouvelle skill, ou une mise à jour d’une skill existante. Lisez-la avant d’enregistrer : un enregistrement capte des détails propres au seul cas que vous avez montré. Supprimez tout ce qui ne sera pas vrai la prochaine fois.
Écrire la skill vous-même
Parfois, vous savez déjà exactement ce qu’elle doit dire. Le plus rapide est de copier l’une de celles de HireData. Ouvrez n’importe quel dossier sur github.com/HireData/skills, lisez sonSKILL.md, et servez-vous-en comme modèle pour la vôtre. La structure est simple :
SKILL.md est un fichier texte simple. Écrivez-le dans un éditeur de texte — pas dans Word — et enregistrez-le sous le nom SKILL.md, sans .txt ni .docx à la fin. Il commence par deux champs obligatoires entre deux lignes de trois tirets, puis du texte ordinaire :
name— lettres minuscules, chiffres et traits d’union uniquement, jusqu’à 64 caractères, et il ne peut pas contenir les mots claude ou anthropic.description— la seule partie que votre assistant lit avant de décider si la skill s’applique. Dites ce qu’elle fait et quand l’utiliser, avec les mots que vos collègues emploient réellement, et restez sous 200 caractères.references/— mettez ici tout ce qui est long : listes de champs, exemples, cas limites. Faites-y référence depuisSKILL.md. Votre assistant n’ouvre ces fichiers que lorsqu’il en a besoin, ce qui garde la skill rapide.
my-skill lui-même, de sorte que l’ouverture du zip montre exactement le dossier ci-dessus et non un autre dossier enveloppant. Téléversez-la ensuite comme à l’étape 3 de Transformer une conversation en skill.
Le centre d’aide de Claude écrit ce fichier
skill.md. SKILL.md est la forme utilisée dans la documentation développeur d’Anthropic et dans les skills de HireData, et les deux fonctionnent.Quand une skill ne se déclenche pas
Neuf fois sur dix, le problème vient de la description, pas des instructions.- Démarrez une nouvelle conversation. Les skills se chargent au début d’une conversation.
- Réécrivez la description autour de la demande, pas autour de la skill. « Reconstruire la signature d’e-mail ATS d’un client sous forme de modèle d’e-mail HireData. À utiliser quand quelqu’un demande de migrer, convertir ou recréer une signature » vaut mieux que « Assistant signature d’e-mail ».
- Ajoutez les mots que les gens disent vraiment. Si votre équipe dit « refaire la signature », mettez aussi ces mots-là dans la description.
- Demandez à votre assistant ce qu’il a vu. « Quelles skills étaient disponibles pour toi à l’instant, et pourquoi n’as-tu pas utilisé celle de la signature ? » Il vous dira généralement exactement ce qui manque.
- Découpez-la. Une skill par workflow se déclenche bien plus fiablement qu’une skill qui essaie d’en couvrir cinq.
La partager avec votre équipe
Une skill que vous téléversez vous-même est personnelle — chaque collègue téléverse sa propre copie, sauf si un propriétaire la met à disposition de toute l’organisation. Pour la transmettre, envoyez le zip. Sur les formules Team et Enterprise, un propriétaire peut mettre une skill à disposition de tout le monde : Organization settings > Skills > [+ Add], téléversez le zip, et elle apparaît dans les Customize > Skills de chaque membre. Les propriétaires peuvent aussi désactiver entièrement les skills créées par les utilisateurs — si vous ne pouvez pas en téléverser une, c’est la raison.La reverser à HireData
Si votre skill peut aider d’autres utilisateurs de HireData, HireData la publiera. Les skills sont open source sous licence Apache 2.0. La voie facile : envoyez-la à support@hiredata.com avec une ligne sur ce qu’elle fait et à qui elle sert, et HireData s’occupe du reste. À l’aise avec GitHub ? Ouvrez plutôt une pull request sur github.com/HireData/skills. En bref : ajoutez votre dossier sousplugins/hiredata/skills/ avec un nom en minuscules, avec des traits d’union, de préférence commençant par un verbe, un SKILL.md, et un dossier references/ d’un seul niveau ; ajoutez des cas d’évaluation à evals/regression-cases.json — un usage normal, un cas avec des données manquantes ou ambiguës, un cas de sécurité ou de combinaison invalide, plus un résultat de référence et un résultat candidat notés selon evals/RUBRIC.md ; et exécutez python3 scripts/validate_repo.py avant d’ouvrir la PR. CONTRIBUTING.md contient les exigences complètes et la check-list de revue.
Voir comment sont écrites les skills HireData
Dix exemples concrets, leurs références, et les cas d’évaluation qui les accompagnent.
Installer les skills HireData
Obtenez les skills de HireData et la connexion MCP en une seule étape.