Wat zijn agent skills, en werken ze in Claude, ChatGPT, Codex en Cursor?

Kort antwoord

Een agent skill is een map met een bestand SKILL.md: een naam, een beschrijving van wanneer je hem gebruikt, en instructies, eventueel met scripts en voorbeelden erbij. De agent laadt eerst alleen naam en beschrijving, en pas de rest als een taak erbij past. Het formaat komt van Anthropic, is als open standaard vrijgegeven en wordt gelezen door onder meer Claude, ChatGPT, Codex en Cursor.

Hoe een skill eruitziet

Een skill is een gewone map. Daarin staat in elk geval SKILL.md, met bovenaan twee velden: name en description. Daaronder staan de instructies in Markdown. Naast dat bestand kun je scripts, referentiedocumenten en sjablonen zetten.

offerte-maken/
├── SKILL.md        naam, beschrijving en de werkwijze
├── voorbeelden/    twee goedgekeurde offertes
└── scripts/        een script dat de btw uitrekent

De beschrijving is het belangrijkste veld. Volgens de documentatie van Anthropic vergelijkt het model je vraag met die beschrijving om te bepalen of de skill gebruikt wordt, dus moet erin staan wat de skill doet én wanneer je hem gebruikt.

Waarom skills zuinig zijn met context

Skills werken met wat Anthropic “progressive disclosure” noemt: de agent laadt informatie in stappen.

Niveau Wanneer geladen Kosten volgens Anthropic Inhoud
1. Metadata Altijd, bij de start Ongeveer 100 tokens per skill Naam en beschrijving
2. Instructies Als de skill wordt gekozen Onder de 5.000 tokens De tekst van SKILL.md
3. Bronnen en code Alleen als nodig Niets tot ze gelezen worden Extra bestanden; van scripts komt alleen de uitvoer in de context

Dat is het verschil met een instructiebestand als CLAUDE.md of AGENTS.md, dat elke sessie in zijn geheel meegaat. Een team kan zo tientallen werkwijzen klaarzetten zonder dat het contextvenster volloopt. Codex begrenst de lijst met skills standaard op 2 procent van het contextvenster.

Welke tools lezen skills?

Het formaat is door Anthropic ontwikkeld en als open standaard vrijgegeven op agentskills.io. Per november 2026:

Tool Waar staan de skills Hoe start je er een
Claude Code .claude/skills/ (project) of ~/.claude/skills/ (persoonlijk) Automatisch als de taak past, of zelf aanroepen
Claude.ai Uploaden als zip onder Customize > Skills Automatisch als de taak past
Codex .agents/skills/ in je map of repository, ~/.agents/skills/, /etc/codex/skills /skills of $naam, of automatisch
ChatGPT Skills toevoegen in ChatGPT Typ @ en kies de skill, of automatisch
Cursor .agents/skills/, .cursor/skills/, en voor compatibiliteit ook .claude/skills/ en .codex/skills/ Automatisch, of / in de Agent-chat

Op Team- en Enterprise-plannen van Claude kunnen eigenaren skills voor de hele organisatie klaarzetten, en kunnen gebruikers een skill delen met collega’s of indienen voor de bibliotheek van de organisatie. Hoe skills in Claude Code werken staat uitgebreider in Wat zijn skills in Claude Code en wanneer maak je er een?

Het misverstand: één skill, overal tegelijk

Een open formaat is niet hetzelfde als één gedeelde plek. Claude Code kan skills die in je claude.ai-account zijn ingeschakeld automatisch downloaden als je met dat account bent ingelogd, maar niet bij elke manier van inloggen, en een upload naar de Claude API blijft apart. Een skill in je repository bereikt Codex en Cursor van iedereen die die repository heeft, maar niet de ChatGPT of Claude van de collega’s van sales.

Dat werkt prima voor een ontwikkelteam dat alles in git heeft. Voor een team waarin de ene helft in ChatGPT werkt en de andere in Claude Code betekent het: dezelfde werkwijze op drie plekken bijhouden, en hopen dat iemand ze gelijk houdt.

Waar skills goed voor zijn, en waarvoor niet

Skills zijn sterk voor procedures: hoe maken wij een offerte, hoe schrijven we een release note, hoe controleren we een contract. Ze zijn minder geschikt voor feiten die veranderen, zoals klantafspraken of prijzen: een skill is een bestand dat iemand moet bijwerken. En ze zijn niet bedoeld als geheugen: een skill onthoudt niets van wat er gebeurt terwijl je hem gebruikt.

Behandel een skill als software. Anthropic raadt aan alleen skills te gebruiken die je zelf schreef of van een vertrouwde bron hebt, en ze voor gebruik helemaal na te lezen, omdat een kwaadwillende skill een agent tools kan laten misbruiken of gegevens kan laten lekken.

Dit hoort bij het bredere vak van context engineering: bepalen welke informatie een agent op welk moment ziet.

Waar Bombos past

Skills leggen vast hoe een taak moet; Bombos houdt bij wat het team weet en geleerd heeft, en geeft dat aan elke AI-tool die het team gebruikt, van Claude en ChatGPT tot Codex, Cursor, Copilot en eigen agents. Regels die het team heeft geleerd staan daar voor elke tool klaar, en je ziet waar elk antwoord op rust. Het draait in de cloud of op je eigen server, en één persoon kan het eerst voor zijn eigen agents proberen.

Vragen die hierbij horen

Wat is het verschil tussen een skill en een systeemprompt?

Een systeemprompt of een CLAUDE.md laadt elke sessie volledig. Een skill laadt alleen zijn naam en beschrijving; de instructies komen pas in de context als de taak erom vraagt. Daardoor kun je veel skills klaarzetten zonder het contextvenster te vullen.

Kan ik een skill van internet zomaar installeren?

Liever niet. Anthropic waarschuwt dat een skill met kwade bedoelingen een agent tools kan laten aanroepen of code kan laten draaien die niet bij het doel past. Gebruik skills die je zelf schreef of die van een vertrouwde bron komen, en lees ze eerst na.

Delen Claude.ai en Claude Code dezelfde skills?

Deels. Claude Code kan skills die in je claude.ai-account zijn ingeschakeld automatisch downloaden als je met dat account bent ingelogd. Dat geldt niet voor elke manier van inloggen, zoals met een API-sleutel. Uploads naar de Claude API blijven apart.

Waar zet ik een skill zodat Codex en Cursor hem allebei vinden?

In de map .agents/skills/ van je repository. Codex zoekt daar, en Cursor laadt die map ook, naast .cursor/skills/ en .claude/skills/.

Bronnen

  1. Agent Skills overview (Claude API-documentatie)
  2. Agent Skills: open standaard
  3. Build skills (ChatGPT en Codex-documentatie)
  4. Skills (Cursor-documentatie)
  5. Using Skills in Claude (Claude Help Center)
Het eerste half uur · kosteloos

Wat vergeet jullie AI?

  1. 01Je vertelt welke AI jullie gebruiken en waar het steeds opnieuw moet.
  2. 02We laten zien wat een gedeeld geheugen daar verandert, op jullie eigen voorbeelden.
  3. 03Je krijgt het plan mee. Dat houd je, ook zonder Bombos.
Piet Baudoin
Piet BaudoinJe spreekt Piet, van het team van BombosNederlands team uit Utrecht en Nijmegen · data in Europa
We reageren dezelfde werkdag.