Skills dans Claude Code : conserver les fonctionnalités sans surcharger le contexte

Comment les skills influencent la fenêtre initiale de la session

Dans Claude Code, les skills sont des dossiers structurés contenant des fichiers Markdown (notamment SKILL.md) que l'agent analyse pour étendre ses capacités. Lors de l'initialisation d'une session, l'agent lit les noms et les descriptions sommaires des skills disponibles afin de répertorier les opérations spécialisées qu'il peut exécuter.

L'empreinte d'un skill dans le contexte se décompose en trois niveaux :

1. Annonce système (description et déclencheur) : le bloc YAML description et le nom dans SKILL.md. Cette information reste dans la mémoire active pour permettre au modèle d'associer la demande de l'utilisateur au bon outil.
2. Corps principal de l'instruction : procédures détaillées, étapes opérationnelles et exemples. Le modèle ne charge ce texte que lorsque le skill concerné est activé.
3. Scripts et références externes : exécutables dans le dossier scripts/ ou documents dans references/, exécutés de manière déterministe par des commandes de terminal.

Une erreur courante consiste à insérer des documentations volumineuses ou des manuels entiers directement dans la description ou dans le fichier racine CLAUDE.md. Cela ajoute des tokens superflus à chaque interaction.

Lors de la configuration d'un accès API externe via des plateformes comme BetterToken, le tableau de bord (Dashboard) enregistre la consommation des tokens d'entrée (input), de sortie (output) et de cache pour chaque appel. Cependant, le suivi côté serveur ne mesure que les échanges réseau ; il ne remplace pas l'audit interne de vos fichiers de configuration locaux. Les détails d'intégration et les endpoints compatibles sont consultables sur BetterToken Docs.

Inventaire des skills selon la fréquence d'usage

Pour garder un espace de travail fluide, listez l'ensemble des skills configurés dans votre dépôt et dans votre dossier utilisateur (~/.claude/skills/).

Classez-les en fonction de leur fréquence réelle d'utilisation :

En règle générale, si une instruction n'est requise qu'une fois toutes les dix ou quinze sessions, elle ne doit pas encombrer en permanence la mémoire de travail de l'agent.

Séparer les directives essentielles des ressources à la demande

Pour limiter la charge en tokens, structurez chaque skill autour d'un point d'entrée concis relié à des scripts exécutables.

1. Optimiser le frontmatter YAML

Le champ description doit préciser clairement les conditions de déclenchement :

---
name: db-migrator
description: >-
  À utiliser pour vérifier et appliquer les migrations Prisma lors des modifications de schéma de base de données.
---

Évitez d'inclure de longs blocs de code dans l'en-tête. Déplacez les schémas et références dans le sous-dossier references/.

2. Déléguer la logique à des scripts déterministes

Plutôt que de demander au modèle de générer des commandes complexes à partir d'explications textuelles, placez la logique dans un script :

<!-- Dans SKILL.md -->
Pour valider l'intégrité du schéma, lancez :
```bash
python3 scripts/validate_schema.py --strict

Cette approche réduit considérablement la taille de `SKILL.md` tout en garantissant un résultat reproductible. Ne désactivez jamais les outils de vérification de sécurité ou les validateurs de types pour économiser des tokens ; la rigueur des contrôles déterministes reste primordiale.

Vérifier la détection et l'exécution des outils

Après avoir réorganisé vos skills, assurez-vous que le modèle continue de charger les instructions au bon moment.

Étape 1 : Vérifier la syntaxe et les chemins d'accès

Vérifiez que tous les fichiers SKILL.md contiennent un YAML valide et que les chemins vers les scripts sont corrects :

# Vérification des fichiers du skill et des droits d'exécution
test -f .claude/skills/db-migrator/SKILL.md && echo "SKILL.md OK"
test -x .claude/skills/db-migrator/scripts/validate_schema.py && echo "Script executable OK"

Étape 2 : Tester l'activation dans une session neuve

Démarrez une nouvelle session et formulez une demande liée à la tâche sans mentionner explicitement le nom du skill :

« Je dois mettre à jour l'entité utilisateur dans le schéma Prisma et vérifier la migration. »

L'agent doit :

1. Identifier la tâche grâce à la description dans db-migrator.
2. Charger le corps d'instruction du SKILL.md.
3. Proposer l'exécution du script de validation préparé.

Étape 3 : Évaluer le contexte de départ

Observez le déroulement de la session. L'objectif est de supprimer le bruit superflu pour préserver l'historique de travail, sans viser un pourcentage d'économie arbitraire. Ne laissez actifs que les skills nécessaires aux objectifs de développement immédiats.