Guide complet pour débutants sur les Agent Skills : créez votre première compétence

Voici la traduction du texte anglais vers le français (Français) :

Toute personne travaillant avec l'IA a rencontré ce problème :

Vous lui apprenez quelque chose, vous commencez une nouvelle conversation le lendemain, et tout est remis à zéro.

Vous passez trois jours à peaufiner un flux de travail, en faisant des allers-retours avec Claude pour que ce soit parfait, pour finalement devoir tout lui réexpliquer le lendemain.

Vous enregistrez des instructions dans vos notes et les collez à chaque fois, mais coller une instruction de 500 mots chaque jour pendant un mois vous fait vous demander : est-ce vraiment ainsi que l'IA devrait être utilisée ?

Skill est né précisément pour résoudre ce problème.

Il a été lancé par Anthropic en octobre 2025 et est devenu un standard ouvert en décembre.

Aujourd'hui, tout Internet crie « Les Skills changent la productivité », mais la plupart des gens en ont seulement entendu parler sans vraiment comprendre la différence entre les Skills, les instructions, les bases de connaissances, MCP et les agents – et encore moins en construire un eux-mêmes.

Cet article explique tout d'un coup.

D'abord, comprenez une chose : les Skills ne sont liés à aucune IA spécifique.

Beaucoup de gens entendent « Claude Skills » et pensent qu'il s'agit d'une fonctionnalité exclusive à Claude, mais ce n'est pas le cas. Agent Skills est un standard ouvert lancé par Anthropic ; Claude n'en est que le principal implémenteur.

Le même dossier Skill peut être placé dans ~/.claude/skills/ pour Claude Code, ~/.cursor/skills/ pour Cursor, ou utilisé avec OpenAI Codex, Gemini CLI, VS Code Copilot, et JetBrains Junie.

Le Skill que vous écrivez aujourd'hui peut être transféré de manière transparente à un autre Agent demain ; votre investissement ne sera pas verrouillé dans une seule entreprise.

Cet article utilisera principalement Claude Code comme exemple (car il est le créateur du standard avec l'écosystème le plus complet), mais tous les principes, méthodes d'écriture et expériences de dépannage s'appliquent à tous les outils d'IA qui supportent Agent Skills.

Quand vous voyez « Claude Skill », pensez « Agent Skill ».

1. Qu'est-ce qu'un Skill exactement ?

Définition en une phrase :

Un Skill est un dossier, centré autour d'un fichier Markdown appelé SKILL.md, qui indique à une IA comment exécuter de manière stable un type spécifique de travail professionnel selon un SOP que vous définissez.

Il encapsule « comment un certain type de chose doit être fait » dans un module de capacité réutilisable et déclenché automatiquement.

Essentiellement, c'est une « extension » pour une IA généraliste.

Une IA généraliste est comme une machine nue – intelligente mais manquant de connaissances métier. Un Skill est un module prêt à l'emploi : installez un « Skill Style Xiaohongshu », et l'IA devient immédiatement un éditeur qui comprend votre marque ; installez un « Skill Rapport Hebdomadaire », et l'IA génère immédiatement des rapports dans le format de votre entreprise.

Et cette « extension » n'est pas difficile en matière d'IA : Claude Code, Codex, Cursor, Gemini CLI et Junie reconnaissent tous le même format.

Vous créez un Agent Skill, pas un script exclusif à Claude.

Frontières avec quatre autres concepts :

Beaucoup de gens confondent les Skills avec les instructions, les bases de connaissances, MCP et les agents, mais ils sont distincts :

Analogies courantes :

• Prompt = Envoyer un message WeChat à un employé ; il l'oublie une fois que c'est fait.
• Skill = Écrire un manuel pour l'employé et le mettre sur son bureau, avec une boîte à outils.
• Base de connaissances = Une bibliothèque qui vous dit ce qui existe dans le monde.
• MCP = Divers ustensiles de cuisine qui résolvent le problème « peut-on le faire ».
• Agent = L'ensemble du système d'employés, avec mémoire et capacité de décision ; un Skill n'en est qu'une partie.

Ces quatre concepts ne s'excluent pas mutuellement.

Dans le travail réel, ils sont souvent combinés : MCP permet à Claude de se connecter à Reddit pour récupérer des données, un Skill lui apprend à filtrer/classer/recommander ces données, une Base de connaissances fournit des documents de marque, et l'Agent est le système entier qui exécute le processus.

2. Architecture et mécanisme de fonctionnement

Structure des fichiers

Chaque sous-répertoire résout un problème différent mais sert le même objectif – économiser le contexte et stabiliser la qualité :

• scripts/ : Calculs précis sans consommer de contexte.
• references/ : Chargé à la demande pour éviter de gaspiller de l'espace.
• assets/ : Standardise les formats de sortie.

Divulgation Progressive en Trois Couches – L'Âme de la Conception des Skills

Le mécanisme central d'un Skill est le chargement en trois couches, ce qui explique pourquoi une douzaine de Skills peuvent coexister sans faire exploser le contexte :

Par exemple :

Au démarrage, Claude ne feuillette que les « couvertures » de tous les Skills pour décider lequel utiliser ; ce n'est que lorsqu'il est temps de travailler qu'il ouvre le texte principal ; et ce n'est que lorsqu'il doit vérifier une annexe qu'il consulte les références.

Ce mécanisme vous permet d'avoir 17 Skills actifs simultanément sans saturer la fenêtre de contexte de 200K.

Métadonnées YAML

Descriptions des champs :

La Description Détermine le Succès ou l'Échec

Dans l'architecture à trois couches, la description de niveau L1 est la plus critique – elle détermine si votre Skill sera déclenché.

Faits clés :

1. Claude ne lit que les descriptions de tous les Skills au démarrage.
2. Il prend des décisions sémantiques basées sur la description, pas sur la correspondance de mots-clés.
3. Claude a tendance à être conservateur : en cas de doute, il ne se déclenche pas. Dans les tests, les descriptions vagues avaient une précision de déclenchement de seulement 55 %.

Exemple négatif (ne sera jamais déclenché) :

[Description vague]

Exemple positif (style « insistant » recommandé par Anthropic) :

[Description spécifique]

Trois Règles d'Or pour écrire les descriptions :

1. Écrire QUOI + QUAND ensemble : Dites ce qu'il fait et quand l'utiliser.
2. Lister les mots déclencheurs en anglais et en français : Correspondre à ce que l'utilisateur dit.
3. Être insistant plutôt que conservateur : Anthropic précise que le principal problème est le sous-déclenchement.

3. Principes Fondamentaux pour Écrire de Bons Skills

Trois Principes Principaux

Comment gérer la liberté :

Cinq Modèles de Conception

Anthropic a résumé cinq modèles de conception de Skills à partir des premiers utilisateurs :

Les Skills utiles mélangent souvent plusieurs modèles. Vous n'êtes pas obligé de les suivre strictement, mais savoir qu'ils existent vous aide à concevoir de manière plus structurée.

Règle d'Or : Utilisez « Pourquoi » au lieu de « Doit »

Ceci est une citation du code source de skill-creator (le méta-Skill officiel d'Anthropic pour créer des Skills) :

« Essayez d'expliquer au modèle pourquoi les choses sont importantes au lieu d'utiliser des DOIT impératifs et lourds. »

Exemple négatif :

[Règles strictes avec DOIT]

Exemple positif :

[Expliquer le raisonnement]

Dans le premier cas, Claude ne suivra que ces deux règles. Dans des situations non couvertes par les règles (comme une commande apparemment sûre mais risquée), il sera bloqué. Dans le second cas, Claude comprend « pourquoi la sécurité est importante » et penchera vers la prudence même dans les zones grises.

Les raisons permettent au modèle de généraliser ; les règles ne couvrent que les scénarios auxquels vous pouvez penser. La seule exception est le format de sortie : les exigences mécaniques comme « la sortie doit utiliser ce modèle » n'ont pas de « pourquoi » à expliquer, alors codez-les en dur.

Propriété de l'Information : Ne Vous Répétez Pas

skill-creator a également une règle absolue :

« L'information doit exister dans SKILL.md ou dans les références – pas dans les deux. »

SKILL.md ne doit contenir que les procédures de base ; déplacez les détails dans references/. Un stockage en double entraîne des incohérences lorsque vous mettez à jour un endroit mais oubliez l'autre.

Fichiers à Éviter

Les Skills sont pour l'IA, pas pour les humains. N'ajoutez pas de README.md, INSTALLATION_GUIDE.md, QUICK_REFERENCE.md ou CHANGELOG.md. Ces documents humains ne font que gaspiller du contexte.

4. Construire Votre Premier Skill

Les Six Étapes Officielles d'Anthropic

Le processus standard défini dans skill-creator :

1. Capturer l'Intention : Clarifier quoi faire / quand déclencher / format de sortie / besoins de test.
2. Entretien et Recherche : Cas limites / formats d'entrée-sortie / fichiers d'exemple / dépendances.
3. Écrire SKILL.md : Rédiger le brouillon.
4. Cas de Test : Écrire 2-3 cas de test réels.
5. Exécuter et Évaluer : Exécuter avec-skill et sans-skill (baseline) côte à côte pour un benchmark.
6. Itérer : Modifier en fonction des retours et réexécuter jusqu'à satisfaction.

Quatre Voies Rapides pour les Utilisateurs Réguliers

skill-creator : Le Méta-Skill pour Écrire des Skills

Je recommande vivement d'installer d'abord le skill-creator officiel d'Anthropic. C'est un Skill conçu pour vous aider à créer des Skills. Une fois lancé, Claude vous interviewera – vous posant des questions sur votre flux de travail, les conditions de déclenchement et les limites – puis générera automatiquement le SKILL.md et la structure de dossiers.

Commande d'installation :

[Commande]

Il ne se contente pas de produire un résultat ; il vous aide également à :

• Eval : Générer automatiquement des cas de test pour vérifier si le Skill se déclenche correctement.
• Améliorer : Optimiser automatiquement les descriptions et les instructions en fonction des résultats des tests, en utilisant une répartition 60/40 entraînement/test pour éviter le surapprentissage.
• Benchmark : Suivre les taux de réussite et l'utilisation des tokens, et même effectuer des tests A/B entre deux versions.

Un Exemple Minimal

Supposons que vous soyez un blogueur culinaire Xiaohongshu qui souhaite réécrire des recettes standard dans le style Xiaohongshu :

Placez-le dans ~/.claude/skills/xiaohongshu-recipe/SKILL.md. À l'avenir, dire « convertis en version Xiaohongshu » le déclenchera automatiquement.

De la création du fichier à son utilisation, cela prend moins de 20 minutes.

5. Installation, Stockage et Utilisation Multi-Outils

Priorité de Chargement (4 Niveaux)

Claude Code recherche dans l'ordre suivant ; les emplacements plus spécifiques ont une priorité plus élevée :

Astuce : Sauf s'il est spécifique à un projet, conservez-les dans le répertoire personnel ~/.claude/skills/ pour une gestion unifiée.

Trois Méthodes d'Installation :

N'oubliez pas de redémarrer Claude Code après l'installation.

Compatibilité Multi-Outils (Répétée)

Comme mentionné, les Skills ne sont pas liés à Claude. Voici les comparaisons de chemins :

Signification opérationnelle : Vous pouvez créer un lien symbolique du même dossier SKILL.md vers différents répertoires d'outils. C'est le plus grand avantage d'Agent Skills en tant que standard ouvert.

Points Douloureux pour les Utilisateurs en Chine

• Claude officiel est cher : Utilisez des API proxy pour un meilleur rapport qualité-prix.
• CC Switch : Un outil open source pour gérer et basculer entre plusieurs configurations API (github.com/farion1231/cc-switch).
• L'installation native est plus stable que npm : curl -fsSL https://claude.ai/install.sh | bash.

6. Avancé – Architecture de Collaboration Multi-Skills

Granularité

Principe Fondamental : Une tâche claire par Skill. Ne créez pas de « Skill universel ». »

Si la granularité est trop grossière, la description devient floue et les déclenchements sont imprécis. Si elle est trop fine, les coûts de gestion augmentent. Une granularité raisonnable est un Skill par catégorie de problème, avec un corps de SKILL.md d'environ 200 à 500 lignes.

Étude de Cas : Suite de Skills pour l'Écriture de Blog

Ne créez pas un seul « Skill d'écriture tout-en-un ». Divisez-le en 5 Skills collaborant :

Mode de collaboration : Le Skill principal appelle explicitement d'autres Skills dans sa section ## Steps.

Avantages de cette division :

Cinq Expériences d'Ingénierie

1. Granularité fine : Une tâche claire par Skill.
2. Collaboration explicite : Utilisez ## Steps dans le Skill principal pour appeler les autres.
3. Scripts pour les calculs : Utilisez des scripts pour les décomptes de caractères SEO ou les statistiques de liens ; ne laissez pas le modèle estimer.
4. Guides de style indépendants : Mettez les connaissances stables (style d'écriture / spécifications de marque) dans references/ afin de ne modifier qu'un seul fichier pour mettre à jour le style.
5. Modèle de secours : Les modèles fournissent une garantie de base pour que la sortie ne soit pas trop éloignée de la cible.

7. Évaluation et Itération Professionnelles

Système d'Évaluation :

Le processus standard de skill-creator :

1. Écrire des instructions de test dans evals/evals.json.
2. Exécuter with_skill et baseline (sans skill) simultanément pour une comparaison en double aveugle.
3. Noter chaque assertion à l'aide de agents/grader.md.
4. Utiliser aggregate_benchmark pour produire un rapport sur le taux de réussite / le temps / les tokens.

Optimisation Automatique de la Description

La partie la plus précieuse de skill-creator est l'Optimisation de la Description :

• Écrire 20 requêtes d'évaluation de déclenchement (8-10 doivent déclencher + 8-10 ne doivent pas déclencher).
• Difficulté : Les « quasi-échecs » pour les non-déclenchements – des requêtes qui partagent des mots-clés mais nécessitent d'autres outils.
• Script d'optimisation : 60 % d'entraînement + 40 % de test retenu pour éviter le surapprentissage.
• Effectuer 5 cycles et choisir la description avec le score de test le plus élevé.

Bons exemples de déclencheurs : N'écrivez pas simplement « extrait le tableau PDF » ; écrivez comme un vrai utilisateur :

« ok alors mon patron vient de m'envoyer ce fichier xlsx (il est dans mes téléchargements, il s'appelle quelque chose comme 'Q4 ventes final FINAL v2.xlsx') et elle veut que j'ajoute une colonne qui montre la marge bénéficiaire en pourcentage. »

Cela inclut des chemins de fichiers, un contexte personnel, des noms de colonnes, un langage décontracté et des fautes de frappe potentielles.

Mentalité d'Itération

Quatre points de skill-creator :

1. Généraliser à partir des retours : N'ajoutez pas de règles pointilleuses pour un cas unique. Si un problème se reproduit, essayez une métaphore ou un flux de travail différent.
2. Garder léger : Vérifiez les transcriptions pour les instructions qui font perdre du temps et supprimez les parties qui n'aident pas.
3. Expliquer pourquoi : Les LLM ont une théorie de l'esprit et peuvent généraliser.
4. Trouver le travail redondant : Si tous les sous-agents écrivent create_docx.py indépendamment, regroupez-le dans scripts/.

La première version n'est jamais parfaite.

Un cas d'itération réel : Le skill /daily d'un auteur a nécessité 6 versions pour se stabiliser.

• v1 : Étapes floues, mauvais chemins.
• v2 : Ajout de l'intégration du système de découverte de contenu.
• v3 : Correction des erreurs de calcul de progression hebdomadaire.
• v4 : Ajout de déclencheurs automatiques (rappels le mardi, archivage en fin de mois).
• v5 : Ajout du mode clair iPhone (saut des étapes Python sur mobile).
• v6 : Enfin « bon à utiliser ».

Un Skill n'est pas un fichier de configuration que l'on installe et qu'on oublie ; c'est un document vivant de votre flux de travail.

8. Quand Devriez-Vous Créer un Skill ?

Tout ne mérite pas d'être un Skill. N'agissez que lorsque l'un de ces trois signaux apparaît :

Inversement : Quand NE PAS en créer

• Tâches uniques : Utilisez simplement une instruction.
• Sur-encapsulation : Diviser les Skills après seulement trois utilisations ; les coûts de maintenance dépassent les avantages.
• Recherche de la perfection : Essayer de rendre la v1 parfaite ; vous découvrirez que les besoins étaient imaginaires une fois que vous l'utiliserez réellement.

9. Liste des Pièges à Éviter

10. Écosystème et Liste Indispensable

Carte des Ressources de Skills

Liste des Skills Indispensables

11. Potentiel Commercial des Skills

Les Skills sont plus que de simples outils d'efficacité personnelle ; ils redéfinissent la façon dont les applications d'IA sont produites.

Dans le passé, développer une application d'IA verticale nécessitait des cycles longs, des coûts élevés et des équipes techniques. Maintenant :

• Seuil zéro-code : Construire des Agents verticaux sans coder.
• Validation rapide : Cycles de développement compressés de semaines à minutes.
• Service API : Emballer un Skill en tant qu'API pour renforcer des produits existants.
• Skills en tant que produits : Similaire à la vente de collections d'instructions, mais avec une valeur plus élevée.

Cas réels :

• Article-Copilot : Un seul Skill pour toute la chaîne, du nettoyage du matériel à l'écriture.
• AI Partner Skill : Donne aux Agents généralistes une mémoire profonde pour devenir de véritables compagnons.
• Interview Prep Skill : Génère des rapports complets basés sur l'entreprise/le poste/le CV. Quelqu'un a utilisé cela pour obtenir un entretien chez Hithink RoyalFlush.
• La méthode de Super Huang : Des dizaines de Skills + des tâches cron qui exécutent des rapports horaires pendant qu'il dort.

Toute personne approfondie dans un secteur peut distiller son expérience en un Skill pour gagner du temps ou le vendre comme produit.

Conclusion

Si un Agent est le corps du monde de l'IA, un Skill est l'âme qui y est injectée.

C'est comme la relation entre Steam et le Workshop ; une architecture extensible donne aux jeux une vie infinie.

Les Skills ne sont pas difficiles – ce ne sont que du Markdown avec une certaine structure. Mais la tendance qu'ils représentent est vitale : l'IA passant de « vous devez lui apprendre à chaque fois » à « vous ne lui apprenez qu'une fois ».

Et le standard est ouvert. Le Skill que vous écrivez pour Claude Code aujourd'hui peut être déplacé vers Cursor ou Gemini demain.

À ceux qui regardent encore :

Les Skills ne sont pas conçus ; ils naissent d'un travail répété.

Exécutez d'abord une chose, puis encapsulez-la. Les bons flux de travail sont itérés, pas planifiés.

Ouvrez votre terminal, installez skill-creator, et transformez ce paragraphe que vous avez répété trois fois aujourd'hui en votre premier SKILL.md.