allowed-tools

allowed-tools est un champ de métadonnées SKILL.md qui liste les outils que Claude peut utiliser sans permission explicite pendant qu'une compétence est active. Il accepte une chaîne de caractères séparée par des espaces ou des virgules, ou une liste YAML. Par exemple : allowed-tools: Bash(git add *) Bash(git commit *) Bash(git status *).

Crucialement, allowed-tools accorde la permission ; il ne restreint pas les outils disponibles. Tous les outils restent appelables, et vos paramètres de permission standard s'appliquent toujours aux outils non listés ici. Pour supprimer des outils de l'ensemble disponible de Claude pendant l'exécution d'une compétence, utilisez disallowed-tools à la place. Cette restriction est temporaire et s'efface avec votre prochain message.

Pour un blocage persistant sur toutes les compétences et invites, configurez des règles de refus dans vos paramètres de permission .claude/settings.json. Pour les compétences stockées dans le répertoire .claude/skills/ d'un projet, allowed-tools devient actif uniquement après que vous ayez accepté le dialogue de confiance de l'espace de travail pour ce dossier, reflétant la manière dont les règles de permission dans .claude/settings.json sont appliquées. Examinez toujours les compétences du projet avant de faire confiance à un dépôt, car une compétence peut s'accorder un accès large aux outils. C'est pourquoi le scan de sécurité de SkillProof, dans le cadre de son protocole, examine l'intégralité du fichier SKILL.md et tous les scripts groupés avant d'attribuer un score. Par exemple, le Skill Security Auditor utilise ce mécanisme pour auditer le code en toute sécurité.

Comprendre allowed-tools est essentiel pour gérer la manière dont les compétences interagissent avec votre environnement, complétant des concepts comme frontmatter et hooks.