Vous avez expliqué le même travail à une fenêtre de clavardage encore une fois. Les règles de ton. La forme de sortie. Les faits qu’elle ne doit jamais inventer. Les compétences Gemini existent pour mettre fin à cette boucle, et la partie que la plupart des couvertures enterrent est le fichier en dessous. Google a construit les compétences sur la norme ouverte SKILL.md, alors une compétence que vous écrivez une fois comme un fichier que vous gardez peut aller dans Gemini et peut aussi aller dans d’autres assistants qui lisent cette même norme.
Google a annoncé les compétences le 30 septembre 2026, comme des instructions réutilisables qui remplaceront les Gems. Le déploiement dans l’application Gemini a commencé le 13 octobre 2026. Ce tutoriel suit les pages d’aide Gemini Apps et la spécification Agent Skills, vérifiées le 11 novembre 2026. Il ne prétend à aucun essai propre. La section Vérification vous dit comment juger le résultat dans votre propre compte.
Ce que vous allez construire ou apprendre
Vous terminerez avec une compétence qui fonctionne et qui rédige une description de produit à partir de faits que vous fournissez. L’exemple est petit exprès. Une fois que le fichier fonctionne dans Gemini, vous réutiliserez ce fichier exact hors de Gemini, et vous apprendrez où la réutilisation s’arrête. Les scripts, les fichiers et l’accès aux outils ne voyagent pas aussi fidèlement que les instructions.
Le gain est la propriété. Une compétence construite seulement dans une application vit à la merci de cette application. Une compétence gardée comme un fichier dans votre propre dossier peut être modifiée, partagée, rangée avec un projet et chargée de nouveau quand vous changez d’outils. Notre profil de Microsoft APM, le gestionnaire de paquets pour les compétences d’agents, couvre comment les équipes partagent de tels fichiers à grande échelle. Ce tutoriel couvre la version à une compétence que n’importe qui peut faire aujourd’hui.
La description en haut d’un fichier SKILL.md décide quand un assistant va le chercher. Illustration : Dirty Static
Avant de commencer
Choisissez un travail qui se répète et qui a une sortie vérifiable. Le texte de produit, les notes de réunion dans une forme fixe ou un rapport dans un format maison fonctionnent bien. Un travail vague fait une compétence vague, et une description vague fait manquer à Gemini les moments où la compétence devrait s’appliquer.
Deux limites façonnent toute la méthode, et Google énonce les deux en termes simples. Premièrement, les compétences dans l’application Gemini et les compétences dans les applications Workspace ne se synchronisent pas. Une compétence dont vous avez besoin aux deux endroits doit être créée à chaque endroit. Deuxièmement, les scripts dans une compétence téléversée qui ont besoin d’accéder à des sites Web externes ne sont pas pris en charge dans Gemini. Une compétence dont le cœur est un appel Web peut fonctionner dans un agent de codage et échouer dans Gemini, même si les instructions se chargent dans les deux.
Étape 1 : écrire le fichier maître SKILL.md
Action : créez un dossier avec un nom en lettres minuscules reliées par des traits d’union, puis créez un fichier nommé SKILL.md dans ce dossier. La spécification Agent Skills dit que le nom du dossier doit correspondre au champ de nom dans le fichier, que le nom peut utiliser seulement des lettres minuscules, des chiffres et des traits d’union, et qu’il ne peut ni commencer ni se terminer par un trait d’union. La description peut aller jusqu’à 1 024 caractères au plus, et elle devrait dire ce que la compétence fait et quand l’utiliser.
Enregistrez cet exemple comme le fichier SKILL.md dans un dossier nommé draft-product-description :
---
name: draft-product-description
description: Drafts product copy from supplied facts for an online shop. Use when preparing a new product page or rewriting catalogue copy from a list of facts, price and materials.
---
# Draft a product description
Use only the facts the user supplies in the chat. Never invent a price, a material, a size or a delivery claim.
## Steps
1. Read the supplied facts and list any fact that is missing for a complete description.
2. If the price or the material is missing, ask for it and stop.
3. Draft a title of eight words or fewer from the product name and its main use.
4. Write two short paragraphs. The first states what the product is and who it suits. The second states the materials, the size and the care facts, when supplied.
5. End with one plain line that gives the price exactly as supplied.
## Output shape
Return the title on its own line, then the two paragraphs, then the price line. Keep the tone plain and factual.
Résultat attendu : vous tenez un dossier avec un fichier, et le fichier a deux parties. Le frontmatter entre les lignes à trois tirets porte le nom et la description. Le corps Markdown en dessous porte les instructions, les étapes et la forme de sortie. Gardez le corps sous 500 lignes, comme la spécification le conseille, et déplacez le long matériel de référence dans des fichiers séparés seulement quand la compétence en a vraiment besoin.
Étape 2 : téléverser le fichier dans Gemini
Action : ouvrez l’application Web Gemini, allez à la page des compétences et, en haut, sélectionnez Create puis Upload, comme la page d’aide Gemini Apps le décrit. Sélectionnez le fichier SKILL.md lui même, ou sélectionnez le dossier ou un fichier zip qui garde SKILL.md dans son dossier principal. Sélectionnez Open, ajoutez tout fichier supplémentaire que le flux offre, puis sélectionnez Upload. Examinez la compétence, modifiez le nom, la description ou les instructions si l’écran d’examen montre un changement que vous n’attendiez pas, puis sélectionnez Create en haut.
Résultat attendu : la nouvelle compétence apparaît sur votre page des compétences avec le nom draft-product-description. Google liste une limite totale de 100 MB pour tous les fichiers téléversés avec une compétence, et seuls les fichiers à base de texte simple sont pris en charge pour la voie de téléversement. Si le téléversement échoue, cherchez des fichiers cachés dans le dossier, comme un fichier .DS_Store, et retirez les avant de réessayer.
Vous pouvez aussi construire une compétence dans Gemini avec Create manuellement, avec un gabarit, ou en demandant à Gemini dans un clavardage de transformer une bonne conversation en compétence. Ces voies sont plus rapides pour une compétence unique. La voie du fichier dans cette étape est celle qui vous laisse avec une copie maîtresse que vous pouvez réutiliser ailleurs, ce qui est l’objet de ce tutoriel.
Étape 3 : utiliser la compétence dans un clavardage
Action : ouvrez un nouveau clavardage et tapez une barre oblique, ou le signe arobase si votre compte montre le raccourci mis à jour, puis sélectionnez draft-product-description. Collez une courte liste de faits réels pour un produit, avec son nom, son matériel, sa taille et son prix, et demandez la description.
/draft-product-description
Facts: enamel mug, 350 ml, steel with enamel coat, white, price 18 dollars. For campers and desk use. Hand wash only.
Résultat attendu : Gemini suit la forme de sortie du fichier. Vous obtenez un titre court, deux paragraphes et une ligne de prix, et aucune affirmation qui était absente de vos faits. Laissez un fait de côté à un deuxième essai, comme le prix. La compétence devrait demander le fait manquant et s’arrêter, comme ses instructions le dirigent. Ce refus fait partie de la conception, pas un échec.
Les compétences peuvent aussi s’appliquer d’elles mêmes. Google dit que Gemini peut utiliser une compétence activée quand le contexte d’une tâche lui convient, et vous pouvez éteindre une compétence sur la page des compétences si vous voulez un contrôle manuel seulement. Vous pouvez aussi utiliser plus d’une compétence dans une seule tâche. Empilez cette compétence de texte avec une deuxième compétence qui garde votre voix de marque, et le clavardage suivra les deux ensembles d’instructions dans une réponse.
Étape 4 : réutiliser le même fichier dans d’autres outils
Action : gardez le dossier draft-product-description comme maître, et chargez ce même SKILL.md dans chaque autre assistant que vous utilisez qui prend en charge la norme Agent Skills. Google énonce la promesse de réutilisation en une ligne dans son billet Workspace : les compétences sont construites sur la norme ouverte SKILL.md, et cela vous permet de copier les compétences que vous avez créées sur d’autres plateformes dans l’application Gemini et les applications Workspace. La spécification à agentskills.io définit la même forme de fichier pour chaque client qui l’adopte.
Un fichier maître, beaucoup de salles : chaque outil reçoit sa propre copie, alors le dossier que vous gardez est la source qui compte. Illustration : Dirty Static
Résultat attendu : les instructions voyagent. Le nom, la description et le corps devraient se lire pareil dans Claude, ChatGPT, un agent de codage ou des outils de style Gemini CLI qui lisent la norme, sous réserve de chaque outil et de sa propre voie d’importation et de ses règles de dossier. Suivez les étapes d’importation que l’outil lui même documente, placez le dossier là où cet outil lit les compétences et lancez les mêmes faits de produit de l’étape 3 comme entrée de test.
Ce qui ne voyage pas mérite un poids égal. Les outils ne se synchronisent pas, alors une correction que vous faites dans Gemini n’atteint jamais la copie dans un autre outil, et une correction dans le dossier maître n’atteint aucun outil jusqu’à ce que vous chargiez le fichier de nouveau. La prise en charge des fichiers, la prise en charge des scripts et l’accès aux outils varient aussi selon le client. La page d’aide Gemini limite les compétences téléversées aux fichiers texte simple pris en charge et bloque les scripts qui ont besoin de sites Web externes. Attendez vous à ce que les mots se transportent. Testez les suppléments dans chaque outil avant de vous y fier. Notre guide sur les vérifications PlugVet pour les compétences et les extensions d’agents est une lecture utile avant de charger une compétence écrite par quelqu’un d’autre.
Étape 5 : mettre à jour le maître, puis le charger de nouveau
Action : quand la sortie dérive, changez d’abord le fichier maître SKILL.md. Clarifiez l’étape qui a échoué, ajoutez le cas limite manquant aux instructions et enregistrez le fichier. Mettez ensuite à jour chaque endroit où la compétence vit. Dans Gemini, Google note que mettre à jour des fichiers dans une compétence signifie téléverser la compétence entière avec ses fichiers de nouveau. Vous pouvez aussi demander à Gemini de mettre à jour une compétence dans l’application, mais gardez ce changement en phase avec le fichier maître ou les copies se sépareront.
Résultat attendu : chaque copie remonte à un fichier modifié, et vos notes peuvent nommer la date de la dernière mise à jour. Si vous sautez le maître et modifiez seulement dans une application, vous possédez maintenant deux compétences qui partagent un nom et diffèrent en comportement, ce qui est exactement la dérive que ce tutoriel voulait tuer.
Vérification
Commencez un clavardage neuf dans Gemini, appelez la compétence avec une barre oblique et utilisez des faits pour un produit que la compétence n’a jamais vu. Vérifiez trois choses dans la réponse. Le titre et les paragraphes suivent la forme de sortie. Chaque affirmation dans le texte apparaît dans les faits que vous avez fournis. La ligne de prix correspond exactement à votre prix fourni, sans affirmation ajoutée au sujet de la livraison ou du stock.
Lancez ensuite les mêmes faits dans un autre outil où vous avez chargé le fichier. Le libellé peut différer, puisqu’un modèle différent écrit le texte. La forme, le comportement en cas de fait manquant et l’interdiction des affirmations inventées devraient tenir aux deux endroits. S’ils tiennent aux deux, le fichier fonctionne comme une compétence portable, pas seulement comme un réglage Gemini.
Terminez avec la vérification des Gems. Si vous gardez encore des Gems qui comptent pour vous, ouvrez les notes de transition des compétences dans l’aide Gemini Apps. Google dit que les Gems passent au panneau Settings le 17 novembre 2026, et que tout Gem laissé dans l’application quand le soutien se termine passera à des compétences en ébauche de lui même. Un passage manuel maintenant vous permet de transformer vos meilleurs Gems en fichiers SKILL.md propres pendant que vous pouvez encore comparer les anciennes et les nouvelles formes côte à côte.
Dépannage
| Problème | Cause probable | Correctif |
|---|---|---|
| Aucune page des compétences n’apparaît dans votre compte | Le déploiement est graduel, ou le type de compte n’est pas encore couvert | Confirmez que vous utilisez un compte Google personnel et que vous avez 18 ans ou plus, puis vérifiez l’application Web, l’application mobile et l’application Mac. Attendez le déploiement si aucune ne montre les compétences encore |
| Le téléversement est rejeté | SKILL.md n’est pas à la racine du dossier, le nom brise la règle de nommage, ou la taille totale des fichiers dépasse 100 MB | Placez SKILL.md dans le dossier principal, faites le nom de la compétence en minuscules avec des traits d’union et une correspondance avec le nom du dossier, retirez les fichiers cachés et coupez les gros fichiers de référence |
| Gemini n’applique jamais la compétence de lui même | La description est trop vague pour que Gemini la relie à la tâche, ou la compétence est éteinte | Réécrivez la description pour nommer ce que la compétence fait, quand l’utiliser et les mots qu’une demande utilisera. Sur la page des compétences, activez la compétence si vous voulez un usage automatique |
| La compétence invente un prix ou un matériel | Les instructions n’interdisent pas les faits ajoutés, ou l’entrée de test a laissé des trous sans règle pour les trous | Ajoutez une règle simple qui nomme le comportement interdit, plus une étape qui demande un prix ou un matériel manquant et qui s’arrête. Testez de nouveau avec un fait retiré |
| La compétence fonctionne dans Gemini mais est absente dans Workspace | Les compétences ne se synchronisent pas entre l’application Gemini et les applications Workspace | Créez la compétence de nouveau dans Workspace à partir du même fichier maître. Gardez les deux copies liées à ce seul fichier pour les mises à jour ultérieures |
| Un script dans la compétence échoue dans Gemini | Le script a besoin d’accéder à un site Web externe, ce que Gemini ne prend pas en charge pour les compétences téléversées | Gardez les instructions portables et gardez le script comme une partie facultative pour les outils qui le prennent en charge. Énoncez cette limite dans le corps de la compétence pour qu’aucun lecteur n’attende que le script fonctionne partout |
| La même compétence donne une forme différente dans un deuxième outil | Cette copie est vieille, ou cet outil ne lit qu’une partie du paquet | Chargez le fichier maître actuel de nouveau dans cet outil, puis relancez l’entrée de test de l’étape 3 et comparez la forme, pas le libellé exact |
Prochaines étapes
Construisez une deuxième petite compétence qui fait bien un travail étroit, comme une vérification de voix de marque, et empilez la avec la compétence de texte de produit dans un clavardage. Deux compétences étroites qui se combinent battent une compétence géante qui essaie de gouverner chaque tâche, et chacune reste facile à tester seule.
Enregistrez les dossiers maîtres avec le projet qu’ils servent, dans un dépôt ou un dossier de disque partagé que votre équipe peut lire. Quand une compétence fait ses preuves dans deux outils, ce dossier devient une partie du registre du projet, de la même façon qu’un guide de style. Commencez avec une compétence, prouvez la à deux endroits, et seulement alors construisez la bibliothèque.
Faits vérifiés par rapport à l’aide Gemini Apps sur la création et la gestion des compétences, au billet Google Workspace Updates du 30 septembre 2026, avec sa mise à jour du 9 novembre 2026, et à la spécification Agent Skills à agentskills.io, le 11 novembre 2026. Cette procédure a été vérifiée par rapport à ces documents et n’a pas été présentée comme un essai personnel.
Sources
- Google, Gemini Apps Help: Create and manage skills for Gemini Apps
- Google, Gemini Apps Help: Write effective skills for Gemini Apps
- Google Workspace Updates, September 30, 2026: Introducing skills in the Gemini app and Workspace, plus what is next for Gems
- Agent Skills specification, agentskills.io
- Illustrations: Dirty Static
FIN DE LA TRANSMISSION
Restez curieux. Remettez tout en question.
