Comment créer et utiliser les compétences Claude ? Guide détaillé de 3 méthodes !

CometAPI
AnnaOct 21, 2025
Comment créer et utiliser les compétences Claude ? Guide détaillé de 3 méthodes !

Le nouveau de Claude communication Cette fonctionnalité, récemment déployée par Anthropic, permet aux équipes et aux développeurs d'enseigner à Claude des compétences reproductibles et partageables : imaginez des « boîtes à outils » compactes et versionnées (dossiers contenant des instructions, des scripts et des ressources) qui permettent à Claude d'effectuer de manière fiable des tâches spécifiques à son domaine, comme la création de diapositives à l'image de la marque, la création de classeurs Excel avec des formules ou l'exécution sécurisée de petits extraits de code. Cet article explique quelles sont les compétences et pourquoi sont-elles importantes, donne ensuite un guide pratique, étape par étape, pour utiliser Skills de trois manières : dans les applications Web de Claude (le chemin sans code), dans Claude Code (style IDE développeur), et via le ClaudeAPI (intégration programmatique). Nous terminerons par la sécurité, la comparaison avec d'autres modèles d'agent, les bonnes pratiques et des conseils de dépannage.

Que sont exactement les compétences Claude et quels avantages apportent-elles ?

Définition courte : A Compétence Il s'agit d'un dossier/package autonome regroupant des instructions, des scripts, des ressources et, éventuellement, des assistants exécutables que Claude peut charger dynamiquement lorsqu'une tâche correspond aux déclencheurs de la compétence. En pratique, une compétence agit comme une « capacité » réutilisable et versionnée qui apprend à Claude comment effectuer une classe de tâches spécifique (par exemple, formater des feuilles de calcul selon les normes de votre entreprise, appliquer les chartes graphiques aux présentations, générer des rapports selon un modèle réglementé).

Éléments essentiels d'une compétence (ce que vous trouverez généralement)

  • manifest / metadata — nom, version, déclencheurs, autorisations.
  • instructions.md — marches hautes, garde-corps, exemples.
  • handlers or scripts — code réel pour générer des fichiers, appeler des outils internes ou transformer des données.
  • resources/ — modèles, guides de style, exemples de données.
  • tests/ — des tests automatisés utilisés pour valider une compétence.

Quelles capacités les Compétences ajoutent-elles à Claude ?

  • Instructions personnalisées et ensembles de contenu : Les compétences peuvent inclure des instructions écrites, des modèles et des fichiers de ressources (guides de style, CSV, etc.) que Claude utilise comme contexte faisant autorité.
  • Composants exécutables (outil d'exécution de code) : Les compétences peuvent inclure des scripts ou du code exécutés dans le conteneur d'exécution de code d'Anthropic pour des opérations déterministes (analyse de fichiers, calculs numériques, transformations de données). Cela permet de décharger des tâches qui seraient coûteuses ou peu fiables si elles se limitaient à la génération de jetons.
  • Activation automatique et utilisation sélective : Claude peut sélectionner et invoquer automatiquement les compétences pertinentes lorsque la demande de l'utilisateur correspond à la portée de la compétence, et il peut expliquer pourquoi il a choisi une compétence.
  • Contrôle de version et de programmation : Les compétences sont des objets API de première classe : vous pouvez télécharger, gérer les versions et référencer skill_ids de l'API Claude. Cela permet des workflows de type CI et une gouvernance des mises à jour.
  • Répartition entre les points de terminaison : Les compétences s'appliquent à l'ensemble de la gamme de produits de Claude — les applications Web, Claude Code et le SDK API/Agent d'Anthropic — permettant à la fois la productivité de l'utilisateur final et l'automatisation des développeurs.

Comment puis-je utiliser Claude Skills dans les applications Web Claude (Claude.ai) ?

J'ai besoin de prérequis : (1) Vous devez disposer d'un forfait Claude payant prenant en charge les Compétences (Pro, Max, Équipe ou Entreprise au lancement). La disponibilité et les contrôles d'administration varient selon le forfait et les paramètres de l'organisation. (2) Accédez aux Paramètres et à la fonctionnalité « Compétences » dans votre espace de travail (Paramètres → Compétences → Compétences). Les administrateurs peuvent être amenés à activer la création de compétences ou à limiter l'installation aux compétences approuvées.

Guide étape par étape pour créer et utiliser des compétences dans Claude Apps Web :

Étape 1 : Explorez les exemples intégrés et activez les compétences

Ouvrez Claude.ai → Paramètres → Capacités → Compétences. Activez l'aperçu/l'exemple de compétences pour visualiser leur structure et leur activation. C'est le moyen le plus rapide de comprendre l'apparence et le fonctionnement des compétences.

Étape 2 : Utiliser l'interface utilisateur du créateur de compétences (première compétence)

Anthropic a déployé un créateur de compétences guidé à l'intérieur des applications : choisissez Créer une compétence Pour lancer un assistant qui vous demande ce que vous souhaitez que la compétence fasse, fournit une structure de dossier par défaut (README, fichiers d'instructions, exemples de modèles, éventuellement un script) et vous aide à rédiger des instructions et des déclencheurs de base. Utilisez le harnais de test intégré pour valider le comportement avec des exemples d'invite.

Étape 3 : Définir l’intention, les exemples et les ressources de la compétence

  • Modèles/ressources : Ajoutez des modèles, des exemples CSV, des spécifications de conception ou des dictionnaires d'entités auxquels la compétence doit faire référence.
  • Intention / description : Rédigez une description courte et explicite de ce à quoi sert la compétence (cela aide Claude à la faire correspondre).
  • Signaux d'activation / déclencheurs : Ajoutez des mots-clés ou des exemples d’invites qui devraient inciter Claude à charger la compétence.
  • Fichiers d'instructions : Placez des instructions stables (par exemple, le ton de la marque, les sections requises) dans un seul fichier canonique à l'intérieur de la compétence.

Étape 4 : Téléchargez et chargez la compétence

Une fois satisfait, Claude compresse la compétence dans un fichier ZIP. Dans la barre latérale gauche, cliquez sur « Capacités ».

Comment créer et utiliser les compétences Claude ? Guide détaillé de 3 méthodes !

Vous pouvez également glisser-déposer le fichier ZIP dans la zone de téléchargement. Claude le valide et l'installe, confirmant ainsi son activation.

Étape 5 : Utiliser les compétences lors de conversations réelles

Après avoir enregistré, essayez des invites naturelles correspondant aux déclencheurs de la compétence (ou mentionnez la compétence par son nom). L'application indiquera quand elle a chargé une compétence et pourra afficher les ressources utilisées ; exécutez quelques itérations et affinez les instructions jusqu'à ce que les résultats soient fiables. Lorsqu'un utilisateur demande à Claude d'effectuer la tâche correspondante, Claude peut détecter et charger automatiquement la compétence correspondante, ou vous pouvez l'invoquer explicitement. Les instructions, les modèles et le code de la compétence guident les résultats de Claude.

Conseils pour Claude Apps Web

  • Le système comprend des compétences intégrées pour les tâches courantes, telles que : Génération de documents ; Création de rapports ; Présentation PowerPoint ; Calcul de formules Excel.
  • Les utilisateurs peuvent personnaliser directement leurs propres compétences.
  • Claude invoque automatiquement les compétences pertinentes, éliminant ainsi le besoin de sélection manuelle.
  • Pendant le processus de raisonnement de Claude, les utilisateurs peuvent voir quelles compétences sont invoquées.
  • Privilégiez d’abord les tâches non exécutables.** Les compétences Web qui spécifient uniquement des instructions (pas de code) sont plus faciles à auditer.

Comment puis-je utiliser Claude Skills dans Claude Code ?

Conditions

  • Accès au code ClaudeClaude Code est l'interface d'assistance IDE/terminal d'Anthropic, souvent incluse dans les offres de développement ou accessible via une extension ou une place de marché. Certaines fonctionnalités de Skill nécessitent l'accès à l'outil d'exécution de code ou à l'ADK (kit de développement d'agent). CometAPI donne accès au code Claude et à l'API Claude. Vous pouvez utiliser les compétences du code Claude de CometAPI et les consulter. Documentation en utilisant le code Claude.
  • Environnement de développement local:Si une compétence inclut des suites de tests ou du code, vous souhaiterez cloner le référentiel de compétences et exécuter des tests localement.

Guide étape par étape pour créer et utiliser des compétences dans Claude Code

Étape 1 : Créer une structure de dossiers de compétences :

Dans Claude Code, les compétences se présentent généralement sous forme de dossiers contenant un manifeste (métadonnées), des fichiers d'instructions, des entrées de test, des scripts d'aide (Python/JS) et des binaires ou des modèles :

  1. Définir le manifeste de compétence:Le manifeste comprend skill_id, nom, description, auteur, dépendances, points d'entrée et notes de sécurité. Cela indique à Claude Code comment et quand charger la compétence.
  2. Implémenter des scripts d'aide et des tests:Si votre compétence utilise du code pour transformer ou générer des fichiers, ajoutez de petits scripts bien définis et des tests unitaires qui s'exécutent dans l'environnement d'exécution de code.

Étape 2 : Installer ou ajouter un package de compétences

  • Dans Claude Code, ouvrez le panneau plugin/marketplace et add anthropics/skills (ou le référentiel de compétences spécifique).
  • Vous pouvez également cloner un référentiel de compétences dans votre espace de travail.

Comment créer et utiliser les compétences Claude ? Guide détaillé de 3 méthodes !

Sélectionnez « Compétences de l'agent anthropique »,

Compétences de l'agent anthropique

Choisissez ensuite « document-skills » (pour la génération de fichiers) ou « example-skills » (pour les démonstrations). Pour ce tutoriel, choisissez « document-skills » : il vous présentera des fonctionnalités comme la création de documents Word. Cliquez sur « Installer » ; Claude Code télécharge et enregistre les compétences.

Étape 3 : Créer des gestionnaires de code avancés

  • Implémentez des gestionnaires qui opèrent sur des fichiers ou appellent des outils externes (par exemple, générer .pptx avec python-pptx, créer .xlsx avec openpyxl).
  • Si la compétence nécessite l'exécution de code à distance, assurez-vous qu'elle est conforme au modèle de conteneur d'Anthropic (les documents API décrivent comment les compétences utilisent les conteneurs pour les exécutions de code).

Étape 4 : Charger et tester dans Claude Code

  • Démarrez une session Claude Code et demandez à Claude d'exécuter votre compétence (par exemple, « Utiliser la compétence ReportGen pour créer des diapositives de revenus du troisième trimestre »).
  • Observez les journaux, les sorties et tous les artefacts générés dans l'espace de travail.

Étape 5 : Emballer et publier

Enregistrez la compétence dans le registre de compétences de votre organisation ou transférez-la vers un dépôt GitHub approuvé. Utilisez des balises de version et incluez des suites de tests pour la gouvernance.

Conseils pour Claude Code

  • Traitez les compétences comme des projets de code: utilisez CI pour exécuter des tests de compétences lorsque le code ou les modèles changent.
  • Isoler les effets secondaires: si une compétence peut exécuter des scripts, exécutez-les dans des conteneurs jetables ou des bacs à sable pour éviter les fuites de données accidentelles.
  • Documenter clairement les entrées/sorties afin que les coéquipiers non développeurs puissent utiliser la compétence dans l'application Web ultérieurement.

Comment puis-je utiliser Claude Skills dans l'API Claude ?

Conditions

Accès à Anthropic API de messages grâce à la fonction outil d'exécution de code Activé (les compétences s'intègrent à l'API Messages via un paramètre de conteneur). Vous aurez également besoin des identifiants d'API et des autorisations d'exécution nécessaires pour exécuter le code de compétence dans les conteneurs.

Guide étape par étape pour créer et utiliser une compétence via l'API :

Étape 1 : Préparer le package de compétences localement

Créez un dossier Skill respectant le format de manifeste attendu de l'API (nom, version, fichiers d'instructions, déclencheurs, chemins de ressources facultatifs et scripts d'aide). La documentation d'Anthropic fournit le schéma et des exemples.

Étape 2 : Télécharger ou enregistrer la compétence

Compétence gérée par l'anthropologie : référence à la skill_id et une version facultative dans votre appel d'API (aucun téléchargement nécessaire). Utilisez votre clé API pour authentifier et appeler le point de terminaison de création de compétence (par exemple, un POST /v1/skills ou un point final similaire.

curl -X POST "https://api.anthropic.com/v1/skills" \  
-H "x-api-key: $ANTHROPIC_API_KEY" \  
-H "anthropic-version: 2023-06-01" \  
-H "anthropic-beta: skills-2025-10-02" \  
-F "display_title=My Excel Skill" \  
-F "files=@excel-skill/process_excel.py;filename=excel-skill/process_excel.py"

Téléchargez la charge utile de la compétence ou pointez l'API vers un artefact compressé. L'API validera et stockera la compétence pour votre espace de travail.

Quelle que soit la source, les compétences sont intégrées à l'API de messagerie de la même manière. Vous pouvez spécifier la version de la compétence à l'aide des paramètres skill_id, type et, éventuellement, skill_version, qui seront exécutés dans l'environnement d'exécution de code :

AspectCompétences anthropiquesCompétences personnalisées
Valeur de typeanthropiccustom
Identifiants de compétencesNoms courts : pptxxlsxdocxpdfGénéré: skill_01AbCdEfGhIjKlMnOpQrStUv
Format de versionBasé sur les dates : 20251013 or latestHorodatage de l'époque : 1759178010641129 or latest
la directionPré-construit et maintenu par AnthropicTélécharger et gérer via Skills API
DisponibilitéDisponible pour tous les utilisateursPrivé à votre espace de travail

Étape 3 : Appeler l’API Messages avec un paramètre de conteneur

Dans votre demande d'API Messages, incluez un container champ spécifiant le skill_id, type (anthropic or custom), et éventuellement versionLe point de terminaison Messages achemine l’exécution vers l’environnement de code dans lequel la compétence s’exécute.

Exemple (conceptuel) :

   {
     "model": "claude-sonnet-4-5-20250929",
     "messages": }],
     betas=,
     "container": {"type":"custom","skill_id":"skill_01AbCdEf","version":"latest"}
   }

Étape 4 : Téléchargement des fichiers générés

Lorsqu'une compétence crée un document (Excel, PowerPoint, PDF, Word), elle renvoie une propriété file_id dans la réponse. Vous devez utiliser l'API Fichier pour télécharger ces fichiers :

def extract_file_ids(response):
file_ids = []
for item in response.content:
if item.type == 'bash_code_execution_tool_result':
content_item = item.content
if content_item.type == 'bash_code_execution_result':
for file in content_item.content:
if hasattr(file, 'file_id'):
file_ids.append(file.file_id)
return file_ids

for file_id in extract_file_ids(response):
file_metadata = client.beta.files.retrieve_metadata(
file_id=file_id,
betas=
)
file_content = client.beta.files.download(
file_id=file_id,
betas=
)

file_content.write_to_file(file_metadata.filename)
print(f"Downloaded: {file_metadata.filename}")

Conseils d'utilisation de l'API

  • Privilégier les compétences gérées par l'anthropique pour les formats courants (pptx/xlsx/docx) pour éviter de réinventer la roue.
  • Utilisez le champ version. Épinglez une version de compétence en production pour éviter un comportement inattendu.
  • Mettre en place des garde-fous dans votre système : désinfectez les entrées, limitez la taille des fichiers et effectuez des validations post-génération avant d'exposer les artefacts en externe.

Pourquoi utiliser Claude Skills — quels sont les avantages et les inconvénients ?

avantages.

  • Cohérence et qualité : Les compétences codent les meilleures pratiques organisationnelles (règles de marque, formulation juridique), de sorte que les résultats sont cohérents et réduisent les reprises manuelles.
  • Productivité: L'automatisation des tâches répétables (préparation des données, création de diapositives, application de modèles) raccourcit les cycles : les premiers clients ont signalé des délais de production plus rapides lors des essais bêta.
  • Réutilisabilité et gouvernance : Les compétences deviennent des artefacts versionnés qui peuvent être examinés, testés et déployés comme des logiciels, simplifiant ainsi les audits et la conformité.
  • Coût de jeton/calcul inférieur pour les flux complexes : Étant donné que Claude charge uniquement les parties pertinentes d'une compétence lorsque cela est nécessaire, vous pouvez éviter d'envoyer systématiquement de longues invites système, réduisant ainsi les coûts et le gonflement du contexte.

limites:

  • Travail en amont : Développer des compétences solides nécessite de la conception, de la documentation et des tests : vous échangez l'ingénierie rapide contre l'ingénierie produit.
  • Risque exécutable : Les compétences qui exécutent du code ou accèdent aux données augmentent la surface de sécurité ; les entreprises doivent limiter qui publie et approuve les compétences exécutables.
  • Disponibilité du plan et des fonctionnalités : Les compétences ont été déployées sur les forfaits Pro, Max, Team et Enterprise dès l'annonce. Les utilisateurs de la version gratuite peuvent ne pas avoir accès aux compétences par défaut. Vérifiez votre forfait.

Comment Claude Skills se compare-t-il aux autres plateformes et modèles d'agents ?

Compétences = artefacts plus riches et versionnés.** Elles sont plus structurées que les appels d'outils ou les modèles ponctuels : les compétences regroupent les instructions, les ressources, les scripts et les manifestes dans un package réutilisable. Elles se rapprochent ainsi davantage d'un micro-agent déployable que d'une simple invocation d'outil.

Compétences vs. invites système ad hoc et bibliothèques d'invites

Les invites système sont éphémères et doivent être fournies à chaque session. Les compétences sont persistantes, versionnées et gérées de manière centralisée. Elles sont donc plus performantes pour l'évolutivité et la reproductibilité de l'entreprise.

Agents basés sur des compétences ou des outils (appels d'outils / appels de fonctions)

Les agents basés sur des outils (par exemple, les modèles d'appel de fonctions) visent à doter les modèles de capacités externes concrètes (API, invocation d'outils). Les compétences combinent instructions + ressources + aides facultatives et sont destinés à enseigner le modèle how pour effectuer une tâche (y compris quand utiliser des outils). En bref : les outils sont actionneurs; Les compétences codifient les procédures et les politiques qui peuvent utiliser des outils.

Compétences par rapport à AgentKit d'OpenAI et aux frameworks d'agents similaires

Les lancements récents (par exemple lors de l'OpenAI DevDay) mettent l'accent sur les agents packagés et les boîtes à outils pour développeurs permettant de passer du prototype à la production. Claude Skills joue un rôle similaire, mais en mettant l'accent sur instructions et ressources sous forme de dossiers et une intégration croisée étroite entre les applications Claude, le code et les API. Les deux approches convergent : toutes deux visent à activer les agents de production, mais les détails d'implémentation (API SDK, contrôles de gouvernance, modèles de marketplace) diffèrent. Si vous utilisez déjà un framework d'agents, les compétences peuvent souvent être les « modules de capacités » que vous chargez dans ces agents.

Quand choisir Skills plutôt qu'un agent personnalisé ?

  • Utiliser les compétences lorsque vous avez besoin de fonctionnalités standardisées, partageables et à faible friction entre les utilisateurs et les interfaces utilisateur (les non-développeurs en bénéficient).
  • Utilisez des agents personnalisés lorsque Vous avez besoin d'une orchestration multi-outils complexe avec une logique de contrôle sur mesure, en dehors du modèle d'exécution des compétences de Claude. Les compétences sont excellentes pour les tâches de domaine bien organisées ; les agents sont adaptés à une orchestration lourde.

Là où d'autres modèles gagnent encore

  • Tâches légères à faible latence:Pour les petites tâches ou lorsque vous n'avez pas besoin de sorties reproductibles, les appels de fonctions ou les invites système sont toujours plus simples.
  • Écosystèmes d'outils personnalisés:Si vous disposez déjà d'une infrastructure d'outils personnalisés importante exposée via des API, les appels de fonctions/plugins intégrés aux couches d'orchestration peuvent être plus adaptés.

Exemples et recettes pratiques et concrets

Exemple 1 — Formateur de diapositives de marque (compétence d'application Web)

  • Ce qu'il fait: Convertit les puces de diapositives brutes en diapositives de marque d'entreprise (polices, ton, ordre des diapositives).
  • Créer dans l'application Web : Utiliser le créateur de compétences → ajouter un guide de style de marque, un modèle de diapositive et un exemple d'entrée/sortie. Activer pour l'équipe de conception. Tester en demandant : « Formater ces notes avec le formateur de diapositives de marque ».

Exemple 2 — Auditeur de données CSV (compétence Claude Code)

  • Ce qu'il fait: Valide les colonnes de données CSV, exécute des vérifications Python légères (valeurs manquantes, incompatibilités de type) et renvoie un rapport récapitulatif.
  • Créer dans le code : Développez vos compétences avec validators.py Aide, tests unitaires et exemples de fichiers CSV. Testez de manière itérative dans le carnet de Claude Code, puis empaquetez et publiez.

Exemple 3 — Assistant Redline de contrat (compétence API)

  • Ce qu'il fait: Applique les normes juridiques de l'entreprise au texte du contrat et produit une ligne rouge et une justification.
  • Créer via l'API : Fichiers d'instructions de l'auteur et bibliothèque de clauses, téléchargement via POST /skills, puis appelez depuis votre système de gestion des contrats avec skill_id pour produire des sorties redline standardisées.

Conclusion

Les compétences Claude constituent une passerelle pratique entre les instructions ad hoc et l'ingénierie d'agents complète : elles permettent aux équipes de s'approprier le savoir-faire institutionnel, de garantir le style et la sécurité, et d'automatiser les tâches récurrentes sur l'interface utilisateur et les interfaces programmatiques. Que vous soyez un chef de produit non technique utilisant le créateur de compétences web, un ingénieur proposant des outils de développement reproductibles dans Claude Code ou une équipe plateforme intégrant des compétences à des applications via l'API Messages, l'application de pratiques simples et rigoureuses (versioning, tests, moindre privilège et déploiements par étapes) garantira la fiabilité et l'auditabilité de vos compétences en production.

Pour commencer

CometAPI est une plateforme d'API unifiée qui regroupe plus de 500 modèles d'IA provenant de fournisseurs leaders, tels que la série GPT d'OpenAI, Gemini de Google, Claude d'Anthropic, Midjourney, Suno, etc., au sein d'une interface unique et conviviale pour les développeurs. En offrant une authentification, un formatage des requêtes et une gestion des réponses cohérents, CometAPI simplifie considérablement l'intégration des fonctionnalités d'IA dans vos applications. Que vous développiez des chatbots, des générateurs d'images, des compositeurs de musique ou des pipelines d'analyse pilotés par les données, CometAPI vous permet d'itérer plus rapidement, de maîtriser les coûts et de rester indépendant des fournisseurs, tout en exploitant les dernières avancées de l'écosystème de l'IA.

CometAPI donne accès au code Claude et à l'API Claude. Vous pouvez utiliser les compétences du code Claude de CometAPI et le consulter. Documentation en utilisant le code Claude.

Pourquoi utiliser le code claude via CometAPI ?

Principales fonctionnalités de l'intelligence artificielle : générez, déboguez et optimisez facilement le code à l'aide de modèles conçus spécifiquement pour les développeurs.

  • Sélection de modèles flexible : notre gamme complète de modèles vous permet de développer de manière plus fluide.
  • Intégration transparente : les API sont toujours disponibles. Intégrez Claude Code directement à votre workflow existant en quelques minutes.
  • L'utilisation de Claude Code via CometAPI permettra de réduire davantage les coûtsL'API Claude fournie par CometAPI bénéficie d'une réduction de 20 % sur le prix officiel et est mise à jour avec le dernier modèle par l'autorité officielle. Le dernier modèle est API Claude Haiku 4.5.

Prêt à partir ?→ Inscrivez-vous à CometAPI dès aujourd'hui !

Si vous souhaitez connaître plus de conseils, de guides et d'actualités sur l'IA, suivez-nous sur VKX et Discord!

SHARE THIS BLOG

500+ Modèles en Une API

Jusqu'à 20% de réduction