Utiliser les compétences de l’agent avec GitHub Copilot

Les compétences de l'agent sont des ensembles réutilisables d'instructions qui enseignent aux agents Copilot comment effectuer des tâches spécifiques, telles que l'exécution d'un pipeline de build, la génération de code standard ou le suivi des normes de codage de votre équipe. En définissant des compétences une seule fois, vous gagnez du temps et assurez un comportement cohérent dans votre flux de travail.

Les compétences complètent les agents personnalisés et les instructions personnalisées. Alors que les agents personnalisés définissent un persona et un ensemble d’outils et des instructions personnalisées définissent des préférences de codage générales, les compétences fournissent des conseils spécifiques aux tâches que n’importe quel agent peut découvrir et utiliser automatiquement.

Prerequisites

Fonctionnement des compétences de l’agent

Lorsque vous utilisez modeagent, Copilot découvre automatiquement les compétences de votre référentiel et de votre profil utilisateur. L’agent décide quand une compétence est pertinente pour votre demande et l’active. Lorsqu’une compétence est activée, elle apparaît dans la conversation pour vous informer qu’elle est appliquée.

Capture d'écran qui montre une compétence utilisée par l'agent Copilot dans le chat.

Emplacements des compétences

Les compétences sont acquises dans les emplacements suivants :

Type de compétence Lieu
Compétences d’espace de travail ou de projet (stockées dans votre référentiel) .github/skills/, .claude/skills/, .agents/skills/
Compétences personnelles (stockées dans votre profil utilisateur) ~/.copilot/skills/, ~/.claude/skills/, ~/.agents/skills/

Les compétences de l’espace de travail sont partagées avec votre équipe via le contrôle de source. Les compétences personnelles s’appliquent à tous vos projets et ne sont pas enregistrées dans un dépôt.

Créer une compétence

Vous pouvez créer une compétence à partir du volet compétences dans Visual Studio, ou manuellement dans votre système de fichiers. Pour créer une compétence à partir du volet de compétences, vous devez avoir Visual Studio 2026 Insiders version 18.6 ou ultérieure.

Créer une compétence à partir du volet compétences

  1. Sélectionnez l’icône Tools dans le coin inférieur droit de Copilot Chat pour ouvrir le volet des compétences.

  2. Sélectionnez le + bouton en haut à droite du panneau.

    Capture d’écran montrant la création d’une compétence à partir du volet compétences.

  3. Choisissez une destination (compétence globale ou au niveau de la solution) et choisissez un nom.

    Capture d’écran montrant comment nommer une nouvelle compétence.

  4. Visual Studio génère un modèle de compétence à remplir. Vous pouvez utiliser assistant Copilot mode pour vous aider à terminer le modèle.

Créer une compétence manuellement

Chaque compétence est un répertoire contenant un SKILL.md fichier qui suit la spécification agentskills.io.

  1. Créez un répertoire de compétences. Pour une compétence d’espace de travail, utilisez .github/skills/ à la racine de votre référentiel. Pour une compétence personnelle, utilisez ~/.copilot/skills/.

  2. Créez un sous-répertoire pour votre compétence. Chaque compétence doit avoir son propre répertoire (par exemple). .github/skills/github-issues/

  3. Créez un SKILL.md fichier dans le répertoire des compétences. Le fichier contient un frontmatter YAML avec des métadonnées suivies d’instructions Markdown.

  4. Si vous le souhaitez, ajoutez des scripts, des exemples ou d’autres ressources au répertoire de votre compétence.

Structure du répertoire de compétences

your-repo/
└── .github/
    └── skills/
        └── github-issues/
            ├── SKILL.md          # Required: metadata + instructions
            ├── scripts/          # Optional: executable code
            ├── references/       # Optional: documentation
            └── assets/           # Optional: templates, resources

format SKILL.md

Le SKILL.md fichier doit contenir un frontmatter YAML suivi du contenu Markdown :

---
name: github-issues
description: Creates and manages GitHub issues following team conventions. Use when working with issue tracking, bug reports, or feature requests.
---

When creating GitHub issues:

- Use the standard title format: [Component] Brief description
- Add appropriate labels based on issue type
- Include reproduction steps for bug reports
- Link related issues and PRs

Propriétés du frontmatter

Propriété Obligatoire Description
name Oui Lettres minuscules, chiffres et traits d’union uniquement. Doit correspondre au nom du répertoire parent. Maximum 64 caractères.
description Oui Décrit ce que fait la compétence et quand l’utiliser. 1 024 caractères maximum.
license Non Nom de la licence ou référence à un fichier de licence groupé.
compatibility Non Configuration requise pour l’environnement, telle que le produit prévu ou les packages système requis.
metadata Non Mappage arbitraire clé-valeur destiné à des métadonnées supplémentaires.
allowed-tools Non Chaîne de caractères délimitée par des espaces contenant les outils préapprouvés que la compétence peut exploiter.

Conseils pour l’écriture de compétences efficaces

  • Assurez-vous que le fichier SKILL.md principal ne dépasse pas 500 lignes. Déplacez le matériel de référence détaillé vers des fichiers séparés dans le répertoire references/.
  • Écrivez un clair description qui inclut des mots clés spécifiques pour aider les agents à identifier quand la compétence est pertinente.
  • Incluez des instructions pas à pas, des exemples et des cas de périphérie courants.

Gérer les compétences à partir du panneau compétences

Sélectionnez l’icône Tools dans le coin inférieur droit de Copilot Chat pour ouvrir le volet des compétences, une vue dédiée de chaque compétence découverte. Le panneau Compétences est disponible uniquement dans les Visual Studio 2026 Insiders.

Capture d’écran montrant le panneau compétences dans lequel vous pouvez modifier et ouvrir des compétences.

Dans le panneau, vous pouvez :

  • Modifier : ouvrez les compétences directement dans l’éditeur SKILL.md à partir du menu ...
  • Ouvrez l’emplacement du fichier : accédez au répertoire des compétences sur le disque.
  • Recherche : filtrer les compétences par nom ou mot clé.

Le panneau présente également les diagnostics pour toutes les erreurs de configuration des compétences, ce qui vous permet de détecter et de résoudre rapidement les problèmes.

Compétences de la communauté

Consultez le dépôt awesome-copilot pour des exemples d'aptitudes partagées par la communauté.