{"meta":{"title":"Ajout de compétences d’agent pour GitHub Copilot","intro":"Vous pouvez modifier le comportement et les capacités de Copilot lorsqu'il effectue des tâches particulières.","product":"GitHub Copilot","breadcrumbs":[{"href":"/fr/copilot","title":"GitHub Copilot"},{"href":"/fr/copilot/how-tos","title":"Procédures"},{"href":"/fr/copilot/how-tos/copilot-on-github","title":"\n              Copilot sur GitHub"},{"href":"/fr/copilot/how-tos/copilot-on-github/customize-copilot","title":"Personnaliser Copilot"},{"href":"/fr/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent","title":"Personnaliser agent de cloud"},{"href":"/fr/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills","title":"Ajouter des compétences d’agent"}],"documentType":"article"},"body":"# Ajout de compétences d’agent pour GitHub Copilot\n\nVous pouvez modifier le comportement et les capacités de Copilot lorsqu'il effectue des tâches particulières.\n\n> \\[!NOTE]\n> Les compétences de l’agent fonctionnent avec Agent cloud Copilot, le CLI GitHub Copilot et le mode agent dans Visual Studio Code.\n\nLes compétences de l’agent sont des dossiers d’instructions, de scripts et de ressources qui Copilot peuvent être chargés en cas de pertinence pour améliorer ses performances dans les tâches spécialisées. Pour plus d’informations, consultez « [À propos des compétences de l’agent](/fr/copilot/concepts/agents/about-agent-skills) ».\n\n## Création et ajout d’une compétence\n\nPour créer une compétence d’agent, vous écrivez un `SKILL.md` fichier et, éventuellement, d’autres ressources, telles que des fichiers Markdown supplémentaires ou des scripts, que vous référencez dans les `SKILL.md` instructions.\n\n1. Si ce n’est déjà fait, créez un `skills` répertoire à l’un des emplacements suivants. C’est là que vous trouverez votre compétence, et tous les autres que vous souhaiterez peut-être créer à l’avenir.\n\n   Pour **les compétences de projet**, spécifiques à un référentiel unique, créez un répertoire `.github/skills`, `.claude/skills`, ou `.agents/skills` dans votre référentiel.\n\n   Pour **les compétences personnelles**, partagées entre les projets, créez un `~/.copilot/skills` répertoire ou un `~/.agents/skills` répertoire dans votre répertoire de base local.\n\n2. Dans le `skills` répertoire, créez un sous-répertoire pour votre nouvelle compétence. Chaque compétence doit avoir son propre répertoire (par exemple). `.github/skills/webapp-testing`\n\n   Les noms des sous-répertoires de compétence doivent être en minuscules et utiliser des traits d’union pour les espaces.\n\n3. Dans votre sous-répertoire de compétence, créez un `SKILL.md` fichier contenant les instructions de votre compétence.\n\n   > \\[!IMPORTANT]\n   > Les fichiers de compétence doivent être nommés `SKILL.md`.\n\n   ```\n          `SKILL.md` les fichiers sont des fichiers Markdown avec un frontmatter YAML. Dans leur forme la plus simple, ils incluent :\n   ```\n\n   * Informations préliminaires YAML\n     * **nom** (obligatoire) : identificateur unique de la compétence. Cela doit être minuscule, en utilisant des traits d’union pour les espaces. En règle générale, cela correspond au nom du répertoire de la compétence.\n     * **description** (obligatoire) : description de ce que fait la compétence et quand Copilot l’utiliser.\n     * **licence** (facultatif) : description de la licence qui s’applique à cette compétence.\n   * Corps Markdown, avec les instructions, les exemples et les directives à suivre pour Copilot.\n\n4. Si vous le souhaitez, ajoutez des scripts, des exemples ou d’autres ressources au répertoire de votre compétence.\n\n   Pour plus d’informations, consultez « [Activation d’une compétence pour exécuter un script](#enabling-a-skill-to-run-a-script) ».\n\n### Exemple de fichier `SKILL.md`\n\nPour une **compétence de projet**, ce fichier se trouve dans un `.github/skills/github-actions-failure-debugging` répertoire de votre référentiel.\n\nPour une **compétence personnelle**, ce fichier se trouve dans un `~/.copilot/skills/github-actions-failure-debugging` répertoire.\n\n```markdown copy\n---\nname: github-actions-failure-debugging\ndescription: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.\n---\n\nTo debug failing GitHub Actions workflows in a pull request, follow this process, using tools provided from the GitHub MCP Server:\n\n1. Use the `list_workflow_runs` tool to look up recent workflow runs for the pull request and their status\n2. Use the `summarize_job_log_failures` tool to get an AI summary of the logs for failed jobs, to understand what went wrong without filling your context windows with thousands of lines of logs\n3. If you still need more information, use the `get_job_logs` or `get_workflow_run_logs` tool to get the full, detailed failure logs\n4. Try to reproduce the failure yourself in your own environment.\n5. Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.\n```\n\n### Activation d’une compétence pour exécuter un script\n\nLorsqu’une compétence est appelée, Copilot détecte automatiquement tous les fichiers dans le répertoire de la compétence et les rend disponibles en même temps que les instructions de la compétence. Cela signifie que vous pouvez inclure des scripts ou d’autres ressources dans le répertoire de compétences et les référencer dans vos `SKILL.md` instructions.\n\nPour créer une compétence qui exécute un script :\n\n1. ```\n          **Ajoutez le script au répertoire de votre compétence.** Par exemple, une compétence pour convertir des images SVG en PNG peut avoir la structure suivante.\n   ```\n\n   ```text\n   .github/skills/image-convert/\n   ├── SKILL.md\n   └── convert-svg-to-png.sh\n   ```\n\n2. ```\n          **Facultativement, pré-approuvez les outils dont la fonctionnalité a besoin.** Dans votre `SKILL.md` frontmatter, vous pouvez utiliser le champ `allowed-tools` pour répertorier les outils que Copilot peut utiliser sans demander de confirmation à chaque fois. Si un outil n’est pas répertorié dans le `allowed-tools` champ, Copilot vous invite à entrer l’autorisation avant de l’utiliser.\n   ```\n\n   ```markdown\n   ---\n   name: image-convert\n   description: Converts SVG images to PNG format. Use when asked to convert SVG files.\n   allowed-tools: shell\n   ---\n   ```\n\n   > \\[!WARNING]\n   > Seule l'approbation préalable des outils `shell` ou `bash` est autorisée si vous avez examiné cette compétence et tous les scripts référencés, et que vous approuvez entièrement leur source. Le fait de pré-approuver `shell` ou `bash` supprime l'étape de confirmation pour l'exécution de commandes via le terminal, ce qui peut permettre aux attaquants de contrôler les fonctionnalités ou d'exécuter des injections de commandes arbitraires au sein de votre environnement. En cas de doute, omettez `shell` et `bash` de `allowed-tools` afin que Copilot doive demander votre confirmation explicite avant d’exécuter des commandes de terminal.\n\n3. ```\n          **Écrivez des instructions qui indiquent Copilot comment utiliser le script.** Dans le corps de Markdown, `SKILL.md`décrivez quand et comment exécuter le script.\n   ```\n\n   ```markdown\n   When asked to convert an SVG to PNG, run the `convert-svg-to-png.sh` script\n   from this skill's base directory, passing the input SVG file path as the\n   first argument.\n   ```\n\n## Ajout d’une compétence que quelqu’un d’autre a créée\n\nEn plus de créer vos propres compétences, vous pouvez également ajouter des compétences que d’autres personnes ont créées.\n\n> \\[!TIP]\n> Vous pouvez également utiliser `gh skill` dans GitHub CLI pour rechercher, installer, mettre à jour et publier des compétences d'agent. Pour plus d’informations, consultez « [Ajout de compétences d’agent pour GitHub Copilot](/fr/copilot/how-tos/use-copilot-agents/cloud-agent/add-skills#managing-skills-with-github-cli) ».\n\n1. Téléchargez un répertoire de compétences (autrement dit, un répertoire contenant un fichier SKILL.md et, éventuellement, d’autres fichiers et sous-répertoires).\n\n   Par exemple, téléchargez un skill à partir du dépôt Awesome GitHub Copilot : <https://awesome-copilot.github.com/skills/>.\n\n2. Si vous avez téléchargé un `.zip` fichier, décompressez-le.\n\n3. Déplacez le répertoire de compétences vers l’emplacement requis :\n\n   * Pour **les compétences de projet**, spécifiques à un référentiel unique : `.github/skills`, `.claude/skills`ou `.agents/skills` dans votre référentiel.\n\n   * Pour **les compétences personnelles**, partagées entre les projets : `~/.copilot/skills` ou `~/.agents/skills` dans votre répertoire de base local.\n\n## Gestion des compétences avec GitHub CLI\n\n> \\[!NOTE]\n\n```\n          `gh skill` est préversion publique et sujet à changement. Pour l’utiliser, mettez à jour GitHub CLI vers la version 2.90.0 ou ultérieure.\n```\n\nVous pouvez utiliser la commande `gh skill` dans GitHub CLI pour découvrir, installer, mettre à jour et publier des compétences d’agents à partir de référentiels GitHub.\n\nPour obtenir la liste complète des `gh skill` sous-commandes, exécutez `gh skill --help` ou consultez la [`gh skill`](https://cli.github.com/manual/gh_skill) section du GitHub CLI manuel.\n\n### Installation de compétences\n\nVous pouvez rechercher des compétences, les prévisualiser et les installer à partir de GitHub référentiels.\n\n> \\[!WARNING]\n> Les fonctionnalités ne sont pas vérifiées par GitHub et peuvent contenir des injections de commandes, des instructions masquées ou des scripts malveillants. Inspectez toujours le contenu d’une compétence avant l’installation en utilisant `gh skill preview`.\n\n1. Recherchez des compétences par rubrique :\n\n   ```shell\n   gh skill search TOPIC\n   ```\n\n2. Affichez un aperçu d’une compétence pour inspecter son contenu avant l’installation. Cela affiche l’arborescence des fichiers et des `SKILL.md` compétences dans votre terminal sans installer quoi que ce soit :\n\n   ```shell\n   gh skill preview OWNER/REPOSITORY SKILL\n   ```\n\n3. Installez une fonctionnalité. Vous pouvez exécuter `gh skill install` sans argument pour un flux entièrement interactif ou spécifier un référentiel pour parcourir ses compétences de manière interactive :\n\n   ```shell\n   gh skill install OWNER/REPOSITORY\n   ```\n\n   Pour installer directement une compétence spécifique :\n\n   ```shell\n   gh skill install OWNER/REPOSITORY SKILL\n   ```\n\n   Par exemple, pour installer une compétence à partir du [`github/awesome-copilot`](https://github.com/github/awesome-copilot) référentiel :\n\n   ```shell copy\n   gh skill install github/awesome-copilot documentation-writer\n   ```\n\n   Vous pouvez installer une version spécifique à l’aide `@TAG` ou `@SHA`:\n\n   ```shell copy\n   gh skill install github/awesome-copilot documentation-writer@v1.2.0\n   ```\n\n   Pour verrouiller une compétence à une version spécifique (ou valider SHA) afin qu’elle soit ignorée lors des mises à jour, utilisez `--pin`:\n\n   ```shell copy\n   gh skill install github/awesome-copilot documentation-writer --pin v1.2.0\n   ```\n\n   > \\[!NOTE]\n   > La syntaxe `@VERSION` et l'indicateur `--pin` s'excluent mutuellement. Utilisez l’un ou l’autre, pas les deux.\n\n   Pour installer une compétence pour un hôte d’agent spécifique, utilisez l’indicateur `--agent` . Pour contrôler l’étendue d’installation, utilisez `--scope`:\n\n   ```shell copy\n   gh skill install github/awesome-copilot documentation-writer --agent claude-code --scope user\n   ```\n\nLes compétences sont automatiquement installées dans le répertoire approprié pour votre hôte d’agent. Par défaut, les fonctionnalités sont installées au niveau du projet pour Copilot.\n\n### Mise à jour des compétences\n\nLorsque vous installez une compétence avec `gh skill`, les métadonnées de provenance sont écrites dans le frontmatter de `SKILL.md` la compétence, y compris le référentiel source, la référence et l’arborescence SHA. La `gh skill update` commande utilise ces métadonnées pour rechercher les modifications en amont.\n\nPour rechercher les mises à jour de manière interactive :\n\n```shell\ngh skill update\n```\n\nPour mettre à jour une compétence spécifique :\n\n```shell\ngh skill update SKILL\n```\n\nPour mettre à jour toutes les fonctions installées sans sollicitation :\n\n```shell\ngh skill update --all\n```\n\nLes compétences épinglées sont ignorées pendant les mises à jour. Pour mettre à jour une compétence épinglée, réinstallez-la avec une nouvelle valeur `--pin`.\n\n### Compétences de publication\n\nSi vous gérez un référentiel de compétences, vous pouvez valider et publier vos compétences à l’aide GitHub CLIde .\n\nPour valider vos compétences par rapport à la [spécification des compétences de l’agent](https://agentskills.io/specification) et vérifier les paramètres distants tels que la protection des balises, l’analyse des secrets et l’analyse du code, sans publication, utilisez `--dry-run`:\n\n```shell\ngh skill publish --dry-run\n```\n\nPour résoudre automatiquement les problèmes de métadonnées dans vos fichiers de compétence, utilisez `--fix`. Cela ne publie pas vos compétences :\n\n```shell\ngh skill publish --fix\n```\n\nPour valider et publier vos compétences :\n\n```shell\ngh skill publish\n```\n\n## Comment Copilot utilise les compétences de l’agent\n\nLors de la réalisation de tâches, Copilot décide quand utiliser vos compétences en fonction de votre invite et de la description de la compétence.\n\nLorsque Copilot choisit d’utiliser une compétence, le fichier `SKILL.md` sera injecté dans le contexte de l’agent, donnant à l’agent l’accès à vos instructions. Il peut ensuite suivre ces instructions et utiliser tous les scripts ou exemples que vous avez peut-être inclus dans le répertoire de la compétence.\n\n## Compétences et instructions personnalisées\n\nVous pouvez utiliser des compétences et des instructions personnalisées pour enseigner Copilot comment travailler dans votre référentiel et comment effectuer des tâches spécifiques.\n\nNous vous recommandons d’utiliser **des instructions personnalisées** pour des instructions simples pertinentes pour presque chaque tâche (par exemple des informations sur les normes de codage de votre référentiel) et des **compétences** pour obtenir des instructions plus détaillées que Copilot ne doit accéder qu’en cas de pertinence.\n\nPour en savoir plus sur les instructions personnalisées du référentiel, consultez [Ajout d’instructions personnalisées de référentiel pour GitHub Copilot](/fr/copilot/how-tos/configure-custom-instructions/add-repository-instructions)."}