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 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 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 lors de son attachement à un agent. Les skills préconstruits 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.

L'API Skills ne nécessite pas d'en-tête bêta. L'exemple cURL envoie toujours anthropic-beta: skills-2025-10-02, et les commandes beta de la CLI et du SDK l'ajoutent automatiquement ; les requêtes qui l'incluent continuent de fonctionner sans modification.

Ces exemples omettent le champ facultatif 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, comptabilisés 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 < 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écouvert, et lit le fichier 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 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é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ès à 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 ; voir Accès à 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 en parallèle 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 provenant d'un autre dépôt monté, les deux sont disponibles ; chacun est annoncé avec son propre chemin.



Étapes suivantes