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 le 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és se déclinent en deux types. Tous les skills fonctionnent de la même manière : votre agent les invoque automatiquement lorsqu'ils sont pertinents pour la tâche.

• Skills Anthropic pré-construits : 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 d'accompagnement, 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.

Ces exemples omettent le champ facultatif display_name, de sorte que le nom d'affichage du 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 apply skills/pr-summary

---
name: pr-summary
description: Summarize a pull request's changes and risks in the team's review format.
---

# PR summary

List what changed, why, and anything a reviewer should look at closely, in three short sections.

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, comptés 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 apply agent.md

---
name: Financial Analyst
model: claude-opus-5-5
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_01AbCdEfGhIjKlMnOpQrStUv
    version: latest
---

You are a financial analysis agent.

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 y est trouvé 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écouvert, et lit le SKILL.md du skill lorsqu'une tâche correspond, y compris tous les scripts et ressources fournis avec le 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 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 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 disposition 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és 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 = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    resources=[
        {
            "type": "github_repository",
            "url": "https://github.com/org/repo",
            "mount_path": "/workspace/repo",
            "authorization_token": "ghp_your_github_token",
        },
    ],
)

Pour les dépôts privés, l'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écouverts 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 mis à jour, démarrez une nouvelle session.

Les skills de dépôt fonctionnent aux côtés des skills attachés via le tableau skills de l'agent. Si un skill de dépôt partage un nom avec un skill attaché, ou avec un skill d'un autre dépôt monté, les deux sont disponibles ; chacun est annoncé avec son propre chemin.

Étapes suivantes