1. Progressive Disclosure (divulgation progressive)

Les skills utilisent un système à 3 niveaux pour minimiser l’usage de tokens :

• Niveau 1 — YAML frontmatter : toujours chargé dans le system prompt. Juste assez pour que Claude sache quand utiliser le skill.
• Niveau 2 — Corps du SKILL.md : chargé quand Claude juge le skill pertinent. Contient les instructions complètes.
• Niveau 3 — Fichiers liés : fichiers dans le dossier que Claude explore uniquement si nécessaire.

2. Portabilité

Un skill fonctionne identiquement sur Claude.ai, Claude Code et l’API. Créer une fois, utiliser partout (sous réserve que l’environnement supporte les dépendances éventuelles).

3. Composabilité

Claude peut charger plusieurs skills simultanément. Ton skill doit fonctionner en coexistence avec d’autres — ne pas supposer qu’il est le seul disponible.