Skills

Les skills sont des ressources réutilisables, basées sur le système de fichiers, qui donnent à votre agent une expertise spécifique à un domaine : des flux de travail, du contexte et des bonnes pratiques qui transforment un agent généraliste en spécialiste. Chaque skill que vous ajoutez entraîne un coût modeste sur la « context window » (fenêtre de contexte) de la session, en ajoutant des instructions et des métadonnées qui aident le modèle à utiliser le skill. Apprenez-en plus dans la vue d'ensemble des Agent Skills.

Vous pouvez attacher deux types de skill. Les deux fonctionnent de la même manière : votre agent les invoque automatiquement lorsqu'ils sont pertinents pour la tâche.

• Skills pré-construits d'Anthropic : Tâches documentaires courantes telles que la gestion de PowerPoint, Excel, Word et PDF (pptx, xlsx, docx, pdf).
• Skills personnalisés : Skills que vous créez et téléversez dans votre espace de travail.

Pour apprendre à créer des skills personnalisés, consultez Agent Skills et Bonnes pratiques de création de skills. Pour téléverser un skill personnalisé dans votre espace de travail, consultez Créer un skill personnalisé.



Créer un skill personnalisé

Un skill personnalisé est un répertoire contenant un fichier SKILL.md ainsi que tous les fichiers de support, téléversé dans votre espace de travail sous forme d'archive zip ou de fichiers individuels. La création du skill renvoie l'ID skill_* que vous référencez lorsque vous l'attachez à un agent. Les skills pré-construits d'Anthropic sont déjà disponibles dans chaque espace de travail et ne nécessitent pas cette étape. Pour utiliser uniquement des skills pré-construits, passez directement à Attacher des skills à un agent.

Lorsque vous appelez directement l'API Skills avec cURL, passez explicitement l'en-tête anthropic-beta: skills-2025-10-02. La CLI et les SDK l'envoient automatiquement.

Ces exemples omettent le champ optionnel display_title, de sorte que le titre du skill est dérivé de SKILL.md. Un display_title passé explicitement doit être unique parmi les skills personnalisés de votre espace de travail.

ant beta:skills create \
  --file example_skill.zip

Pour lister, récupérer, supprimer et versionner des skills personnalisés, consultez Gestion des skills personnalisés. Pour les schémas complets de requête et de réponse, consultez la référence de l'API Create Skill. Les bundles de skills sont téléversés directement vers l'API Skills plutôt que via l'API Files.



Attacher des skills à un agent

Attachez des skills lors de la création d'un agent. Chaque session prend en charge jusqu'à 500 skills au total, comptés sur l'ensemble des agents de la session (consultez Orchestration multi-agents).

Chaque entrée du tableau skills utilise les champs suivants :

ant beta:agents create <<'YAML'
name: Financial Analyst
model: claude-opus-5
system: You are a financial analysis agent.
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_01AbCdEfGhIjKlMnOpQrStUv
    version: latest
YAML



Prochaines étapes