Déclenchement des skills
L'agent ne lit pas tous les skills : il choisit d'après leur description. Une description précise déclenche le bon skill au bon moment ; une description vague le charge pour tout.
- skill
- description
- déclenchement
- disable-model-invocation
- frontmatter
Syntaxe
description (frontmatter) = ce que fait le skill + quand l'utiliserBon déclencheur : verbe + objet + contexte (« Ajoute une leçon à un parcours Central Campus »)Mauvais déclencheur : thème vague (« bonnes pratiques », « aide au code »)disable-model-invocation: true → le skill ne se lance que sur demande explicite de l'utilisateurExemple
Skill A, description : « Aide au code » → chargé pour presque toutes les demandes, il encombre le contexte.Skill B, description : « Ajoute une leçon à un parcours (module TS, slug unique). À utiliser quand on demande une nouvelle leçon ou un nouvel exercice. »Demande : « ajoute un exercice sur HAVING »Résultat attendu : B est chargé ; A devrait être réécrit ou supprimé.À retenir
- Rangez les skills d'équipe dans le dépôt, versionnés ; vos skills personnels dans votre dossier utilisateur (par exemple ~/.claude/skills/).
- Si deux descriptions se recouvrent, fusionnez les skills ou précisez leurs frontières : sinon l'agent choisit au hasard.
- Réservez disable-model-invocation aux procédures à risque (publication, migration de production) : c'est l'humain qui décide du moment.
- Piège : installer un skill d'une place de marché sans le relire. Son contenu est suivi comme vos propres consignes ; relisez-le comme une dépendance, scripts compris.
Voir aussi
- Skill (SKILL.md)Un skill est un dossier d'instructions spécialisées que l'agent ne charge que si la tâche le demande. Il capitalise une procédure répétée, là où AGENTS.md décrit le projet en permanence.
- Injection de prompt par le dépôtTout ce que l'agent lit peut devenir une consigne : README, issue, page web, skill téléchargé. Un texte caché exigeant d'afficher .env est une attaque, que seules les règles de l'outil bloquent.
- Les quatre couches d'instructionsLes consignes d'un agent viennent de quatre couches : vos règles personnelles, le fichier du projet, les rules ciblées par chemin et les skills chargés à la demande. Chaque consigne a sa place.