Fiche mémo Skills et approche agentique

Choisir le mécanisme

Besoin	Utiliser	Nature
Règle toujours vraie	`CLAUDE.md` (< 200 lignes)	demande
Procédure ou référence à la demande	skill	demande
Doit arriver à chaque fois / bloquer	hook (`PreToolUse`, code de sortie 2)	application
Service ou données externes	serveur MCP	connexion
Recherche volumineuse à contexte isolé	sous-agent	délégation
Réutiliser entre dépôts	plugin	paquet
Isoler les commandes shell	sandbox	application

Une instruction n'est pas une garantie ; un hook ou le sandbox l'est (dans leur périmètre).

Skill : anatomie

.claude/skills/<nom>/SKILL.md     (projet)   ~/.claude/skills/<nom>/SKILL.md   (personnel)
---
name: <nom en minuscules-tirets>
description: ce que fait le skill ET quand l'utiliser
disable-model-invocation: true    # si effet de bord : appel manuel seulement
---
Instructions numérotées, courtes, vérifiables.

Niveau de charge	Contenu
1 au démarrage	`name` + `description`
2 au déclenchement	corps de `SKILL.md`
3 à la demande	fichiers annexes ; scripts : seule la sortie entre dans le contexte

Champs documentés (Claude Code, liste changeante) : disable-model-invocation, user-invocable, allowed-tools, context: fork, argument-hint, model, paths. Page plateforme : name ≤ 64 caractères (minuscules, chiffres, tirets), description ≤ 1024 ; application à Claude Code non vérifiée.

Créer : dossier + SKILL.md dans le projet. Droits : écriture dans le projet. Contrôle : / liste les skills ; essai sur texte fictif. Retour arrière : supprimer le dossier.

Auditer un skill ou un serveur tiers

Relire tous les fichiers, scripts compris.
Chercher réseau, URL externes, installation, accès hors sujet.
Examiner allowed-tools (n'écrase pas les deny).
Effet de bord : disable-model-invocation: true.
Source de confiance seulement ; dépendances qui changent = risque.
Skills non couverts par la conservation zéro donnée (page d'aperçu).

MCP (Claude Code)

Sujet	Repère
Portées	locale (défaut), projet (`.mcp.json`), utilisateur
Transports	HTTP (recommandé), SSE (déprécié), stdio local, WebSocket
Ajouter	`claude mcp add --transport http <nom> <url>` (URL fictive ici)
Contrôler	`claude mcp list`, `/mcp` ; retirer : `claude mcp remove <nom>`
Risques	injection via contenu externe ; serveur local = code avec vos droits
Principes	consentement avant outil ; descriptions d'outils non fiables ; portées minimales

Jamais de jeton en clair dans une commande ou un fichier versionné.

Hooks

Événements : SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop… Entrée : JSON sur stdin. Sortie : 0 = rien à redire ; 2 = bloque (PreToolUse). Un hook est du code exécuté avec vos droits : le relire. Contrôle : essai sur dépôt jetable. Retour arrière : retirer le bloc hooks et restaurer la copie du fichier de réglages.

Permissions (moindre privilège)

Modes : Manuel, acceptEdits, plan, auto, dontAsk, bypassPermissions (VM/conteneur seulement). Règles : deny, puis ask, puis allow. Bash(…) = texte de la commande, pas une frontière. Sandbox : shell seulement, pas sur Windows natif. Partir de « tout refusé », ouvrir finement, relire /permissions.

Évaluer

5 à 10 tâches synthétiques, critère exécutable, cas pièges (entrée vide, consigne piégée, hors périmètre), plusieurs essais, transcriptions, rejouer après chaque modification. Niveaux de contrainte : consigne, condition d'objectif, hook Stop, sous-agent vérificateur (contexte neuf, écarts utiles seulement).

Garde-fous (cumuler)

Permissions + sandbox + environnement jetable + moindre privilège + bornes (tours, budget, durée) + revue humaine avant effet extérieur + journaux + sources de confiance. Contenu externe = donnée, jamais instruction.

Ne jamais envoyer ni écrire

Secrets, clés, jetons, .env, identifiants, hôtes et infrastructure réels, tickets privés, données de santé ou de tiers, documents confidentiels, contenus sous droits. Aucun secret dans SKILL.md, .mcp.json, hook, commande. Fichiers de configuration committés = partagés. Transcriptions locales en clair : purger.

À confirmer (non vérifié)

Format exact des skills/hooks pour la version de Stéphane ; calendrier Gems vers skills (Gemini) ; statut des workflows dynamiques et sessions parallèles (aperçu/expérimental) ; offre de Stéphane.

Sources (consultées le 2026-10-17)

Skills (s’ouvre dans un nouvel onglet) · Agent Skills (s’ouvre dans un nouvel onglet) · Étendre Claude Code (s’ouvre dans un nouvel onglet) · MCP (s’ouvre dans un nouvel onglet) · Hooks (s’ouvre dans un nouvel onglet) · Permissions (s’ouvre dans un nouvel onglet) · Sandbox (s’ouvre dans un nouvel onglet) · Spécification MCP (s’ouvre dans un nouvel onglet) · Sécurité MCP (s’ouvre dans un nouvel onglet) · Gems (s’ouvre dans un nouvel onglet)