Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Gestion des compétences : découverte, activation et priorité

Paskaita 7 iš 14 Atnaujinta 2026 m. lapkričio 2 d. Pažengusiems
Šiame puslapyje
  1. Comment Vibe découvre les compétences
  2. Structure du répertoire des compétences
  3. Activer et désactiver les compétences
  4. Motifs de filtrage
  5. Deux compétences portant le même nom
  6. Configuration au niveau du projet
  7. Svarbiausi punktai

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 :

  1. Chemins personnalisés déclarés dans config.toml via skill_paths ;
  2. Compétences du projet, situées dans ./.vibe/skills/ ou ./.agents/skills/, chargées uniquement si le dossier est approuvé ;
  3. 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 les skill_paths personnalisés
  • Les compétences locales ont la priorité sur les compétences globales
  • Utilisez enabled_skills ou disabled_skills pour contrôler l’activation
  • Les motifs glob (test-*) et les regex (re:review|audit) simplifient le filtrage
  • Créez un .vibe/config.toml par projet pour personnaliser le contexte
  • Partagez les compétences au sein d’une équipe via skill_paths pointant vers un dossier commun