Claude skills voor bedrijven zijn geen prompts en geen koppelingen. Een skill is een map met een instructiebestand, en optioneel scripts en voorbeelden, die Claude zelf laadt zodra de taak erom vraagt [S-054]. De winst zit erin dat de werkwijze blijft staan. De grens zit in waar hij geldt.
Dit is voor een eigenaar of teamlead die wil weten of hier iets uitrolbaars ligt of alleen een handigheidje. De officiële productnaam is Agent Skills; in lopende tekst heet het een skill. Wat het gereedschap eromheen doet, staat in Claude Code voor bedrijven.
Wat zijn Claude skills?
Mappen op een bestandssysteem. Anthropic omschrijft ze als modulaire mogelijkheden die Claude uitbreiden, waarbij elke skill instructies, metadata en optionele resources zoals scripts en templates verpakt die Claude automatisch gebruikt als ze relevant zijn [S-054].
Concreet bestaat een skill uit een bestand SKILL.md met YAML-frontmatter waarin twee velden verplicht zijn: name en description. De naam mag maximaal 64 tekens lang zijn, bestaat uit kleine letters, cijfers en koppeltekens, en mag de woorden anthropic en claude niet bevatten. De beschrijving mag niet leeg zijn en maximaal 1024 tekens lang [S-058]. Naast dat ene bestand kun je extra markdown-bestanden, scripts en naslagmateriaal in dezelfde map zetten.
Dat is alles. Geen installatie, geen abonnementsvorm, geen winkel: een map met tekst die iemand in je bedrijf heeft geschreven.
Wat kun je met een skill wat met een prompt niet kan?
Hem laten staan. De documentatie zet het verschil zo neer: een prompt is een instructie op gespreksniveau voor een eenmalige taak, terwijl een skill op verzoek laadt zodat je dezelfde uitleg niet in elk gesprek hoeft te herhalen [S-055].
Voor een bedrijf is dat het hele punt. De manier waarop jullie een offerte opbouwen, de velden die in een rapport horen, de controles die een oplevering doorloopt: dat is kennis die nu in het hoofd van twee mensen zit en elke keer opnieuw wordt uitgelegd. Een skill maakt er een bestand van. Een bestand kun je nakijken, verbeteren en overdragen; een prompt in iemands geschiedenis niet.
WeAdapt werkt zelf zo. De pijplijn die deze kennisbank schrijft bestaat uit skills, en de studio die social posts maakt doet hetzelfde: per stap één map met de werkwijze, de regels en de controles erin. Dat is geen demonstratie, dat is hoe het werk draait.
Wanneer gebruikt Claude een skill?
Dat bepaalt hij zelf, op basis van één veld. De description is wat Claude je verzoek tegen matcht om te besluiten of hij de skill activeert, en moet daarom zowel zeggen wat de skill doet als wanneer je hem gebruikt [S-057].
Daar hangt meer aan dan het lijkt. Een vage beschrijving betekent dat de skill niet afgaat als je hem nodig hebt, of juist afgaat als je hem niet nodig hebt. De best-practices-documentatie schrijft daarom voor de beschrijving in de derde persoon te zetten, omdat hij in de systeemprompt wordt geïnjecteerd en een wisselend perspectief de herkenning verstoort [S-063].
Praktisch gevolg voor een bedrijf: het veld dat je het snelst overslaat is het veld dat bepaalt of de skill ooit gebruikt wordt. Schrijf er de trigger in, niet alleen het onderwerp.
Wat kost een skill aan context?
Bijna niets, tot hij afgaat. Dat is de reden dat je er tientallen kunt installeren, en het is precies wat in geen enkele uitleg terugkomt. Een skill laadt in niveaus [S-056]:
| Niveau | Wanneer | Contextkosten | Wat erin zit |
|---|---|---|---|
| 1 Metadata | altijd, bij de start | ongeveer 100 tokens per skill | name en description uit de frontmatter |
| 2 Instructies | zodra de skill getriggerd wordt | onder 5k tokens | de body van SKILL.md |
| 3 Resources en code | pas bij gebruik | niets tot het geopend wordt | gebundelde bestanden; scripts leveren alleen hun uitvoer |
Zolang een skill niet getriggerd is, bezetten alleen zijn naam en beschrijving context, en daarom kun je er veel installeren zonder contextkosten [S-057]. Een script dat Claude uitvoert levert alleen zijn uitvoer op in de context, niet zijn eigen code [S-056].
Wat dat voor een bedrijf betekent: je hoeft niet te kiezen welke drie werkwijzen je vastlegt. Je kunt ze allemaal vastleggen en de keuze aan de taak laten. De rem zit elders, namelijk in de body van SKILL.md zelf; de documentatie adviseert die onder 500 regels te houden en langer materiaal in aparte bestanden te splitsen [S-063].
Werkt een skill overal hetzelfde?
Nee, en dit is de vraag die bepaalt of je hem kunt uitrollen. Een skill gedraagt zich anders in claude.ai, op de Claude API en in Claude Code. Surface is het woord dat de documentatie daarvoor gebruikt.
| claude.ai | Claude API | Claude Code | |
|---|---|---|---|
| Wie heeft toegang | alleen de individuele gebruiker, elk teamlid uploadt apart [S-060] | workspace-breed, alle workspace-leden [S-060] | persoonlijk in ~/.claude/skills/ of per project in .claude/skills/ [S-060] |
| Centraal beheer | geen centraal beheer door een beheerder, geen organisatiebrede distributie [S-060] | via de workspace [S-060] | via het project, dus via je repository [S-060] |
| Synchroniseert | nee, apart uploaden per surface [S-059] | nee [S-059] | nee, staat los van beide [S-059] |
| Netwerktoegang | hangt af van de instellingen van gebruiker of beheerder [S-061] | geen netwerktoegang, geen pakketten installeren tijdens uitvoering [S-061] | zelfde netwerktoegang als elk ander programma op die computer [S-061] |
| Vooraf gebouwde documentskills | ja [S-064] | ja [S-064] | nee [S-064] |
Lees die derde rij nog een keer. Eigen skills synchroniseren niet tussen de surfaces: wat je in claude.ai uploadt moet apart naar de API, wat via de API is geüpload is niet beschikbaar in claude.ai, en skills in Claude Code staan op het bestandssysteem en staan los van beide [S-059].
Dat heeft een directe consequentie voor de vraag “kunnen we dit voor het hele team doen”. In claude.ai is het antwoord: alleen als elk teamlid hem zelf uploadt, en een beheerder kan dat niet voor iedereen regelen [S-060]. In Claude Code is het antwoord: ja, door de map in je repository te zetten, waar hij dezelfde review doorloopt als de rest van je code. Dat verschil is geen detail, het is de keuze.
Wat een skill niet is
Geen model, geen koppeling en geen agent. Een skill verandert niet wat Claude kan weten, alleen hoe hij jouw werk aanpakt. Toegang tot jouw systemen is een andere laag: daar gaat MCP over, de open standaard voor verbindingen tussen databronnen en AI-toepassingen [S-001], uitgelegd in wat is MCP.
Het verschil in één regel: een skill is werkwijze, MCP is toegang. Je hebt ze vaak samen nodig en ze lossen verschillende problemen op. In Claude Code zit daar nog een derde laag bij, want skills verpakken daar herhaalbare werkwijzen die een team kan delen [S-048].
Hoe veilig is een skill van iemand anders?
Behandel hem als software die je installeert. Dat is niet onze formulering maar die van de documentatie: gebruik skills alleen uit vertrouwde bron, want een skill geeft Claude nieuwe mogelijkheden via instructies en code, en een kwaadwillende skill kan Claude dingen laten doen die niet bij het gestelde doel horen [S-062].
De bijbehorende werkafspraak is dus simpel en zelden gemaakt: iemand leest de skill voordat hij in gebruik gaat. Alle bestanden, niet alleen SKILL.md, want scripts en resources horen er net zo bij [S-062]. In een repository is dat een pull request. In claude.ai is het een afspraak, want daar zit geen beheerlaag tussen [S-060].
Een skill die data van externe URL’s ophaalt verdient extra aandacht, omdat opgehaalde inhoud instructies kan bevatten [S-062]. Voor een eerste eigen skill is dat zelden aan de orde: begin bij een werkwijze die jullie al op papier hebben.
Veelgestelde vragen
Wat is het verschil tussen een skill en een prompt? Een prompt is een instructie op gespreksniveau voor een eenmalige taak; een skill laadt op verzoek, zodat dezelfde uitleg niet per gesprek herhaald wordt [S-055]. Praktisch: een prompt verdwijnt met het gesprek, een skill is een bestand dat je nakijkt en overdraagt.
Kunnen we skills centraal beheren voor ons hele team? In claude.ai niet: eigen skills zijn daar van de individuele gebruiker, moeten per teamlid worden geüpload en zijn niet centraal te beheren of organisatiebreed te verspreiden [S-060]. Via de API zijn ze workspace-breed, en in Claude Code deel je ze via het project, dus via je repository [S-060].
Werkt een skill uit claude.ai ook op de API? Niet automatisch. Eigen skills synchroniseren niet tussen surfaces: je uploadt ze apart per omgeving waar je ze wilt gebruiken [S-059]. Houd daar rekening mee bij het bedenken van je beheerproces, anders staan er twee versies van dezelfde werkwijze naast elkaar.
Hoeveel skills kun je installeren? Veel. Tot een skill getriggerd wordt, bezetten alleen zijn naam en beschrijving context, ongeveer 100 tokens per skill [S-056, S-057]. De beperking zit niet in het aantal maar in de kwaliteit van elke beschrijving, want die bepaalt of Claude de juiste skill kiest.
Wil je weten welke werkwijze in jouw bedrijf zich als skill laat vastleggen, en wie hem daarna beheert? Dat is precies wat een training of workshop oplevert, of plan een gesprek. Werk dat een eigen ingang verdient groeit soms uit tot een eigen AI-tool; wat WeAdapt daarin bouwt en oplevert staat in de veelgestelde vragen.