Préambule
Avez-vous déjà rencontré cette situation : Vous voulez que l’IA vous aide à gérer une tâche spécifique dans votre projet, mais après avoir bourré toutes les connaissances de base, les normes de codage et la documentation API dans le Prompt, vous découvrez que la fenêtre contextuelle (Context Window) de l’IA explose, ou que l’IA commence à divaguer à cause de la surcharge d’informations ?
C’est comme engager un chef étoilé Michelin, mais devoir rester à côté de lui à chaque fois et lui rebattre les oreilles : “Hé, coupe les oignons maintenant, puis brouille les œufs, n’oublie pas d’ajouter du sel…”. Bien que le chef soit compétent, répéter cela à chaque fois est épuisant pour vous, et le chef pourrait manquer quelque chose.
Pour résoudre ce problème, Claude (Anthropic) a introduit un concept puissant — Claude Skill (Agent Skill). Cet article vous plongera dans ce qu’est cette “technologie noire” et comment l’intégrer dans vos projets, transformant chaque agent IA en un atout senior prêt au combat pour vous.
Qu’est-ce que Claude Skill ? (Analogie quotidienne : Recettes secrètes dans la cuisine)
Si nous voulons expliquer Claude Skill de la manière la plus simple, nous pouvons l’imaginer comme des “Fiches Recettes (Recipe Cards) placées sur l’étagère de la cuisine d’un restaurant haut de gamme”.
- Prompting général : C’est comme si vous vous teniez à côté du chef (IA) en donnant des instructions verbales.
- Claude Skills (Agent Skills) : C’est comme écrire vos procédures opérationnelles standard (SOP) dans des fiches recettes.
Ces fiches sont généralement stockées dans des dossiers (le système de fichiers), et le chef n’a pas besoin de mémoriser toute l’encyclopédie (économisant la fenêtre contextuelle). Ce n’est que lorsque vous criez “Fais un Bœuf Wellington”, que le chef va à l’étagère, sort cette fiche recette spécifique et suit les étapes une par une.
Structure centrale d’un Skill
La structure d’un Skill est en fait très simple. Ce n’est qu’un dossier, contenant généralement trois parties :
SKILL.md: C’est la recette elle-même. Elle dit : “Si vous voulez traiter un PDF, faites ceci d’abord, puis cela…”.scripts/(Optionnel) : Comme un éplucheur spécialisé dans la cuisine. Ce sont des scripts Python ou Bash spécifiques que l’IA peut exécuter directement, sans avoir à inventer du code elle-même.- Metadata (YAML) : L’étiquette sur le dos du livre de recettes (nom, description), permettant à l’IA de scanner rapidement et de savoir à quoi sert cette recette.
Pourquoi cela rend-il les agents plus intelligents ? (Avantage architectural)
Cela utilise un concept psychologique/technique appelé “Divulgation Progressive (Progressive Disclosure)”.
- Avant d’utiliser les Skills : Vous bourrez toutes les règles du projet, les normes de code et les documents API dans l’IA. La capacité cérébrale de l’IA (Context Window) explose instantanément.
- Après avoir utilisé les Skills : L’IA commence par savoir seulement “J’ai une liste de ces outils (Metadata)”. Lorsqu’elle rencontre une tâche spécifique, elle “lit” alors ce
SKILL.mdspécifique dans son cerveau.
Cela fait de votre agent IA un “Ingénieur Senior qui sait consulter les manuels”, plutôt qu’un “Intello essayant de mémoriser toute la bibliothèque”.
Analyse approfondie : Mécanique et format du Skill
La logique de fonctionnement de Claude Skill divise l’information en trois niveaux, permettant à l’IA de “ne prendre que ce qui est nécessaire, quand c’est nécessaire” :
| Niveau | Contenu (Content) | Quand chargé (When Loaded) | Coût en jetons | Analogie quotidienne |
|---|---|---|---|---|
| Level 1 | Metadata Tags YAML : Nom, Description |
Toujours (Always) Mettre dans le System Prompt au démarrage |
Très faible (~100 tokens) | Menu du Restaurant Vous regardez le menu et savez que le plat existe, mais n’avez pas encore besoin d’entrer en cuisine. |
| Level 2 | Instructions (Instructions) Enseignement dans SKILL.md |
Au déclenchement (Triggered) L’IA utilise Bash pour lire le fichier quand elle le juge nécessaire |
Moyen (<5k tokens) | Fiche Recette Confirmé pour cuisiner ce plat, alors sortez cette fiche pour voir les étapes. |
| Level 3 | Resources & Code Scripts ( .py) ou références |
Au besoin (As needed) Exécuter un script ou consulter des documents spécifiques |
Presque nul Renvoie uniquement les résultats d’exécution |
Outils Spécialisés Sortez le batteur pour battre les œufs ; vous avez juste besoin du résultat, pas d’avaler la machine entière. |
Exemple de format SKILL.md
Un fichier Skill standard se compose d’un en-tête YAML et d’un contenu Markdown :
---
name: data-analyzer # Règle : minuscules, chiffres, traits d'union
description: Analyze data from CSV files and generate charts. Use when the user asks for insights from spreadsheets. # Règle : Décrire clairement "quoi faire" et "quand utiliser"
---
# Data Analyzer Skill
## Instructions
1. D'abord, vérifiez le chemin du fichier CSV fourni par l'utilisateur.
2. Utilisez le script `scripts/analyze.py` pour lire les données.
3. Si l'analyse réussit, veuillez résumer les tendances des données en Chinois Traditionnel.
## Examples
User: "Analyse ce rapport de ventes"
Assistant: (executes python scripts/analyze.py sales.csv)
Comment construire une architecture universelle “Cross-Model” ?
Un point douloureux pour beaucoup est : “Je ne veux pas être lié à Claude ! Quid des autres IA (comme Gemini, Cursor, VS Code Copilot) ?”
Claude Code peut scanner automatiquement car son runtime a une logique codée en dur pour parcourir .claude/skills. Les autres agents sont comme des lecteurs entrant dans une bibliothèque sans système de catalogue.
Pour résoudre cela, nous pouvons créer un “Index Maître (Master Index)”.
Solution 1 : Créer SKILLS_INDEX.md
Créez un SKILLS_INDEX.md ou AGENTS_README.md à la racine du projet, avec la structure suivante :
# AI Agent Skills Index
(Note : Ce projet contient des Agent Skills modulaires. Lorsque vous rencontrez les tâches suivantes, veuillez lire le fichier SKILL.md correspondant pour les normes opérationnelles.)
## Available Skills
| Nom du Skill (Skill Name) | Chemin (Path) | Description & Quand utiliser (Description & When to use) |
| :--- | :--- | :--- |
| PDF Processing | `skills/pdf-processing/SKILL.md` | Utiliser quand l'utilisateur demande "Lire PDF", "Extraire Tableau", ou "Fusionner Fichiers". |
| Code Review | `skills/code-review/SKILL.md` | Utiliser quand l'utilisateur demande "Revoir Code", "Vérifier PR", ou "Optimiser Code". |
## How to use
1. Lisez la liste ci-dessus d'abord.
2. Basé sur le Prompt de l'utilisateur, jugez quel Skill est le plus pertinent.
3. Lisez proactivement (Read) le contenu de `SKILL.md` à ce chemin dans le Contexte.
C’est comme le “Menu” à l’entrée du restaurant. Dès que Gemini ou Cursor entre dans le projet et lit ce fichier, il sait “Oh ! Donc j’ai ces mouvements disponibles”.
Solution 2 : Solution spécialisée pour Cursor (.cursorrules)
Si vous utilisez Cursor, il a une fonctionnalité puissante appelée .cursorrules. Vous pouvez écrire la logique d’indexation directement dedans, permettant à Cursor de monter automatiquement les Skills.
You are an advanced AI coding assistant. This project utilizes a standardized "Agent Skills" architecture located in the `skills/` directory.
Before executing complex tasks, verify if a relevant skill exists:
[Skill List]
- name: pdf-processing
- path: skills/pdf-processing/SKILL.md
- description: Extract text and tables from PDF files.
Instruction:
If the user's request matches a skill's description, you MUST read the content of the corresponding `SKILL.md` file before proceeding.
Solution 3 : Script de génération automatisée
Pour éviter les tracas de la maintenance manuelle de l’index, vous pouvez écrire un simple script update_skills_index.py pour scanner automatiquement les en-têtes YAML de tous les fichiers SKILL.md et générer SKILLS_INDEX.md.
Comment créer rapidement un Skill ?
Vous ne voulez pas écrire YAML et Markdown à la main ? Vous pouvez utiliser “AI Skill” pour générer “AI Skill” !
Anthropic fournit officiellement un Skill appelé skill-creator, qui est essentiellement un “Assistant style interview (Wizard)”.
- Installer : Mettez le dossier
skill-creatordans votre répertoire skills. - Invoquer : Dites à l’IA : “Hé, je veux créer un nouveau Skill, aide-moi s’il te plaît en utilisant skill-creator.”
- Interagir : Il commencera par vous demander : “Quel outil veux-tu faire ?”, “As-tu besoin d’écrire des scripts Python ?”.
- Générer : Une fois la conversation terminée, il crachera automatiquement le
SKILL.mdau format standard et la structure des dossiers pour vous.
C’est comme si vous n’aviez pas besoin de dessiner le plan vous-même, mais demandiez à un “Robot Générateur de Plans” de le dessiner pour vous.
Conclusion
Claude Skills (Agent Skills) ne sont pas seulement une fonctionnalité exclusive de Claude ; ce sont une norme ouverte de collaboration entre Agents. Grâce à des structures de fichiers standardisées et des mécanismes d’indexation clairs, nous pouvons permettre à cette architecture puissante de franchir les limites des modèles et de l’appliquer dans n’importe quel environnement de développement IA.
Avec ce “Manuel d’Opérations pour Employés Numériques”, votre Agent n’est plus un débutant qui ne sait que divaguer, mais un expert senior qui peut consulter les SOP et exécuter des tâches avec précision à tout moment. Commencez à construire votre bibliothèque standard de Skills maintenant !
Reference
Tutorials
Skills
- skills/skills/skill-creator/SKILL.md at main · anthropics/skills · GitHub
- Agent Skills Marketplace - Claude, Codex & ChatGPT Skills | SkillsMP
- Claude Skills Hub - Discover and Download Skills
- GitHub - ComposioHQ/awesome-claude-skills: A curated list of awesome Claude Skills, resources, and tools for customizing Claude AI workflows