Agentvaardigheden gebruiken met GitHub Copilot

Agentvaardigheden zijn herbruikbare instructiesets die Copilot-agents leren hoe ze specifieke taken uitvoeren, zoals het uitvoeren van een build-pijplijn, het genereren van standaardcode of het volgen van de coderingsstandaarden van uw team. Door eenmaal vaardigheden te definiëren, bespaart u tijd en zorgt u voor consistent gedrag in uw werkstroom.

Vaardigheden vormen een aanvulling op aangepaste agents en aangepaste instructies. Hoewel aangepaste agents een persona en hulpprogrammaset definiëren en aangepaste instructies algemene coderingsvoorkeuren instellen, bieden vaardigheden gerichte, taakspecifieke richtlijnen die elke agent automatisch kan detecteren en gebruiken.

Prerequisites

Hoe agentvaardigheden werken

Wanneer u agentmodus gebruikt, detecteert Copilot automatisch vaardigheden uit uw opslagplaats en gebruikersprofiel. De agent bepaalt wanneer een vaardigheid relevant is voor uw aanvraag en activeert. Wanneer een vaardigheid wordt geactiveerd, wordt deze weergegeven in de chat om u te laten weten dat deze wordt toegepast.

Schermopname met een vaardigheid die wordt gebruikt door de Copilot-agent in chat.

Vaardigheidslocaties

Vaardigheden worden opgehaald vanaf de volgende locaties:

Vaardigheidstype Location
Vaardigheden voor werkruimten of projecten (opgeslagen in uw opslagplaats) .github/skills/, .claude/skills/, .agents/skills/
Persoonlijke vaardigheden (opgeslagen in uw gebruikersprofiel) ~/.copilot/skills/, ~/.claude/skills/, ~/.agents/skills/

Werkruimtevaardigheden worden gedeeld met uw team via broncodebeheer. Persoonlijke vaardigheden zijn van toepassing op al uw projecten en zijn niet gebonden aan een specifieke repository.

Een vaardigheid maken

U kunt een vaardigheid maken op basis van het vaardighedenvenster in Visual Studio of handmatig in uw bestandssysteem. Als u een vaardigheid wilt maken op basis van het vaardighedenvenster, moet u beschikken over Visual Studio 2026 Insiders versie 18.6 of hoger.

Een vaardigheid maken vanuit het vaardighedenvenster

  1. Selecteer het pictogram Tools in de rechterbenedenhoek van Copilot Chat om het vaardighedenvenster te openen.

  2. Selecteer de + knop in de rechterbovenhoek van het deelvenster.

    Schermopname van het maken van een nieuwe vaardigheid vanuit het vaardighedenvenster.

  3. Kies een bestemming (globale vaardigheid of vaardigheid op oplossingsniveau) en kies een naam.

    Schermopname van het benoemen van een nieuwe vaardigheid.

  4. Visual Studio een vaardigheidssjabloon genereert die u kunt invullen. U kunt Copilot-agent modus gebruiken om de sjabloon te voltooien.

Handmatig een vaardigheid maken

Elke vaardigheid is een map met een SKILL.md bestand dat de agentskills.io specificatie volgt.

  1. Maak een map voor vaardigheden. Voor een werkruimtevaardigheid gebruikt u .github/skills/ in de hoofdmap van uw repository. Gebruik ~/.copilot/skills/ voor een persoonlijke vaardigheid.

  2. Maak een submap voor je skill. Elke vaardigheid moet een eigen map hebben (bijvoorbeeld .github/skills/github-issues/).

  3. Maak een SKILL.md bestand in de map vaardigheid. Het bestand bevat YAML-frontmatter met metagegevens gevolgd door Markdown-instructies.

  4. Voeg desgewenst scripts, voorbeelden of andere resources toe aan de map van uw vaardigheid.

Vaardighedendirectorystructuur

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

SKILL.md-formaat

Het SKILL.md bestand moet YAML-frontmatter bevatten, gevolgd door Markdown-inhoud:

---
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

Eigenschappen van frontmatter

Property Verplicht Description
name Ja Alleen kleine letters, cijfers en koppeltekens. Moet overeenkomen met de naam van de bovenliggende map. Maximaal 64 tekens.
description Ja Beschrijft wat de vaardigheid doet en wanneer deze moet worden gebruikt. Maximaal 1024 tekens.
license Geen Licentienaam of verwijzing naar een gebundeld licentiebestand.
compatibility Geen Omgevingsvereisten, zoals bedoeld product of vereiste systeempakketten.
metadata Geen Willekeurige sleutelwaardetoewijzing voor aanvullende metagegevens.
allowed-tools Geen Door spaties gescheiden lijst van vooraf goedgekeurde hulpprogramma's die een vaardigheid kan gebruiken.

Tips voor het schrijven van effectieve vaardigheden

  • Houd de hoofdlijn SKILL.md onder 500 regels. Verplaats gedetailleerd referentiemateriaal naar aparte bestanden in de references/ map.
  • Schrijf duidelijk description dat specifieke trefwoorden bevat om agents te helpen identificeren wanneer de vaardigheid relevant is.
  • Voeg stapsgewijze instructies, voorbeelden en veelvoorkomende edge-cases toe.

Vaardigheden beheren vanuit het vaardighedenvenster

Selecteer het pictogram Tools in de rechterbenedenhoek van Copilot Chat om het vaardighedenvenster te openen, een speciale weergave van elke gedetecteerde vaardigheid. Het deelvenster Vaardigheden is alleen beschikbaar in de Visual Studio 2026 Insiders.

Schermopname van het deelvenster Vaardigheden waar u vaardigheden kunt bewerken en openen.

In het deelvenster kunt u het volgende doen:

  • Bewerken: Open een vaardigheid SKILL.md rechtstreeks in de editor vanuit het menu ... .
  • Bestandslocatie openen: spring naar de vaardigheidsmap op de schijf.
  • Zoeken: Vaardigheden filteren op naam of trefwoord.

Het paneel geeft ook diagnostische gegevens weer voor eventuele fouten in de configuratie van vaardigheden, zodat u snel problemen kunt opsporen en oplossen.

Communityvaardigheden

Bekijk de awesome-copilot-repository voor vaardigheidsvoorbeelden die door de community worden gedeeld.