Gestion des skills : découverte, activation et priorité

Comment Vibe découvre les skills

Mistral Vibe cherche les skills dans trois emplacements, par ordre de priorité :

1. Global : ~/.vibe/skills/ — skills disponibles dans tous vos projets
2. Local projet : .vibe/skills/ — skills spécifiques à un projet
3. Chemins custom : définis dans votre config.toml

Les skills locaux (projet) ont priorité sur les skills globaux en cas de conflit de nom. Cela vous permet de surcharger un skill global avec une version adaptée à un projet spécifique.

Arborescence des skills

Skills globaux

~/.vibe/skills/
├── code-review/
│   └── SKILL.md
├── test-generator/
│   └── SKILL.md
└── doc-writer/
    └── SKILL.md

Ces skills sont disponibles partout — dans chaque projet où vous lancez Vibe.

Skills locaux

mon-projet/
├── .vibe/
│   └── skills/
│       ├── deploy-prod/
│       │   └── SKILL.md
│       └── db-migrate/
│           └── SKILL.md
├── src/
└── package.json

Ces skills sont liés au projet. Ils n’existent que dans le contexte de mon-projet/.

Chemins custom

Pour référencer des skills situés ailleurs sur votre système :

# ~/.vibe/config.toml
skill_paths = [
  "/home/equipe/shared-skills",
  "/opt/company-skills"
]

C’est utile pour partager des skills au sein d’une équipe via un dossier réseau ou un dépôt Git cloné.

Activer et désactiver des skills

Par défaut, tous les skills découverts sont actifs. Vous pouvez contrôler précisément quels skills sont disponibles dans votre configuration :

Activation sélective

# ~/.vibe/config.toml
enabled_skills = ["code-review", "test-generator"]

Seuls les skills listés sont actifs. Tous les autres sont ignorés.

Désactivation sélective

# ~/.vibe/config.toml
disabled_skills = ["experimental-feature"]

Tous les skills sont actifs sauf ceux listés.

Patterns de filtrage

Vibe supporte trois types de filtrage pour enabled_skills et disabled_skills :

Noms exacts

enabled_skills = ["code-review", "test-generator", "doc-writer"]

Patterns glob

Les patterns glob utilisent * pour correspondre à n’importe quelle séquence de caractères :

# Activer tous les skills commençant par "test-"
enabled_skills = ["test-*"]

# Désactiver tous les skills expérimentaux
disabled_skills = ["experimental-*", "beta-*"]

Expressions régulières

Préfixez avec re: pour utiliser des regex :

# Activer les skills dont le nom contient "review" ou "audit"
enabled_skills = ["re:review|audit"]

# Désactiver les skills versionnés (ex: "tool-v1", "tool-v2")
disabled_skills = ["re:.*-v\d+"]

Priorité et résolution de conflits

Quand deux skills portent le même nom, Vibe applique cet ordre de priorité :

1. Skill local (.vibe/skills/) — priorité maximale
2. Skill dans un chemin custom (skill_paths) — priorité intermédiaire
3. Skill global (~/.vibe/skills/) — priorité minimale

# Si code-review existe dans les trois emplacements :
.vibe/skills/code-review/SKILL.md          ← celui-ci est utilisé
~/shared/skills/code-review/SKILL.md       ← ignoré
~/.vibe/skills/code-review/SKILL.md        ← ignoré

Configuration par projet

Créez un fichier .vibe/config.toml à la racine de votre projet pour personnaliser les skills disponibles :

# mon-projet/.vibe/config.toml

# N'activer que les skills pertinents pour ce projet
enabled_skills = ["test-generator", "deploy-prod", "db-migrate"]

# Ou désactiver ceux qui ne sont pas pertinents
disabled_skills = ["doc-writer"]

# Ajouter des chemins supplémentaires
skill_paths = ["/home/equipe/backend-skills"]

Lister les skills actifs

Pour vérifier quels skills sont disponibles dans votre contexte actuel, consultez la liste affichée par Vibe au démarrage ou tapez la commande de listing dans la session interactive.

Points clés à retenir

• Vibe découvre les skills dans ~/.vibe/skills/, .vibe/skills/ et les skill_paths custom
• Les skills locaux ont priorité sur les skills globaux
• Utilisez enabled_skills ou disabled_skills pour contrôler l’activation
• Les patterns glob (test-*) et regex (re:review|audit) simplifient le filtrage
• Créez un .vibe/config.toml par projet pour personnaliser le contexte
• Partagez des skills en équipe via des skill_paths pointant vers un dossier commun