Claude Skills : guide complet pour débutants

Mis à jour le 18 juillet 2026

Un Claude Skill est un dossier qui contient un fichier SKILL.md, puis éventuellement des scripts, des exemples ou des références. Claude Code conserve sa description pour savoir quand l'utiliser et charge le contenu complet quand le skill devient pertinent. Tu peux ainsi transformer une procédure répétée en capacité réutilisable, sans placer toute sa documentation dans le contexte permanent.

À quoi sert un Claude Skill ?

Un skill formalise une manière de travailler. Il peut décrire une revue de code, un contrôle avant déploiement, une méthode de recherche ou une convention éditoriale. Le bénéfice vient de la répétabilité : la procédure vit dans le dépôt, se relit dans Git et évolue avec le projet.

CLAUDE.md reste adapté aux règles qui s'appliquent presque toujours, comme les commandes de test ou les limites de sécurité. Le skill accueille une procédure plus ciblée, avec ses propres ressources et son déclenchement.

Comment créer ton premier skill ?

Commence par un problème réellement répété. Un skill vague ajoute du contexte sans améliorer l'exécution, tandis qu'une procédure précise peut être testée et corrigée.

Créer le dossier et le point d'entrée

mkdir -p .claude/skills/review-avant-deploy
touch .claude/skills/review-avant-deploy/SKILL.md

Le nom du dossier devient la commande /review-avant-deploy. Le fichier d'entrée s'appelle toujours SKILL.md.

Décrire le déclenchement et les étapes

---
name: review-avant-deploy
description: Vérifie un projet avant déploiement. Utiliser après une modification prête à être publiée.
---

# Vérification avant déploiement

1. Lire les commandes de validation du projet.
2. Exécuter les tests pertinents.
3. Contrôler le diff et les secrets.
4. Produire un verdict avec les preuves.
5. Ne jamais déployer sans autorisation explicite.

La description explique ce que fait le skill et quand Claude doit le proposer. Le corps donne une séquence observable. Les interdits sensibles, comme un déploiement, restent explicites.

Où placer les skills ?

Les sessions cloud ne lisent pas les fichiers personnels de ta machine. Elles peuvent charger les skills committés dans le dépôt cloné. Cette différence compte dès qu'un workflow doit fonctionner en local et à distance.

Que mettre dans un skill efficace ?

• Une responsabilité claire, formulée avec une condition d'usage concrète.
• Des étapes vérifiables, avec les commandes ou preuves attendues.
• Des garde-fous, surtout si le workflow écrit, publie, paie ou supprime.
• Des ressources séparées, afin de garder le SKILL.md lisible.
• Un test réel, lancé sur un cas normal puis sur un cas qui doit échouer.

La documentation Claude recommande un SKILL.md concis et des fichiers associés pour les détails. Le contenu complet reste alors hors contexte jusqu'à son utilisation.

Les skills sont-ils portables entre agents ?

Claude Code suit le standard ouvert Agent Skills et ajoute ses propres champs pour le contrôle d'invocation, les outils autorisés ou l'exécution dans un sous-agent. La structure de base reste portable, mais chaque moteur peut interpréter certains champs différemment.

Une bibliothèque durable sépare donc le cœur métier des détails propres à un fournisseur. Les règles de validation, les scripts et les exemples peuvent rester communs, tandis qu'une fine couche adapte le déclenchement à Claude Code, Codex ou un autre agent compatible.

Sources officielles et méthode

• Documentation Claude Code sur les skills, structure, emplacements, déclenchement et partage.
• Standard ouvert Agent Skills, spécification commune du format.
• Méthode éditoriale LE LABO IA, politique de sources, de tests et de corrections.