Claude Skills uitgelegd: de drie niveaus van progressieve onthulling

Een Claude Skill is fysiek gezien een map. Geen gehoste service, geen binair bestand, geen blok tekst dat je bovenaan een gesprek plakt — een map met een SKILL.md-bestand en al het andere dat de taak nodig heeft. Bijna alles wat interessant is aan Skills volgt uit die ene beslissing, omdat een map iets is dat een agent selectief kan openen. Een prompt kan niet selectief worden geopend. Die staat ofwel in het gesprek, of niet.

De documentatie van Anthropic beschrijft de opzet als georganiseerd als een onboardinggids die je voor een nieuwe teamgenoot zou maken, en de analogie gaat verder dan op het eerste gezicht lijkt. Niemand leest een onboardinggids van kaft tot kaft voordat hij aan het werk begint. Ze lezen de pagina die past bij de vraag die voor hen ligt, en ze vertrouwen erop dat de rest er nog steeds is wanneer ze die nodig hebben. Een skill is op dezelfde gok gebouwd: dat het grootste deel van een procedure de meeste tijd op schijf kan blijven staan.

Bestandssysteem eerst, mogelijkheden tweede

Claude werkt in een virtuele machine met toegang tot het bestandssysteem. Dat is de voorwaarde ervoor dat een skill een map is in plaats van een configuratie-item, omdat de agent daardoor de inhoud van een map kan weergeven, een bestand kan lezen en een verwijzing naar een ander bestand kan volgen met dezelfde bewerkingen als een persoon zou gebruiken. Daarbinnen bundelt een skill instructies, metadata en optionele resources zoals scripts en sjablonen.

Het resultaat is een capaciteit die groter is dan elk afzonderlijk bestand in de map. De instructies vertellen hoe de taak moet worden uitgevoerd. Een meegeleverd script kan een deel ervan uitvoeren zonder in proza te worden beschreven. Een referentiedocument kan materiaal bevatten dat wordt opgezocht in plaats van onthouden. Wat die drie dingen tot een systeem maakt in plaats van een stapel, is de volgorde waarin ze zichtbaar worden, wat het onderdeel is dat Anthropic progressive disclosure noemt — informatie in fasen laden naarmate die nodig is, in plaats van context vooraf te verbruiken.

Niveau 1: de twee velden die altijd worden geladen

Elke skill begint met YAML-frontmatter die een naam en een beschrijving bevat. Claude laadt die metadata bij het opstarten en neemt deze op in de systeemprompt. Het is het enige deel van de skill dat aanwezig is voordat iemand ergens om vraagt, en totdat een skill wordt geactiveerd, nemen alleen de naam en de beschrijving context in beslag.

De beschrijving vervult tegelijk drie taken, en als je die van elkaar scheidt, wordt duidelijk waarom zoveel skills stilletjes worden genegeerd. Het is een label: het zegt hoe het ding heet. Het is een indexvermelding: de tekst waarmee een verzoek wordt vergeleken wanneer Claude beslist of de skill relevant is. En het is een afbakening van de reikwijdte, en daarom luidt de richtlijn van Anthropic dat ze zowel moet zeggen wat de skill doet als wanneer je die moet gebruiken. Een beschrijving die alleen de eerste taak vervult, geeft de matcher niets om mee te matchen.

Neem twee versies van dezelfde vaardigheid. De ene wordt beschreven als het invullen en valideren van PDF-formulieren, te gebruiken wanneer een verzoek het invullen of controleren van een PDF-formulier omvat. De andere wordt beschreven als hulp bij documenten. De eerste noemt een actie en een situatie; de tweede noemt geen van beide. Een vaardigheid waarvan de beschrijving geen van beide noemt, blijft ongelezen op schijf staan terwijl de agent de taak op de omslachtige manier uitvoert — niet omdat de vaardigheid faalde, maar omdat ze nooit werd gevonden.

Niveau 2: de hoofdtekst, lees deze wanneer de beschrijving overeenkomt

Wanneer een verzoek overeenkomt met de beschrijving, opent het tweede niveau: de inhoud van SKILL.md. Dat is de procedure — workflows, best practices, richtlijnen — en die is geschreven voor een agent die al heeft besloten dat deze skill het juiste hulpmiddel is voor de taak. Het is de plek waar een team de stappen opschrijft die het anders in elk gesprek zou herhalen, en waar de verwijzingen naar dieper materiaal staan.

De volgorde is hier net zo belangrijk als op niveau 1. De hoofdtekst wordt niet bij het opstarten geladen, en ook niet voor de zekerheid. Hij arriveert nadat er een beslissing is genomen, wat betekent dat de beslissing op basis van alleen niveau 1 genomen moet kunnen worden. Een skill met een vage beschrijving heeft geen manier om zich op niveau 2 te herstellen, omdat niveau 2 nooit wordt gelezen.

Niveau 3: bestanden die opengaan omdat iets ernaar verwees

Het derde niveau is de rest van de map: aanvullende bestanden waarnaar vanuit SKILL.md wordt verwezen. Het voorbeeld van Anthropic is een FORMS.md met geavanceerde richtlijnen over het invullen van formulieren, buiten de hoofdinstructions gehouden zodat die instructions kort blijven en de details alleen beschikbaar zijn wanneer een taak ze nodig heeft. Scripts en templates horen ook op dit niveau.

Het structurele effect is dat een vaardigheid heel veel materiaal kan meedragen zonder alles tegelijk mee te dragen. Een map kan een hoofdinstructiebestand, een gedetailleerde referentie, een set sjablonen en een script bevatten, en een bepaalde taak raakt misschien slechts één daarvan. Alles waar niets naar verwijst, blijft op schijf staan, en schijf is niet de schaarse hulpbron in een agent. Context wel.

Dat is ook waar het formaat het plafond opheft waar prompts tegenaan lopen. Een prompt moet kort genoeg zijn om het plakken waard te zijn. Het gebundelde materiaal van een skill wordt begrensd door wat een map kan bevatten, omdat alleen het deel dat de taak daadwerkelijk heeft aangeraakt, het model bereikt.

Waarom de volgorde het ontwerp is, niet een detail

Hieruit volgen drie consequenties, en samen zijn ze de reden dat dit het waard is om te begrijpen in plaats van alleen te weten.

• Context is een budget, en inhoud die altijd wordt geladen is een vaste kostenpost. Alles in een systeemprompt wordt bij elk verzoek betaald, inclusief verzoeken die niets met die vaardigheid te maken hebben. Progressieve onthulling maakt van een vaste kostenpost een voorwaardelijke: altijd een beschrijving, instructies wanneer relevant, verwijzingen wanneer er naar verwezen wordt.

• De beschrijving is een interface. Het is het enige onderdeel van een vaardigheid dat gegarandeerd wordt gezien, dus het is waar een auteur moet nadenken over triggering en niet alleen over de inhoud.

• Een skill kent drie onderhoudssnelheden.Metadata verandert wanneer de skill anders moet worden geactiveerd, de hoofdtekst verandert wanneer de workflow verandert, en referenties veranderen wanneer het onderliggende materiaal verandert. Ze gescheiden houden voorkomt dat een referentie-update verandert in een herschrijving van de instructies.

De kosten zijn het spiegelbeeld van het voordeel. Elke niveaugrens is een plek waar het model een beslissing correct moet nemen. Een beschrijving die te smal is, betekent dat de vaardigheid nooit wordt geactiveerd en de map dode ballast is. Een die te breed is, betekent dat hij wordt geactiveerd voor werk waarvoor hij niet is gebouwd, en dat de instructies ervan een belasting vormen voor niet-verwante taken. Progressieve onthulling maakt de beschrijving dragend op een manier waarop een lange prompt, die altijd aanwezig is, dat nooit is.

Wat Anthropic al levert, en waar je eigen vaardigheden vandaan komen

Anthropic levert vooraf gebouwde Skills voor PowerPoint, Excel, Word en PDF — presentaties, spreadsheets, documenten en opgemaakte PDF-uitvoer. Ze zijn beschikbaar op claude.ai, de Claude API, Claude Platform on AWS en Microsoft Foundry, met de kanttekening dat ze op Foundry een Hosted on Anthropic-implementatie vereisen.

Dat is de snelste manier om het mechanisme te zien in plaats van erover te lezen. De laadvolgorde is identiek aan die van alles wat je zelf schrijft; het verschil tussen een vooraf gebouwde skill en een aangepaste is wie de map heeft geschreven, niet hoe die het model bereikt.

Custom Skills kunnen worden gemaakt in Claude Code, worden geüpload via de Claude API of worden toegevoegd in de instellingen van claude.ai. De door Anthropic genoemde voordelen ervan zijn de voordelen die je van alles wat herbruikbaar is zou verwachten: Claude specialiseren voor domeintaken, richtlijnen één keer opstellen in plaats van ze te herhalen, en meerdere skills combineren voor werk in meerdere stappen. Het laatste volgt het meest direct uit de architectuur, want als elke skill een map is die op aanvraag wordt geopend, kost een stapel skills heel weinig totdat het werk ze daadwerkelijk nodig heeft.

Een skill is geen prompt en geen connector.

Drie dingen worden in gesprekken door elkaar gehaald, en de laadvolgorde maakt het makkelijk om de verschillen vast te houden.

Een prompt zit op gespreksniveau. Hij is aanwezig vanaf de eerste beurt, kleurt alles in dat gesprek en verdwijnt met het gesprek. Een skill is op aanvraag: hij bestaat voordat het gesprek begint, het grootste deel ervan komt nooit in het gesprek terecht, en het deel dat wel arriveert, doet dat omdat een beschrijving overeenkwam. Dat is het verschil tussen een agent vertellen hoe hij zich moet gedragen en hem iets geven dat hij kan oppikken.

Een connector gaat over bereik. Connectors zijn app-toegang, wat betekent dat ze bepalen waar een agent bij kan; een skill bepaalt hoe de agent iets moet doen zodra hij erbij kan. Een team kan uitstekende connectors hebben en toch inconsistente documenten produceren, omdat toegang geen procedure is. Het kan ook uitstekende skills hebben en toch de data niet zien, omdat procedure geen toegang is.

De documentatie van Anthropic behandelt Skills en het Model Context Protocol als verschillende lagen, en het mechanisme met drie niveaus laat zien waarom de scheiding zuiver is. De laadvolgorde gaat over wanneer informatie aankomt, niet over waar die vandaan komt.

Waar de donatie past, in één alinea.

Op 22 oktober 2026 schonk Anthropic de Agent Skills-standaard aan de Agentic AI Foundation onder de Linux Foundation — de naam, het logo, de GitHub-organisatie en het domein agentskills.io — waarbij ingenieurs van Anthropic, Google, OpenAI en andere bedrijven deze als individuen onderhouden. Niets daarvan verandert het hierboven beschreven mechanisme. Het mapformaat, de YAML-frontmatter, de laadvolgorde en de vooraf gebouwde document-skills zijn precies zoals ze de dag ervoor waren. Wat is veranderd, is wie de naam bezit; dat is van groot belang voor de stabiliteit van een standaard op de lange termijn en helemaal niet voor hoe je vanmiddag een skill schrijft.

Een skill lezen voordat je deze installeert

Als de drie niveaus de architectuur vormen, leveren ze ook een korte checklist voor de beoordeling op. Lees eerst de beschrijving, want die bepaalt of er überhaupt nog iets anders gebeurt: erin moet staan wat de skill doet en wanneer je hem moet gebruiken, in bewoordingen die een verzoek waarschijnlijk zou gebruiken. Lees SKILL.md als tweede, want dat is de procedure die de agent volgt, en het moet lezen als instructies aan een competente collega, niet als een samenvatting van wat je hoopt dat er gebeurt. Lees als derde waarnaar het verwijst. Lees daarna de scripts.

Dat laatste punt is geen paranoia. Het formaat staat toe dat een skill instructies meedraagt naast optionele resources, en resources kunnen uitvoerbare code bevatten. Een skill die je installeert is dus niet alleen tekst die een gesprek vormgeeft; het is een map waaruit een capabele agent bestanden opent en op basis daarvan handelt. Het niveau-voor-niveau-model vertelt je precies waar je moet kijken, wat meer is dan de meeste geïnstalleerde dingen bieden.

Eén grens is het vermelden waard voor lezers die via onze eigen pagina's komen. OrcaRouter routeert modelaanroepen, en wij hosten geen van de apps van Anthropic of de bijbehorende skill-oppervlakken — een skill draait waar het bestandssysteem van de agent zich bevindt, en dat is niet onze laag. Wat wij doen, zit onder de modelkeuze: meer dan 200 modellen achter één OpenAI-compatibele sleutel, de lijstprijs van de provider doorgegeven zonder opslag, en automatische failover tussen providers wanneer er één niet beschikbaar is. Een skill bepaalt hoe een taak moet worden uitgevoerd. Een router bepaalt welk model dat doet, en geen van beide lagen zou veel over de andere hoeven te weten.

Progressieve ontsluiting is eerlijk over de beperking die het oplost. Context is eindig, procedures zijn lang, en het grootste deel van elke gegeven procedure is irrelevant voor de taak die voor je ligt. Een naam, een body en een set bestanden vormen geen ingewikkeld ontwerp; het is het kleinste ontwerp dat een agent in staat stelt een grote hoeveelheid kennis te dragen terwijl hij alleen het deel vasthoudt dat hij nodig heeft.

Daarom is de meest bepalende regel in een goed opgebouwde skill ook de kortste. Al het andere in de map is een bibliotheek. De beschrijving is de kaartcatalogus, en als de catalogus niet klopt, kan de bibliotheek net zo goed niet bestaan.