Créer une compétence avec SKILL.md
In questa pagina
Leçon mise à jour le 2 novembre 2026 sur la base de la page Skills de la documentation Vibe : une compétence est un ensemble d’instructions (elle n’ajoute pas d’outils),
allowed-toolsest lu mais non appliqué, et deux champs ont été ajoutés (disable-model-invocation,compatibility). Source : Skills.
Compétences : des composants réutilisables
Les agents définissent qui exécute une tâche. Les compétences définissent quoi : ce sont des ensembles d’instructions réutilisables qui ajoutent des procédures et des commandes slash à Mistral Vibe. La distinction devient concrète lorsque tu l’appliques à ton équipe : un agent reflète une posture de travail personnelle, tandis qu’une compétence encapsule une procédure que tout le monde doit exécuter de la même manière.
Une compétence est un répertoire contenant un fichier SKILL.md avec un en-tête YAML. Cette structure suit la spécification ouverte Agent Skills, rendant les compétences portables et partageables : le même dossier fonctionne sur la machine de ton collègue sans adaptation.
Anatomie d’un SKILL.md
Voici la structure complète d’une compétence, illustrée par un exemple de revue de code automatisée :
---
name: code-review
description: Performs automated code reviews with quality analysis
license: MIT
user-invocable: true
allowed-tools:
- read_file
- grep
- ask_user_question
---
# Code Review Skill
This skill analyzes source code quality by checking:
1. **Naming conventions** — variables, functions, classes
2. **Cyclomatic complexity** — functions that are too long or nested
3. **Duplication** — copy-pasted code to refactor
4. **Security** — dangerous patterns (eval, SQL injection, XSS)
## Usage
Run `/code-review` followed by the path or description of the code to analyze.
## Output format
The report is structured in three levels:
- 🔴 **Critical** — fix immediately
- 🟡 **Warning** — fix before merging
- 🟢 **Suggestion** — optional improvement
Les champs de l’en-tête YAML
Le champ name est l’identifiant unique de la compétence. Il sert à activer, désactiver et référencer la compétence dans les configurations. Ce nom devient également la commande slash, il vaut donc la peine de le garder court.
name: code-review
La description, jusqu’à 1 024 caractères, est la phrase qui apparaît lorsque Vibe liste les compétences disponibles. Rédige-la du point de vue de quelqu’un qui cherche : elle doit lui permettre de choisir entre deux compétences similaires sans ouvrir les fichiers.
description: Performs automated code reviews with quality analysis
Le champ license indique la licence de la compétence, ce qui devient important dès que tu la partages au-delà de ton propre poste de travail.
license: MIT
Le booléen user-invocable, vrai par défaut, expose la compétence en tant que commande slash. Définis-le sur false pour la masquer du menu / : l’agent peut toujours la charger automatiquement lorsque la tâche correspond.
user-invocable: true # Accessible via /code-review
user-invocable: false # Hidden from / menu, agent can still load it
Le champ disable-model-invocation, lorsqu’il est défini sur true, empêche l’agent de charger la compétence de sa propre initiative : elle ne s’exécute que si tu tapes /skill-name. Réserve cela aux procédures qu’aucun modèle ne devrait déclencher sans ton consentement explicite, comme un déploiement.
disable-model-invocation: true
Deux champs informatifs complètent la liste : compatibility, qui note les prérequis (« Requires git »), et allowed-tools, qui liste les outils que la compétence prévoit d’utiliser. Sois prudent avec ce dernier : la documentation précise que Vibe le lit mais ne l’applique pas. Une compétence peut appeler n’importe quel outil que l’agent actif autorise. Pour limiter ce qu’une compétence peut faire, restreins les outils et les permissions de l’agent (Leçons 2 et 3).
allowed-tools:
- read_file
- grep
- ask_user_question
Le corps du SKILL.md
Après l’en-tête, le corps du fichier est du Markdown libre. Il sert à la fois de documentation et de prompt : Vibe le lit pour comprendre comment la compétence fonctionne et dans quel contexte l’appliquer. C’est ici que tu décris ce que fait la compétence, les étapes de son fonctionnement, le format de sortie attendu et des exemples d’utilisation. Un corps vague donne une compétence imprévisible ; un corps précis donne une compétence qui produit le même résultat semaine après semaine.
Crée ta première compétence
Construisons une compétence de génération de tests. Commence par créer son répertoire :
mkdir -p ~/.vibe/skills/test-generator
Place le fichier SKILL.md suivant à l’intérieur. Remarque comment le corps répond aux questions que Vibe devrait autrement deviner : quel framework choisir, comment nommer les blocs, où écrire le fichier de sortie.
---
name: test-generator
description: Generates unit tests for TypeScript/JavaScript functions
license: MIT
user-invocable: true
allowed-tools:
- read_file
- write_file
- grep
---
# Test Generator
Generates comprehensive unit tests for
TypeScript and JavaScript functions.
## Process
1. Read the target source file
2. Identify all exported functions
3. For each function, generate:
- Happy path test
- Test with empty/null inputs
- Edge case tests
- Expected error tests
4. Write tests to an adjacent `.test.ts` file
## Conventions
- Framework: Vitest (default) or Jest if detected
- Naming: `describe` per function, `it` per test case
- Assertions: `expect` with precise matchers
- No mocks unless necessary (external dependencies)
## Example
For a file `utils/math.ts` containing `add(a, b)`,
the skill generates `utils/math.test.ts` with corresponding tests.
Une fois le fichier créé, la compétence est immédiatement disponible : aucune commande d’installation, aucun redémarrage. Lance Vibe et appelle-la sur un fichier réel.
vibe
# > /test-generator src/utils/math.ts
Vibe charge la compétence, lit son SKILL.md pour comprendre le comportement attendu et exécute la tâche avec les outils autorisés. Prends le temps de lire le résultat : en comparant la sortie à ce que tu imaginais, tu affineras le corps du fichier.
Bonnes pratiques
Limite-toi à une compétence par fonctionnalité. Mélanger la revue de code et la génération de tests dans un seul fichier produit un prompt qui hésite et t’empêche de désactiver l’un sans perdre l’autre. De même, limite les outils autorisés à ceux dont la compétence a réellement besoin.
Le reste dépend de la qualité de la rédaction. Le corps du SKILL.md est ton prompt : sois précis et inclus des exemples concrets de ce que la compétence produit — un exemple de sortie vaut plus que trois lignes de description. Enfin, teste ta compétence sur plusieurs cas, y compris un cas délicat, avant de la partager avec l’équipe.
Punti chiave
- Une compétence est un répertoire contenant un fichier
SKILL.mdavec un en-tête YAML - L’en-tête définit le nom, la description, les outils autorisés et l’invocabilité
- Le corps Markdown sert à la fois de documentation et de prompt pour Vibe
user-invocable: truerend la compétence accessible via une commande slash- Crée des compétences spécialisées avec le minimum d’outils nécessaires