Skills

Les « skills » (compétences) sont des ressources réutilisables basées sur le système de fichiers qui confèrent à votre agent une expertise spécifique à un domaine : des workflows, du contexte et des bonnes pratiques qui transforment un agent généraliste en spécialiste. Contrairement aux prompts (instructions au niveau de la conversation pour des tâches ponctuelles), les skills se chargent à la demande et n'affectent la « context window » (fenêtre de contexte) que lorsque cela est nécessaire.

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

• Skills Anthropic préconfigurées : tâches documentaires courantes telles que la gestion de fichiers PowerPoint, Excel, Word et PDF (pptx, xlsx, docx, pdf).
• Skills personnalisées : skills que vous créez et téléversez dans votre espace de travail.

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



Créer une skill personnalisée

Une skill personnalisée 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 de la skill renvoie l'identifiant skill_* que vous référencez lorsque vous l'attachez à un agent. Les skills préconfigurées d'Anthropic sont déjà disponibles dans chaque espace de travail et ne nécessitent pas cette étape. Pour utiliser uniquement des skills préconfigurées, passez directement à Attacher des skills à un agent.

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

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

ant beta:skills create \
  --file example_skill.zip \
  --beta skills-2025-10-02

Pour lister, récupérer, supprimer et versionner des skills personnalisées, consultez Gestion des skills personnalisées. 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'à 20 skills au total, comptabilisées sur l'ensemble des agents de la session (voir Sessions multi-agents).

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

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



Étapes suivantes