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. 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 la skill. Pour en savoir plus, consultez la présentation des Agent Skills.

Les skills parviennent à votre agent de deux manières : attachez-les via le tableau skills de l'agent, ou chargez-les depuis un dépôt GitHub monté sur la session. Les skills attachées se déclinent en deux types. Toutes les skills fonctionnent de la même manière : votre agent les invoque automatiquement lorsqu'elles sont pertinentes pour la tâche.

• Skills Anthropic préconstruites : Tâches documentaires courantes telles que la gestion de 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éconstruites d'Anthropic sont déjà disponibles dans chaque espace de travail et ne nécessitent pas cette étape. Pour utiliser uniquement des skills préconstruites, 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 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

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'à 500 skills, comptabilisées comme l'ensemble dédupliqué de tous les agents de la session (voir 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



Charger des skills depuis un dépôt GitHub

Les skills peuvent également résider dans votre base de code. Lorsqu'une session monte un dépôt via la ressource github_repository, le répertoire racine .claude/skills du dépôt est analysé au démarrage de la session, et chaque skill qui s'y trouve devient disponible pour l'agent. Aucun téléversement ni aucune entrée dans le tableau skills de l'agent ne sont requis. L'agent voit le nom, la description et le chemin de chaque skill découverte dans le sandbox, et lit le fichier SKILL.md de la skill lorsqu'une tâche correspond, y compris tous les scripts et ressources que la skill embarque. La découverte repose sur l'outil read de l'agent issu de la boîte à outils de l'agent, qui est activé par défaut ; un agent dont l'outil read est désactivé ne charge pas les skills du dépôt.

La découverte trouve les skills exactement à l'emplacement .claude/skills/<skill-name>/SKILL.md, à un seul niveau de répertoire de profondeur à la racine du dépôt :

your-repo/
├── .claude/
│   └── skills/
│       ├── code-review/
│       │   └── SKILL.md
│       └── release-process/
│           ├── SKILL.md
│           └── scripts/
│               └── run_checks.sh
└── src/

Les emplacements qui ne correspondent pas à cette structure ne sont pas découverts au démarrage de la session :

• .claude/skills/SKILL.md : un SKILL.md sans répertoire de skill autour de lui
• .claude/skills/tools/code-review/SKILL.md : imbriqué à plus d'un niveau de répertoire de profondeur
• skills/code-review/SKILL.md : un répertoire skills en dehors de .claude

Un répertoire .claude/skills situé ailleurs dans le dépôt, par exemple à l'intérieur d'un sous-répertoire de package, n'est pas annoncé au démarrage de la session ; ces skills peuvent néanmoins apparaître lorsque l'agent lit des fichiers dans cette sous-arborescence.

Les skills de dépôt utilisent le même format SKILL.md que les skills personnalisées que vous téléversez. Pour le format et les conseils de création, consultez Agent Skills et Bonnes pratiques de création de skills.

Pour charger des skills depuis un dépôt, créez une session qui le monte. Il s'agit de la même requête que celle présentée dans Accès à GitHub ; mount_path est facultatif et sa valeur par défaut est /workspace/<repo-name> :

SESSION_ID=$(ant beta:sessions create \
  --agent "$AGENT_ID" \
  --environment-id "$ENVIRONMENT_ID" \
  --transform id --raw-output <<'EOF'
resources:
  - type: github_repository
    url: https://github.com/org/repo
    mount_path: /workspace/repo
    authorization_token: ghp_your_github_token
EOF
)

Pour les dépôts privés, le authorization_token de la ressource doit avoir accès au dépôt. Il s'agit du même flux de jeton d'accès personnel utilisé pour tout montage de dépôt ; consultez Accès à GitHub.

Les skills découvertes suivent l'état extrait du dépôt : la branche ou le commit checkout lorsque la ressource en définit un, sinon la branche par défaut du dépôt. L'analyse s'exécute une seule fois, au démarrage de la session. Les commits poussés en cours de session ne sont pas pris en compte ; pour charger des skills mises à jour, démarrez une nouvelle session.

Les skills de dépôt fonctionnent en parallèle des skills attachées via le tableau skills de l'agent. Si une skill de dépôt partage un nom avec une skill attachée, ou avec une skill d'un autre dépôt monté, les deux sont disponibles ; chacune est annoncée avec son propre chemin.



Étapes suivantes