Gestion des compétences : découverte, activation et priorité
Šiame puslapyje
Leçon mise à jour le 2 novembre 2026 sur la base de la page Skills de la documentation Vibe : ajout des emplacements
.agents/skills/, de l’ordre officiel de découverte (chemins personnalisés, projet, utilisateur) et de la commande/reload. La documentation ne définit aucune règle de priorité lorsque deux compétences portent le même nom ; la version précédente en décrivait une. Source : Skills.
Comment Vibe découvre les compétences
Écrire une compétence est une chose ; savoir laquelle s’exécute réellement en est une autre. La documentation spécifie l’ordre dans lequel Vibe découvre les compétences :
- Chemins personnalisés déclarés dans
config.tomlviaskill_paths; - Compétences du projet, situées dans
./.vibe/skills/ou./.agents/skills/, chargées uniquement si le dossier est approuvé ; - Compétences utilisateur, situées dans
~/.vibe/skills/ou~/.agents/skills/.
Les dossiers .agents/skills/ suivent la spécification ouverte Agent Skills : une compétence stockée à cet endroit est partagée avec d’autres agents adoptant la même spécification. Une session active détecte les compétences ajoutées ou modifiées ; si un changement n’apparaît pas, tape /reload.
Structure du répertoire des compétences
Les compétences globales résident dans votre dossier personnel, chacune dans son propre sous-dossier contenant un fichier SKILL.md. Elles sont disponibles partout, dans tous les projets où vous exécutez Vibe.
~/.vibe/skills/
├── code-review/
│ └── SKILL.md
├── test-generator/
│ └── SKILL.md
└── doc-writer/
└── SKILL.md
Les compétences locales, quant à elles, sont versionnées avec le code du projet. C’est l’endroit naturel pour une compétence de déploiement ou de migration, qui dépend de l’infrastructure exacte du dépôt et n’aurait aucun sens ailleurs.
mon-projet/
├── .vibe/
│ └── skills/
│ ├── deploy-prod/
│ │ └── SKILL.md
│ └── db-migrate/
│ └── SKILL.md
├── src/
└── package.json
Enfin, il existe les chemins personnalisés, utilisés pour référencer des compétences situées ailleurs sur votre système. Vous les déclarez dans la configuration :
# ~/.vibe/config.toml
skill_paths = [
"/home/equipe/shared-skills",
"/opt/company-skills"
]
C’est le mécanisme privilégié pour partager des compétences au sein d’une équipe, via un dossier réseau ou un dépôt Git cloné que chacun met à jour de son côté.
Activer et désactiver les compétences
Par défaut, toutes les compétences découvertes sont actives. Deux paramètres symétriques vous permettent de reprendre la main. Avec enabled_skills, vous passez en liste blanche : seules les compétences listées sont actives, les autres sont ignorées.
# ~/.vibe/config.toml
enabled_skills = ["code-review", "test-generator"]
Avec disabled_skills, vous restez en liste noire : toutes les compétences sont actives sauf celles que vous nommez. C’est le bon choix lorsqu’une seule compétence vous gêne temporairement.
# ~/.vibe/config.toml
disabled_skills = ["experimental-feature"]
Motifs de filtrage
Ces deux champs acceptent trois formes de saisie. La plus simple est le nom exact, qui fonctionne tant que la liste reste courte :
enabled_skills = ["code-review", "test-generator", "doc-writer"]
Les motifs glob (glob patterns) prennent le relais dès que vos noms suivent une convention. Le caractère * correspond à n’importe quelle séquence de caractères, vous permettant de gérer toute une famille en une ligne :
# Activer toutes les compétences commençant par "test-"
enabled_skills = ["test-*"]
# Désactiver toutes les compétences expérimentales
disabled_skills = ["experimental-*", "beta-*"]
Pour les cas que les glob ne couvrent pas — une alternative, un motif au milieu d’un nom, un suffixe numérique — préfixez l’expression par re: pour utiliser une expression régulière :
# Activer les compétences dont le nom contient "review" ou "audit"
enabled_skills = ["re:review|audit"]
# Désactiver les compétences versionnées (ex. "tool-v1", "tool-v2")
disabled_skills = ['re:.*-v\d+'] # chaîne littérale : le backslash n'a pas besoin d'être échappé
Deux compétences portant le même nom
La documentation ne décrit aucune règle de priorité pour deux compétences portant le même nom à des emplacements différents. Ne comptez donc pas sur un « écrasement » implicite : donnez-leur des noms distincts (code-review-backend plutôt qu’un second code-review) et vérifiez ce qui est réellement chargé. Dans le menu /, la description de chaque compétence commence par sa portée, project, user ou vibe, ce qui suffit à repérer un doublon. Une compétence nommée comme une commande intégrée n’apparaît pas dans ce menu.
Configuration au niveau du projet
Tous ces paramètres se combinent dans un fichier .vibe/config.toml placé à la racine du projet. L’exemple ci-dessous montre les trois leviers ensemble : restreindre la liste aux compétences pertinentes, exclure celles qui ne le sont pas et ajouter le dossier partagé de l’équipe backend.
# mon-projet/.vibe/config.toml
# Activer uniquement les compétences pertinentes pour ce projet
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]
# Ou désactiver celles qui ne sont pas pertinentes
disabled_skills = ["doc-writer"]
# Ajouter des chemins supplémentaires
skill_paths = ["/home/equipe/backend-skills"]
Pour vérifier quelles compétences sont réellement disponibles, ouvrez le menu / dans la session : chaque compétence y apparaît avec sa portée. C’est le premier réflexe à avoir lorsqu’une commande slash attendue manque, avant d’essayer /reload et de vérifier le statut d’approbation du dossier.
Svarbiausi punktai
- Vibe découvre les compétences dans
~/.vibe/skills/,.vibe/skills/et lesskill_pathspersonnalisés - Les compétences locales ont la priorité sur les compétences globales
- Utilisez
enabled_skillsoudisabled_skillspour contrôler l’activation - Les motifs glob (
test-*) et les regex (re:review|audit) simplifient le filtrage - Créez un
.vibe/config.tomlpar projet pour personnaliser le contexte - Partagez les compétences au sein d’une équipe via
skill_pathspointant vers un dossier commun