Créer un Skill (SKILL.md)

💡 Sujet

Les "skills" permettent d'étendre les capacités de l'agent CLI en lui fournissant des instructions spécialisées, des workflows précis ou des accès à des ressources spécifiques pour une tâche donnée.

🏗️ Arborescence cible

Les skills sont généralement stockés dans un répertoire dédié au sein de la configuration de l'outil ou du projet.

.claude/ (ou dossier system)
└── skills/
    └── mon-nouveau-skill/
        ├── SKILL.md          # Le cœur du skill (instructions)
        └── resources/        # (Optionnel) Scripts, templates, data

📜 Contenu du fichier SKILL.md

Le fichier doit suivre une structure structurée (souvent en XML ou Markdown balisé) pour que l'agent puisse l'interpréter correctement.

1️⃣ Métadonnées (<status>)

Définit si le skill est actif ou en cours de développement.

2️⃣ Instructions (<instructions>)

C'est la partie la plus critique. Elle doit contenir :

• Le rôle : "Tu agis en tant qu'expert en..."
• Le workflow : Les étapes séquentielles à suivre (ex: 1. Analyser, 2. Tester, 3. Implémenter).
• Les contraintes : Ce que l'agent ne doit jamais faire.

3️⃣ Ressources disponibles (<available_resources>)

Liste les fichiers ou outils spécifiques que l'agent peut invoquer lorsqu'il active ce skill.

<instructions>
- Utilise toujours la bibliothèque X pour les appels API.
- Avant de modifier un fichier OpenAPI, valide-le avec `openapi-spec-validator`.
</instructions>
<available_resources>
- /path/to/template-api.yaml
</available_resources>

⚙️ Activation du Skill

Une fois le fichier créé, l'agent peut l'activer via une commande interne (ex: activate_skill) ou par détection automatique du contexte. L'agent traite alors les instructions du skill comme prioritaires sur ses instructions générales.

🧩 Résumé

• SKILL.md : Document central qui définit le comportement expert.
• Contexte : Permet de donner des règles métier spécifiques sans polluer le prompt système global.
• Priorité : Les instructions du skill surchargent les directives générales de l'agent.

🔗 Références

• Documentation interne Claude Code (Skills System)