Personal vs project skills

Les skills peuvent être situés dans l'un des trois endroits suivants : personnel, projet ou plugin.

Les skills personnels résident dans ~/.claude/skills/<nom-skill>/SKILL.md et sont disponibles dans tous vos projets. Les skills spécifiques au projet sont stockés dans .claude/skills/<nom-skill>/SKILL.md dans le répertoire du projet. Ces skills de projet sont destinés à être intégrés au contrôle de version, les rendant accessibles à votre équipe. Les skills de plugin sont situés dans la structure de répertoire d'un plugin à <plugin>/skills/<nom-skill>/SKILL.md.

Lorsque des skills portent le même nom dans ces emplacements, la priorité est déterminée comme suit : les skills d'entreprise remplacent les skills personnels, et les skills personnels remplacent les skills de projet. Les skills à l'un de ces niveaux ont également la priorité sur les skills groupés portant le même nom. Par exemple, un skill personnalisé de revue de code dans le répertoire .claude/skills/ de votre projet remplacera la version groupée par défaut.

Les skills de plugin utilisent un espace de noms nom-plugin:nom-skill, ce qui évite les conflits de noms avec les skills à d'autres niveaux. Les skills de projet sont chargés à partir des répertoires .claude/skills/ en commençant par votre répertoire de travail actuel et en remontant dans les répertoires parents jusqu'à la racine du dépôt. Cela garantit que les skills définis au niveau du dépôt sont accessibles même lorsque vous travaillez dans des sous-répertoires.

Les skills peuvent également être chargés à la demande à partir de répertoires .claude/skills/ imbriqués. Lorsque Claude interagit avec des fichiers dans un sous-répertoire, tous les skills contenus dans le .claude/skills/ de ce sous-répertoire deviennent disponibles. Ce mécanisme est particulièrement utile dans les monorepos, où les packages individuels peuvent fournir leurs propres skills. Si un skill imbriqué porte le même nom qu'un autre skill, les deux restent disponibles, et le skill imbriqué est référencé en utilisant son chemin, par exemple, /apps/web:deploy.

Une entrée <nom-skill> peut également être un lien symbolique vers un répertoire situé ailleurs sur votre système de fichiers. Une exception aux règles d'accès aux fichiers typiques se produit avec le drapeau --add-dir et la commande /add-dir : un répertoire .claude/skills/ à l'intérieur d'un répertoire ajouté est automatiquement chargé, contrairement aux répertoires ajoutés via le paramètre permissions.additionalDirectories.