uwv-common-agentic

Centrale registry voor gedeelde Skills binnen het UWV.

Wat is een Skill?

Een Skill is een instructie die een AI-agent kan inladen om extra context aan een vraag toe te voegen. Dit kan handmatig gebeuren of zodra een prompt erom vraagt. De invulling van de instructies kan veel kanten op gaan. Het kan belangrijke informatie over een specifiek onderwerp geven, of aangeven welke stappen je zet voor een klus, bijvoorbeeld hoe de AI-agent een pull request moet openen volgens het template van de repository. Je hoeft die uitleg dan niet in elke chat opnieuw te geven, en de agent doet het elke keer op dezelfde manier, zoals beschreven in de SKILL.md.

In deze registry delen we onze kennis en de skills die ons helpen, om binnen UWV elkaar te helpen en van elkaar te leren.

De skills volgen de Agent Skills-specificatie, dus ze werken in vrijwel alle agent-harnassen, zoals GitHub Copilot. De documentatie is Nederlands, conform UWV-beleid. Een SKILL.md mag Engels zijn, omdat de AI-modellen daar meestal beter mee werken.

Installeren

Installeren via de plugin-marketplace (aangeraden)

Deze repository is een plugin-marketplace voor o.a. GitHub Copilot (.github/plugin/marketplace.json).

Deze bevat meerdere plugins, zodat je bij het installeren makkelijk kan kiezen wat je wel en niet wilt gebruiken.

• De plugin uwv-common bevat alle zelfgemaakte UWV-skills uit deze repository.
• De aanbevolen skills van derden staan in een losse plugin per bron. De kolom "Plugin" in die catalogus laat zien welke skills onder welke bron vallen.

Nieuwe versies van de UWV-skills haal je met één update-commando op. Skills van derden blijven op de gepinde commit staan tot een pull request de pin ophoogt.

Optie 1: Via de Copilot CLI

Installeer de marketplace via de Copilot CLI:

copilot plugin marketplace add MRDekeijzer/uwv-common-agentic
copilot plugin install uwv-common@uwv
copilot plugin install <plugin>@uwv    # optioneel, maar aangeraden: skills van derden
copilot plugin update --all            # later: wijzigingen ophalen

Optie 2: VS Code

Voeg de marketplace toe aan je gebruikersinstellingen en installeer de plugins via de Plugins-pagina van de Agent Customizations-editor.

"chat.plugins.marketplaces": ["MRDekeijzer/uwv-common-agentic"]

Optie 3: Per project

Voor één project kan een team de marketplace ook in .github/copilot/settings.json in de repo van dat project zetten, zodat iedereen die aan het project werkt de plugins aangeboden krijgt:

{
  "extraKnownMarketplaces": {
    "uwv": { "source": { "source": "github", "repo": "MRDekeijzer/uwv-common-agentic" } }
  },
  "enabledPlugins": { "uwv-common@uwv": true }
}

Installeren via de GitHub CLI (afgeraden)

Installeren kan ook via de GitHub CLI. Dat raden we af, omdat je dan zelf updates moet bijhouden.

Je hebt de GitHub CLI 2.90 of nieuwer nodig.

gh skill install MRDekeijzer/uwv-common-agentic                # kies skills, in dit project
gh skill install MRDekeijzer/uwv-common-agentic create-pr --scope user   # voor al je projecten
gh skill install MRDekeijzer/uwv-common-agentic --all          # alle UWV-skills

Met gh skill update haal je latere wijzigingen op.

Handmatig kopiëren (afgeraden)

Installeren kan ook zonder marketplace of GitHub CLI. Dat raden we af, omdat je dan zelf updates moet bijhouden.

Een Skill is in de basis een map. Zo installeer je een skill handmatig:

• Globaal gebruik: kopieer skills/<naam>/ uit deze repo naar ~/.copilot/skills/ of ~/.agents/skills/ om de skill in al je projecten te kunnen gebruiken.
• Voor een specifiek project: kopieer skills/<naam>/ uit deze repo naar .github/skills/ of .agents/skills/ in dat project.

UWV-skills

Deze skills zijn binnen het UWV gemaakt en worden in deze repository onderhouden.

scripts/validate_skills.py genereert deze tabel, dus pas hem niet met de hand aan.

Aanbevolen skills van derden

Deze skills komen van buiten het UWV. Ze staan niet in deze repository: je installeert ze uit de bron, vastgezet op een commit die wij hebben bekeken.

Bijdragen

Heb je een eigen skill geschreven die handig en breed inzetbaar kan zijn voor anderen? Of gebruik je regelmatig een skill van een andere partij die je graag deelt met je collega's? Draag dan bij aan de registry!

De CONTRIBUTING.md legt uit hoe je kan bijdragen.

Owners

@MRDekeijzer en @FrisoHarlaar beheren de registry. We proberen elke pull request binnen een week te reviewen.

Licentie

MIT.