Configuration et compétences multi-fichiers

Ce que vous apprendrez

Durée estimée : 20 minutes

À la fin de cette leçon, vous serez capable de :

Configurer les champs de métadonnées avancés des compétences, notamment allowed-tools et model
Rédiger des descriptions de compétences efficaces qui se déclenchent de manière fiable sur les bonnes demandes
Utiliser allowed-tools pour restreindre ce que Claude peut faire quand une compétence est active
Organiser les compétences complexes en utilisant la divulgation progressive et les structures multi-fichiers

(4 minutes)

Cette vidéo couvre les techniques avancées qui rendent les compétences plus puissantes : l'ensemble complet des champs de métadonnées, comment rédiger des descriptions qui se déclenchent de manière fiable, restreindre l'accès aux outils pour les workflows sensibles à la sécurité, et organiser les compétences plus grandes sur plusieurs fichiers en utilisant la divulgation progressive. Vous apprendrez comment garder vos compétences efficaces tout en supportant des cas d'usage complexes.

Points clés à retenir

name et description sont obligatoires — allowed-tools et model sont optionnels mais des ajouts puissants
Une bonne description répond à deux questions : Que fait la compétence ? Quand Claude devrait-il l'utiliser ?
allowed-tools restreint les outils que Claude peut utiliser quand la compétence est active — utile pour les workflows en lecture seule ou sensibles à la sécurité
Divulgation progressive : gardez SKILL. md sous 500 lignes et créez des liens vers les fichiers de support (références, scripts, ressources) que Claude ne lit que si nécessaire
Les scripts s'exécutent sans charger leur contenu dans le contexte — seul le résultat consomme des tokens, gardant le contexte efficace

Une compétence basique fonctionne avec juste un nom et une description, mais il existe plusieurs techniques avancées qui peuvent rendre vos compétences beaucoup plus efficaces dans Claude Code. Parcourons les champs clés, les meilleures pratiques pour les descriptions, les restrictions d'outils, et comment structurer les compétences plus grandes.

Champs de métadonnées des compétences

Le standard des compétences d'agent ouvert supporte plusieurs champs dans le frontmatter de SKILL. md. Deux sont obligatoires, et le reste sont optionnels :

name (obligatoire) — Identifie votre compétence. Utilisez uniquement des lettres minuscules, des chiffres et des tirets. Maximum 64 caractères. Devrait correspondre au nom de votre répertoire.
description (obligatoire) — Indique à Claude quand utiliser la compétence. Maximum 1 024 caractères. C'est le champ le plus important car Claude l'utilise pour la correspondance.
allowed-tools (optionnel) — Restreint les outils que Claude peut utiliser quand la compétence est active.
model (optionnel) — Spécifie quel modèle Claude utiliser pour la compétence.

Rédiger des descriptions efficaces

Soyez explicite dans vos instructions. Si quelqu'un vous disait « votre travail est d'aider avec les docs », vous ne sauriez pas quoi faire — et Claude pense de la même manière.

Une bonne description répond à deux questions :

Que fait la compétence ?
Quand Claude devrait-il l'utiliser ?

Si votre compétence ne se déclenche pas quand vous l'attendez, essayez d'ajouter plus de mots-clés qui correspondent à la façon dont vous formulez réellement vos demandes. La description est ce que Claude utilise pour décider si une compétence est pertinente, donc le langage compte.

Restreindre les outils avec allowed-tools

Parfois, vous voulez une compétence qui ne peut que lire les fichiers, pas les modifier. C'est utile pour les workflows sensibles à la sécurité, les tâches en lecture seule, ou toute situation où vous voulez des garde-fous.

Dans cet exemple, le champ allowed-tools est défini à Read, Grep, Glob, Bash. Quand cette compétence est active, Claude ne peut utiliser que ces outils sans demander la permission — pas d'édition, pas d'écriture.

--- name: codebase-onboarding description: Helps new developers understand the system works. allowed-tools: Read, Grep, Glob, Bash model: sonnet ---

Si vous omettez allowed-tools entièrement, la compétence ne restreint rien. Claude utilise son modèle de permission normal.

Divulgation progressive

Les compétences partagent le context window de Claude avec votre conversation. Quand Claude active une compétence, il charge le contenu de ce SKILL. md dans le contexte. Mais parfois vous avez besoin de références, d'exemples, ou de scripts utilitaires sur lesquels la compétence dépend.

Entasser tout dans un fichier de 2 000 lignes a deux problèmes : cela prend beaucoup d'espace dans le context window, et ce n'est pas agréable à maintenir.

La divulgation progressive résout cela. Gardez les instructions essentielles dans SKILL. md et mettez le matériel de référence détaillé dans des fichiers séparés que Claude ne lit que si nécessaire.

Le standard ouvert suggère d'organiser votre répertoire de compétences avec :

scripts/ — Code exécutable
references/ — Documentation supplémentaire
assets/ — Images, modèles, ou autres fichiers de données

Ensuite dans SKILL. md, créez des liens vers les fichiers de support avec des instructions claires sur quand les charger :

Dans cet exemple, Claude lit architecture-guide. md uniquement quand quelqu'un pose une question sur la conception du système. S'il demande où ajouter un composant, ce fichier ne se charge jamais. C'est comme avoir une table des matières dans le context window plutôt que le document entier.

Une bonne règle de base : **gardez SKILL. md sous 500 lignes**. Si vous dépassez cela, considérez si le contenu devrait être divisé en fichiers de référence séparés.

Utiliser les scripts efficacement

Les scripts dans votre répertoire de compétences peuvent s'exécuter sans charger leur contenu dans le contexte. Le script s'exécute et seul le résultat consomme des tokens. L'instruction clé à inclure dans votre SKILL. md est de dire à Claude d'exécuter le script, pas de le lire.

C'est particulièrement utile pour :

La validation de l'environnement
Les transformations de données qui doivent être cohérentes
Les opérations qui sont plus fiables en tant que code testé que code généré

Réflexion sur la leçon

Pensez à une compétence que vous aimeriez construire qui implique plusieurs fichiers. Comment structureriez-vous SKILL. md par rapport aux fichiers de référence de support ?
Y a-t-il des workflows dans votre équipe où restreindre l'accès aux outils avec allowed-tools ajouterait une couche de sécurité importante ?

Prochaines étapes

Dans la prochaine leçon, nous comparerons les compétences aux autres façons de personnaliser Claude Code — CLAUDE. md, les sous-agents, les hooks, et les serveurs MCP — afin que vous puissiez choisir le bon outil pour chaque situation.

Retours

Au fur et à mesure que vous progressez dans le cours, nous aimerions entendre comment vous utilisez les compétences dans votre travail, ainsi que tout retour que vous pourriez avoir. Partagez vos retours ici.