Étendre le mode Agent avec des compétences

Les compétences vous permettent d'améliorer les capacités du mode Agent grâce à une expertise spécialisée et à des workflows personnalisés. Elles sont basées sur la norme ouverte Agent Skills.

Contrairement aux AGENTS.md fichiers, les compétences représentent une expertise à la demande. Cette structure permet au mode Agent de maintenir un grand nombre de capacités spécialisées (par exemple, la migration entre des versions spécifiques de la bibliothèque ou l'adaptation d'un composable à différentes tailles d'écran) sans encombrer la fenêtre de contexte immédiate du modèle.

Le modèle décide de manière autonome quand utiliser une compétence en fonction de votre requête et de la description de la compétence. Lorsqu'une compétence pertinente est identifiée, le modèle extrait dynamiquement l'ensemble des instructions et des ressources nécessaires pour effectuer la tâche.

Pour activer une compétence à la demande, demandez à l'agent d'effectuer une tâche pertinente pour la compétence. Vous pouvez également saisir @ dans la zone de saisie pour déclencher une compétence spécifique.

Principaux avantages

  • Expertise partagée : regroupez des workflows complexes (comme le processus d'examen des requêtes d'extraction d'une équipe spécifique) dans un dossier dédié que tout le monde peut utiliser.
  • Workflows reproductibles : assurez-vous que les tâches complexes en plusieurs étapes sont effectuées de manière cohérente en fournissant des instructions standards.
  • Regroupement des ressources : incluez des scripts, des modèles ou des exemples de données avec vos instructions afin que l'agent dispose de tout ce dont il a besoin au même endroit.
  • Utilisation efficace de la fenêtre de contexte : pour économiser des jetons de contexte, seules les métadonnées de la compétence (nom et description) sont chargées au départ. Le fichier SKILL.md complet n'est chargé qu'à l'activation. Les fichiers compatibles dans les répertoires references/, scripts/ ou assets/ ne sont chargés dans le contexte que lorsque l'agent en a spécifiquement besoin.

Créer vos propres compétences

L'agent recherche des compétences à partir des répertoires .skills/ ou .agent/skills/ situés à la racine de votre projet. Pour créer une compétence personnalisée, procédez comme suit :

  1. Créez un répertoire pour votre compétence (par exemple, my-new-skill/).
  2. Créez un fichier SKILL.md (sensible à la casse) dans le nouveau répertoire.

Les compétences doivent respecter les règles suivantes :

  • Un répertoire par compétence : chaque compétence doit avoir son propre répertoire unique qui inclut un fichier SKILL.md et toutes les ressources supplémentaires.
  • Nesting : toutes les compétences doivent se trouver dans le répertoire .skills/ ou .agent/skills/ à la racine du projet. Toutefois, vous pouvez utiliser des sous-répertoires pour une meilleure organisation (par exemple, skills/ui-flows/<skill name>/SKILL.md ou skills/testing/<skill name>/SKILL.md).
  • Champ d'application : actuellement, seules les compétences situées dans la base de code du projet sont compatibles.

Le fichier SKILL.md utilise un bloc YAML pour les métadonnées et le Markdown standard pour les instructions.

  • name : identifiant unique de la compétence. Il doit correspondre au nom du répertoire.
  • description: explication claire de ce que fait la compétence et du moment où l'agent doit l'utiliser.
  • Corps : le corps Markdown sous le bloc YAML contient les instructions qui guident le comportement de l'agent lorsque la compétence est active.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

Consignes de format

  • Nom : 64 caractères maximum (lettres minuscules, chiffres et traits d'union uniquement).
  • Description : 1 024 caractères maximum.
  • Contenu du corps : visez entre 10 000 et 20 000 caractères (environ 2 500 à 5 000 jetons). Si vos instructions dépassent cette limite, envisagez de déplacer la documentation détaillée vers un fichier de ressources , comme décrit dans Répertoires de compétences facultatifs.

Répertoires de compétences facultatifs

Pour que votre fichier SKILL.md reste concis et modulaire, vous pouvez inclure des ressources supplémentaires dans les répertoires facultatifs suivants du dossier de votre compétence :

  • scripts/: contient du code exécutable (par exemple, Python ou Bash) que l'agent peut exécuter.
  • references/: contient de la documentation technique détaillée, des références d'API ou des guides spécifiques à un domaine.
  • assets/: contient des ressources statiques telles que des modèles de documents, des schémas d'interface utilisateur ou des schémas JSON.

Lorsque vous faites référence à ces fichiers dans vos instructions SKILL.md, utilisez des chemins relatifs à partir de la racine de la compétence. Par exemple : Run the script at scripts/cleanup.py.