Skills

Les « skills » (compétences) 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 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 d'accompagnement, 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'ID 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.

L'API Skills ne nécessite pas d'en-tête bêta. Les requêtes qui envoient encore anthropic-beta: skills-2025-10-02 continuent de fonctionner et renvoient les champs de réponse antérieurs.

Ces exemples omettent le champ facultatif display_name, de sorte que le nom d'affichage de la skill est dérivé du champ name dans SKILL.md. Un display_name explicite peut comporter jusqu'à 255 caractères et n'a pas besoin d'être unique au sein de votre espace de travail.

ant 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 se téléversent 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, comptées comme l'ensemble dédupliqué sur tous les agents de la session (voir Orchestration multi-agents).

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

ant beta:agents create < agent.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



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 dans le sandbox de chaque skill découverte, et lit le SKILL.md de la skill lorsqu'une tâche correspond, y compris tous les scripts et ressources fournis avec la skill. La découverte repose sur l'outil read de l'agent issu du jeu d'outils de l'agent, qui est activé par défaut ; un agent dont 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 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 tout de même apparaître lorsque l'agent lit des fichiers sous 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éder à GitHub ; mount_path est facultatif et vaut par défaut /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éder à 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 aux côtés 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