Claude skills: de complete catalogus, met installeren en zelf maken

De basis

Wat een skill is, en waarom hij bijna niets kost

Anthropics eigen definitie is kort: skills zijn mappen met instructies, scripts en bronbestanden die Claude laadt wanneer hij ze nodig heeft. In de map zit minimaal een bestand SKILL.md, met bovenin twee regels YAML (een naam en een beschrijving) en daaronder gewone tekst. Dat is alles. Het verschil met een prompt die je steeds opnieuw plakt, zit in het moment waarop hij laadt.

Progressive disclosure: waarom je er tientallen kunt hebben

Skills laden in drie niveaus. Niveau 1 is de metadata (naam plus beschrijving) en die staat altijd geladen, ongeveer 100 tokens per skill. Niveau 2 is de inhoud van SKILL.md, en die laadt pas op het moment dat de skill aanslaat; Anthropic adviseert die onder de 5.000 tokens te houden. Niveau 3 zijn de meegeleverde bestanden en scripts: die kosten nul tokens tot Claude ze echt opent, en van een script komt alleen de uitvoer in je gesprek, nooit de code zelf. Daardoor kun je veel skills tegelijk installeren zonder dat je contextvenster volloopt. Dat is precies waarom Anthropic dit format bedacht heeft.

De beschrijving is de schakelaar

Bij het opstarten laadt Claude alleen naam en beschrijving van elke skill. Daar matcht hij jouw vraag tegen. Een beschrijving als "Helpt met documenten" slaat daarom vrijwel nooit aan, want daar zit geen herkenbare situatie in. De formule die Anthropic zelf voorschrijft is: eerst wat de skill doet, dan wanneer je hem gebruikt, met de woorden die mensen echt typen. En altijd in de derde persoon, want de tekst wordt in de systeemprompt geplakt en een wisselend perspectief verstoort de herkenning.

De drie officiele kanalen, en waarom die scheiding ertoe doet

Dit is het punt waar de meeste artikelen de mist ingaan. Anthropic verdeelt officiele skills over drie kanalen die elkaar niet overlappen.

1. De ingebouwde documentskills (pptx, xlsx, docx, pdf) zitten kant en klaar in claude.ai, de Claude API, Claude Platform op AWS en Microsoft Foundry. Je installeert niets. Zeg "maak hier een deck van" en de pptx-skill draait. Belangrijke uitzondering: in Claude Code zitten deze vier juist NIET.

2. De bundled slash-skills in Claude Code zijn een compleet andere set, die je aanroept als commando: /code-review, /batch, /dataviz en tien anderen. Die zitten in de CLI zelf en zijn er dus alleen als je Claude Code gebruikt.

3. De open repo anthropics/skills bevat zeventien skills en is tegelijk zijn eigen plugin-marketplace, onder de naam anthropic-agent-skills. Daar staan de documentskills ook in, als broncode, plus dertien skills die je alleen krijgt als je ze installeert.

Skills zijn geen Claude-only formaat

Anthropic bracht Agent Skills uit op 16 oktober 2025 en publiceerde het formaat later als open standaard op agentskills.io. Het wordt inmiddels gelezen door onder meer Cursor, GitHub Copilot, VS Code, OpenAI Codex, Gemini CLI, OpenCode, Goose, Roo Code, Kiro, Databricks en Snowflake. Een skill die je volgens de specificatie schrijft, werkt in principe dus ook buiten Claude. Voor bedrijven die niet iedereen op dezelfde AI-tool hebben zitten, is dat de belangrijkste eigenschap van het hele formaat.

Wanneer je er een maakt

De vuistregel uit de Claude Code-documentatie: maak een skill zodra je dezelfde instructies, checklist of meerstapsprocedure voor de derde keer in een gesprek plakt, of zodra een stuk van je CLAUDE.md is uitgegroeid van feiten naar een procedure. Het verschil met CLAUDE.md-inhoud is dat de body van een skill pas laadt wanneer hij gebruikt wordt, dus lang referentiemateriaal kost je vrijwel niets tot je het nodig hebt.

Officieel

De zeventien officiele skills van Anthropic, met wat ze doen

De repo anthropics/skills stond op 1 augustus 2026 op 165.575 sterren en 19.689 forks, met als laatste wijziging 24 juli 2026. In de map skills/ staan precies zeventien skills. Vier daarvan zijn de documentskills die op claude.ai en de API al aanstaan; de andere dertien installeer je zelf. Anthropic zegt er zelf bij dat de repo bedoeld is als demonstratie en leermateriaal.

De dertien niet-documentskills installeer je in een keer

Anthropic bundelt ze als plugin. In Claude Code doe je:

/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills

Wil je de documentskills tóch in Claude Code hebben, dan installeer je daarnaast document-skills@anthropic-agent-skills. Een losse skill kan ook, met de skills-CLI: npx skills add https://github.com/anthropics/skills --skill claude-api. Dat werkt in elke omgeving die Agent Skills leest.

Let op de licentie als je gaat kopieren

De vier documentskills (docx, pdf, pptx, xlsx) dragen in hun frontmatter de licentie "Proprietary. LICENSE.txt has complete terms". De overige skills in de repo staan onder Apache 2.0. De repo is voor die vier dus source-available en niet volledig open source. Wil je een documentskill forken naar je eigen bedrijfsversie, dan is dat het punt om eerst na te lezen. Voor brand-guidelines, theme-factory en internal-comms geldt dat bezwaar niet: die zijn juist bedoeld om te kopieren en te vernederlandsen.

De officiele marktplaats is een vierde kanaal

Naast de skills-repo bestaat de marketplace claude-plugins-official, die Claude Code bij de eerste start automatisch toevoegt. Daar staan op 1 augustus 2026 276 plugins, waarvan er 38 het author-veld Anthropic dragen: onder meer code-review, code-simplifier, plugin-dev, mcp-server-dev, security-guidance, claude-security, claude-md-management, claude-code-setup, feature-dev, hookify, session-report en twaalf LSP-plugins (voor Python, TypeScript, Go, Rust, Java, Kotlin, Ruby, PHP, C#, C/C++, Swift en Lua). Bladeren doe je met /plugin of via claude.com/plugins. De aparte community-marketplace claude-community telde die dag 2.307 plugins, elk vastgepind op een commit-SHA en door geautomatiseerde validatie en veiligheidsscreening gehaald.

Wat Anthropic zelf aanraadt

Een officiele lijst met "beste skills" publiceert Anthropic niet. In documentatie en blogposts komen vier namen steeds terug als voorbeeld: pdf (in de engineering-blog), skill-creator en mcp-builder (als leervoorbeelden in de repo) en claude-api (met een eigen documentatiepagina). Voor taalservers is het advies wel expliciet: gebruik de kant-en-klare LSP-plugins uit de officiele marketplace in plaats van zelf te bouwen.

Claude Code

De dertien skills die al in Claude Code zitten

Gebruik je Claude Code, dan heb je een set skills die je nergens hoeft te installeren. Ze zijn herkenbaar omdat je ze als slash-commando typt. Het verschil met de gewone ingebouwde commando's is dat deze prompt-gebaseerd zijn: het zijn instructies aan het model, geen vaste code die uitgevoerd wordt.

Uitzetten kan, op een na

Kosten deze skills je te veel context of wil je ze gewoon niet zien, dan zet je ze allemaal uit met de instelling disableBundledSkills. Die schakelt elke bundled skill uit behalve /doctor. Wil je /doctor er ook uit hebben, dan doe je dat apart met de omgevingsvariabele DISABLE_DOCTOR_COMMAND of met een skillOverrides-regel die doctor op off zet. Zet je een eigen skill met dezelfde naam in je project of in ~/.claude/skills/, dan overschrijft die de bundled versie: een eigen code-review-skill vervangt dus /code-review.

Custom commands en skills zijn samengevoegd

Had je al bestanden in .claude/commands/, dan blijven die gewoon werken. Een bestand op .claude/commands/deploy.md en een skill op .claude/skills/deploy/SKILL.md leveren allebei /deploy, met dezelfde frontmatter. Wat een skill extra biedt is een map voor ondersteunende bestanden, frontmatter waarmee je bepaalt wie hem mag aanroepen, en automatisch laden door Claude wanneer hij relevant is. Voor nieuwe workflows adviseert Anthropic de skill-vorm. Botsen een skill en een command op naam, dan wint de skill.

Community

De populairste community-skills, met de sterren van 1 augustus 2026

Eerst de belangrijkste kanttekening, want die bepaalt hoe je deze cijfers moet lezen. GitHub kent geen sterren per skill, alleen per repository. Elke bron die een sterrenaantal aan een losse skill hangt, verzint dat. Alle getallen hieronder zijn dus repo-cijfers, live opgehaald via de GitHub API op 1 augustus 2026. En sterren meten interesse, niet kwaliteit en niet gebruik: een repo van drie dagen oud kan er duizenden verzamelen zonder dat iemand hem draait.

Superpowers is groter dan de officiele repo

Het opvallendste cijfer in de tabel: obra/superpowers heeft met 264.654 sterren en 23.621 forks ruim anderhalf keer zoveel sterren als de officiele repo van Anthropic. Het zijn precies veertien skills, en ze gaan niet over een onderwerp maar over een werkwijze. test-driven-development weigert implementatiecode te schrijven voordat er een falende test ligt. systematic-debugging verbiedt een fix voor te stellen voordat de oorzaak vaststaat. brainstorming stelt eerst socratische vragen. Er zit ook een instap-skill in, using-superpowers, die aan het begin van elk gesprek afdwingt dat Claude eerst een passende skill zoekt. Dat verklaart waarom gebruikers het als een compleet werkframework ervaren en niet als losse hulpjes. Installeren gaat via /plugin marketplace add obra/superpowers-marketplace, of via de officiele marketplace met /plugin install superpowers@claude-plugins-official.

Installatiecijfers vertellen een ander verhaal dan sterren

Op claude.com/plugins staan wel echte installatieaantallen, en die rangschikking ziet er anders uit. Op 1 augustus 2026: Frontend Design 1.134.112, Superpowers 1.009.371, Code Review 438.525, Context7 417.801 en Skill Creator 385.083. Die lijst is sterk ontwikkelaarsgericht. De zakelijke Cowork-plugins tonen geen teller, dus over hun populariteit valt niets hards te zeggen. Wat je hieruit wel kunt afleiden: de skills die mensen echt installeren zijn de saaie, herhaalbare (design, review, referentie), niet de spectaculaire.

Twee waarschuwingen bij de verzamellijsten

Ten eerste: gsd-build/get-shit-done (64.784 sterren) en obra/superpowers-skills (735 sterren) zijn allebei gearchiveerd, maar staan nog altijd in verzamellijsten die niet zijn bijgewerkt. Een gearchiveerde repo krijgt geen fixes meer. Ten tweede: karanb192/awesome-claude-skills (448 sterren) geeft elke skill een decoratieve rating van drie tot vijf sterretjes die niets meet, schrijft vier skills toe aan superpowers die daar niet bestaan, en vermeldt tientallen items met de status "Community-needed", dus skills die nog helemaal niet gemaakt zijn. Controleer wat je uit een lijst overneemt altijd tegen de repo zelf. Een GitHub-zoekopdracht op "claude skills" in de repo-naam gaf die dag 10.948 resultaten; het ecosysteem zit vol met forks en herverpakkingen van dezelfde skills.

Kleinere skills die wel een duidelijke taak hebben

Onder de honderdduizenden sterren zit een laag die je makkelijk mist. Geverifieerd op 1 augustus 2026: zubair-trabzada/ai-legal-claude (1.602 sterren, contractreview, geen licentiebestand dus commercieel gebruik eerst nakijken), conorluddy/ios-simulator-skill (1.194, de iOS-simulator aansturen), alonw0/web-asset-generator (477, favicons, app-icons en social images), K-Dense-AI/claude-skills-mcp (395, een MCP-server die skills doorzoekbaar maakt met vector search), evolsb/claude-legal-skill (390, contractreview met risicodetectie, MIT), chrisvoncsefalvay/claude-d3js-skill (217, d3.js-visualisaties), jthack/ffuf_claude_skill (202, web fuzzing bij pentesten), EveryInc/hands-on-deck (199, PowerPoint bewerken via atomaire JSON-patches) en Akxan/ppt-agent-skill (116, presentaties met 26 stijlen en 18 grafiektypes).

Per afdeling

Skills voor zakelijk werk, per afdeling

Sinds Anthropic de repo knowledge-work-plugins heeft opengesteld (23.216 sterren op 1 augustus 2026) hoef je voor kantoorwerk niet meer bij de community te beginnen. Elke afdelingsplugin bundelt vier dingen: skills die Claude vanzelf oppakt, connectors via .mcp.json, slash-commando's die je zelf aanroept, en sub-agents. Ze zijn primair gebouwd voor Claude Cowork, maar draaien ook in Claude Code.

Installeren en het voorbehoud dat Anthropic er zelf bij zet

In Claude Cowork installeer je ze met een klik via claude.com/plugins. In Claude Code:

claude plugin marketplace add anthropics/knowledge-work-plugins
claude plugin install sales@knowledge-work-plugins

Lees wel eerst de disclaimers, want Anthropic zet ze er zelf bij en ze zijn niet vrijblijvend. Bij Small Business: de plugin geeft geen financieel, fiscaal, juridisch of HR-advies en je moet alle uitvoer nakijken, waar nodig door een professional. Bij Legal: alle uitvoer moet door een bevoegd jurist worden beoordeeld. Bij Finance: alle uitvoer moet door een gekwalificeerde financial worden gecontroleerd voordat het in een rapportage of aangifte belandt.

Het gat voor Nederlandse mkb-bedrijven

Dit moet je weten voordat je de Small Business-plugin op je administratie loslaat: in de officiele connectordirectory van Anthropic (405 connectors op 1 augustus 2026) zit geen enkele Nederlandse boekhoudkoppeling. Geen Moneybird, Exact, e-Boekhouden, Twinfield, AFAS, Yuki, SnelStart, Visma of Nmbrs. Wel aanwezig: Xero, Zoho Books, Intuit QuickBooks, Gusto, Qonto, DocuSign, SignNow en PandaDoc. De Small Business-plugin leunt op QuickBooks, PayPal en HubSpot. De praktische omweg is de Zapier-plugin, die Claude aan meer dan 8.000 apps koppelt, of een MCP-server voor je eigen pakket. Hetzelfde geldt inhoudelijk: de fiscale en arbeidsrechtelijke onderdelen van de officiele plugins zijn op het Amerikaanse stelsel gebouwd.

AVG-werk: de enige plugin die daar echt op zit

Voor Nederlandse organisaties is privacy-legal uit anthropics/claude-for-legal (8.979 sterren) het relevantste onderdeel: het triageert verwerkingsactiviteiten, genereert DPIA's, beoordeelt verwerkersovereenkomsten vanuit de rol van verwerkingsverantwoordelijke of verwerker, stelt antwoorden op inzageverzoeken op binnen de wettelijke termijn en signaleert wanneer beleid en praktijk uit elkaar zijn gaan lopen. Behandel dat als voorwerk voor je jurist, niet als vervanging. De bredere context staat op Privacy en zakelijk gebruik.

Wat de community hier bovenop biedt

Drie verzamelingen die het waard zijn om te bekijken, met sterren van 1 augustus 2026. coreyhaines31/marketingskills (42.600) bevat 48 losse marketingskills onder MIT-licentie, van copywriting en CRO tot programmatic SEO, schema-markup, e-mailreeksen, prijsstelling en churn-preventie. openaccountant/skills (47 sterren) heeft 44 financiele skills waaronder cashflowprognose, break-evenberekening en klantwinstgevendheid, maar de belastingskills daarin zijn puur Amerikaans. En in ComposioHQ/awesome-claude-skills (71.523) zitten praktische losse skills zoals invoice-organizer (rommelige mappen met bonnen opruimen voor de boekhouding), lead-research-assistant, meeting-insights-analyzer en content-research-writer, plus 832 automatisch gegenereerde connector-skills.

Partner-skills die je in de directory tegenkomt

In de directory op claude.ai en op claude.com/plugins staan ook skills die door de leverancier zelf zijn gebouwd. Anthropic noemt Notion, Figma en Atlassian expliciet als partners in de skills-directory, en op de productpagina komen daar Box, Rakuten en Canva bij. Concreet bruikbaar voor marketingteams: de Canva-plugin (1.094 installaties op 1 augustus 2026) met zes skills voor ontwerpen bewerken, in een keer herschalen voor meerdere kanalen, bulkontwerpen uit spreadsheetdata en een merkkitcontrole op kleur, typografie en toon. Bulk-create daarin vereist wel Canva Enterprise.

Vorm van het antwoord

Skills die de vorm van het antwoord veranderen

Er is een hele categorie skills die niets toevoegt aan wat Claude weet, maar iets verandert aan hoe het antwoord eruitziet: korter, met de conclusie vooraan, met genummerde stappen, met een lijst die op vijf items stopt. Ze zijn populair bij mensen die merken dat lange antwoorden hen afleiden, maar ze zijn nuttig voor iedereen die korte, gestructureerde antwoorden wil. Wat hieronder staat is een feitelijke beschrijving van wat deze skills technisch doen. Het is geen medisch advies en geen van deze skills behandelt, verlicht of vervangt iets.

Begin zonder iets te installeren

Voordat je een skill zoekt: drie officiele instellingen doen al een deel van het werk. Op claude.ai zet je onder Instructions for Claude je algemene voorkeuren neer, bijvoorbeeld dat je de conclusie vooraan wilt, maximaal drie opties en geen inleiding. In Claude Code doe je hetzelfde met een output style: een markdownbestand in ~/.claude/output-styles of .claude/output-styles dat de systeemprompt aanpast. Naast Default zijn er drie ingebouwde stijlen (Proactive, Explanatory en Learning) en je stelt ze in via /config. Let op twee dingen: de stijl gaat pas in na /clear of een nieuwe sessie, en hij geldt alleen voor het hoofdgesprek, want een subagent draait zijn eigen systeemprompt. Wil je eerst zien wat er gaat gebeuren voordat er iets verandert, dan zet je plan mode aan met Shift+Tab.

De officiele pauzefunctie

Anthropic heeft hier zelf iets voor, maar niet als skill. Onder Settings > Time and focus stel je break reminders en quiet hours in. Een break reminder geeft een seintje nadat je een door jou ingesteld aantal minuten met Claude bezig bent geweest op een dag; quiet hours voegen wrijving toe op dagen en tijdvakken die je zelf kiest. Anthropic schrijft er expliciet bij dat het geen van beide een harde blokkade is: je kunt er altijd doorheen. De functie is beta en de documentatie noemt alleen Free, Pro en Max. Je stelt het in op web of desktop en het geldt daarna op web, desktop en mobiel.

i-have-adhd: tien regels voor de vorm van het antwoord

De grootste skill in deze categorie is ayghri/i-have-adhd, met 15.003 sterren en 826 forks op 1 augustus 2026, MIT-licentie, laatst gewijzigd op 31 juli 2026. Wat de SKILL.md letterlijk voorschrijft, zijn tien regels: (1) begin met de eerstvolgende actie, (2) nummer meerstapstaken, (3) eindig met een concrete volgende stap, (4) onderdruk zijpaden, (5) herhaal elke beurt de stand van zaken, (6) geef tijdsinschattingen in minuten in plaats van "even werk", (7) maak voortgang zichtbaar, (8) meld fouten zakelijk, (9) cap lijsten op vijf items, (10) geen preambule, geen samenvatting achteraf, geen afsluiter. De frontmatter zet disable-model-invocation op true, dus Claude activeert hem nooit uit zichzelf: je typt /i-have-adhd en hij blijft aan tot je "stop adhd mode" zegt. De repo bevat naast de Claude Code-plugin ook mappen voor Codex, Cursor en een Gemini-extensie.

Valkuil 1: een repo die zo heet maar iets anders doet

Zoek je op "adhd claude", dan komt UditAkhourii/adhd (3.030 sterren op 1 augustus 2026) hoog naar boven. Ondanks de naam is dat geen hulpskill. Het is een redeneertechniek die metaforisch zo heet: de skill start meerdere geisoleerde redeneerprocessen onder bewust vervormde denkkaders en snoeit die daarna terug, bedoeld voor ontwerpbeslissingen, vaag debuggen en naamgeving. De eigen omschrijving noemt het "an architectural fix for premature convergence in autoregressive reasoning". Wie hem installeert omdat hij korte, gestructureerde antwoorden verwacht, krijgt iets heel anders. The New Stack kopte er in 2026 over dat externe experts meer bewijs willen voor de prestatieclaim; wij hebben alleen die kop kunnen ophalen, niet het artikel zelf, dus we laten de inhoud van die kritiek open.

Valkuil 2: een repo die het omgekeerde doet

liigoQi/defficiency-skills (151 sterren, MIT, laatst gewijzigd 28 juni 2026) presenteert zich als een verzameling anti-productiviteitsskills en levert een ADHD-modus en een ASD-modus. Die skills laten de agent kenmerken van ADHD en autisme *nadoen* (moeite met beginnen, gedachtesprongen, snel afgeleid raken, zwak tijdsbesef) met als uitgesproken doel de agent minder effectief te maken. De maker omschrijft het zelf als performance art. Dat is iets heel anders dan wat iemand zoekt die zijn antwoorden korter en overzichtelijker wil hebben, en het staat hier alleen zodat je het herkent voordat je het installeert.

De rest van de categorie, met sterren

Als de vorm van het antwoord je hoofdprobleem is, zijn dit de andere geverifieerde opties (sterren en laatste wijziging per 1 augustus 2026). JuliusBrussee/caveman (95.018 sterren) is de populairste "minder ruis"-skill die bestaat en snijdt naar eigen zeggen 65 procent van de tokens weg, maar wel door de grammatica te vervormen; als contrast interessant, voor zakelijke uitvoer minder bruikbaar. o4f6bgpac3/concise (3 sterren) doet hetzelfde in normaal, leesbaar Engels. ravila4/claude-adhd-skills (116 sterren, sinds 1 maart 2026 niet meer bijgewerkt) combineert skills met hooks en zet daarmee de huidige datum en tijd in elke prompt, wat een skill zelf niet kan. JackReis/neurodivergent-visual-org (57 sterren, bijgewerkt 28 juli 2026) maakt taakopdelingen en beslisbomen als Mermaid-diagram, met een kleurenblind-veilige en een monochrome uitvoervariant. dsx0511/adhd-copilot (26 sterren) hakt taken op tot een eerste stap en signaleert wanneer een onderzoeksgesprek zich vertakt zonder dat er iets wordt afgerond; let op dat deze repo geen licentie heeft, wat hergebruik juridisch onduidelijk maakt.

Het patroon dat je ook zonder skill kunt gebruiken

Wat opvalt als je deze skills naast elkaar legt: vijf onafhankelijk gebouwde projecten komen op hetzelfde uit. Conclusie eerst, maximaal een paar opties in plaats van een muur suggesties, en altijd een concrete volgende stap. Dat kun je ook gewoon opschrijven in je eigen instructies, zonder iets te installeren: "Begin met het antwoord. Geef maximaal drie opties. Sluit af met een concrete volgende stap. Cap lijsten op vijf items." Dat is in de praktijk de goedkoopste versie van deze hele categorie.

Waar deze skills vandaan komen, en wat dat betekent

Anthropic heeft in deze categorie niets: de zeventien officiele skills gaan over documenten, ontwerp en ontwikkelwerk, en er zit geen focus-, productiviteits- of toegankelijkheidsskill bij. Alles hierboven is dus community-werk, zonder toetsing door Anthropic, zonder review en zonder garantie dat het volgende maand nog wordt onderhouden. Behandel ze zoals elke skill van derden: open het SKILL.md-bestand, lees wat er staat, kijk naar de datum van de laatste wijziging en naar de licentie, en installeer pas daarna. De makers zelf zijn hier trouwens opvallend zorgvuldig in: meerdere schrijven expliciet in hun README dat er geen diagnose voor nodig is en dat het geen vervanging is van professionele ondersteuning.

Plannen

Zitten skills in mijn abonnement?

Kort antwoord: ja, in vrijwel elk abonnement, maar er is een voorwaarde en er is een bronconflict dat we eerlijk melden.

De voorwaarde: code-uitvoering moet aanstaan

Het supportartikel over skills gebruiken in Claude is duidelijk: skills zijn beschikbaar op Free, Pro, Max, Team en Enterprise, met als voorwaarde dat code-uitvoering aanstaat. Op Free, Pro en Max zet je die zelf aan onder Settings en dan Capabilities. Op Team en Enterprise moet een organisatie-eigenaar eerst twee schakelaars omzetten: "Code execution and file creation" en "Skills". Staat een van beide uit, dan zie je het menu niet en werkt er niets. Voor code-uitvoering en bestandscreatie geldt daarbij een verschil dat je moet kennen: op Free, Pro en Max staat het standaard aan met netwerktoegang aan, op Team en Enterprise staat het aan met netwerktoegang standaard uit.

Het bronconflict, en wat je ermee doet

Anthropics eigen bronnen spreken elkaar hier tegen. Het supportartikel noemt Free tot en met Enterprise. De platform-documentatie beschrijft custom skills op claude.ai als iets dat vanaf Pro beschikbaar is. Wij hebben dat verschil niet kunnen oplossen zonder op elk plan in te loggen, dus we melden het zoals het is. Praktisch: reken erop dat het uploaden van je eigen skill een betaald abonnement vraagt, en dat de vier ingebouwde documentskills breder beschikbaar zijn. Kom je bedrogen uit, dan zit het in dit verschil en niet in jouw instellingen.

Wat wel per plan verschilt

Drie dingen zijn wel eenduidig gedocumenteerd. Skills opnemen door je scherm op te nemen (Record a skill) bestaat alleen in Cowork in Claude voor Mac, op Pro, Max en Team. Dus niet in gewone chat, niet op Windows, niet op Free, en opvallend genoeg ook niet op Enterprise. Organisatiebreed skillbeheer bestaat alleen op Team en Enterprise. En netwerktoegang bij code-uitvoering is op Team en Enterprise instelbaar door de beheerder in vier standen (zie de veiligheidssectie).

Wat het via de API kost aan grenzen

Gebruik je skills via de Claude API, dan gelden er harde limieten in plaats van planvoorwaarden: maximaal 8 skills per request en maximaal 30 MB per skill. Je hebt de code execution tool nodig en de beta-header skills-2025-10-02 (plus files-api-2025-04-14 als je de Files API gebruikt). De vier ingebouwde skills roep je aan met een skill_id (pptx, xlsx, docx of pdf) in de container-parameter; eigen skills upload je via de /v1/skills-endpoints. Nog een punt voor je verwerkingsregister: Agent Skills valt niet onder zero data retention-afspraken. Skilldefinities en uitvoeringsdata worden bewaard volgens het standaard bewaarbeleid van Anthropic.

Installeren

Skills installeren, per oppervlak

Er is geen ene manier om een skill te installeren, en dat is de grootste bron van verwarring. Elk oppervlak heeft zijn eigen route, en ze synchroniseren niet met elkaar. Een skill die je op claude.ai uploadt bestaat niet in de API en niet in Claude Code, en omgekeerd. Anthropic adviseert daarom je bronbestanden in Git te bewaren als enige bron van waarheid en zelf te zorgen dat de kopieen gelijk blijven.

Op claude.ai: let op de structuur van je zipbestand

Dit is de klassieker waar uploads op stuklopen. De skillmap moet de root van het zipbestand zijn: dus een zip met daarin de map offerte-opvolgmail/ met daarin SKILL.md. Niet de bestanden los in de zip-root, en niet nog een map eromheen. Verder gelden op claude.ai strengere limieten dan in de specificatie: het supportartikel noemt maximaal 64 tekens voor de naam en maximaal 200 tekens voor de beschrijving, terwijl de open standaard 1.024 tekens toestaat. Houd je aan de 200, dan werkt je skill overal.

In Claude Code: vier locaties met een vaste rangorde

Claude Code leest skills uit vier plekken. Enterprise (via managed settings) gaat voor persoonlijk (~/.claude/skills/naam/SKILL.md), en persoonlijk gaat voor project (.claude/skills/naam/SKILL.md). Alle drie overschrijven een bundled skill met dezelfde naam. Pluginskills krijgen de namespace plugin-naam:skill-naam en botsen dus nooit.

Twee details die je uren kunnen kosten. Bij het opstarten laden projectskills uit .claude/skills/ in je startmap en in elke bovenliggende map tot de repo-root, maar skills in geneste .claude/skills/-mappen ONDER je startmap laden pas zodra Claude voor het eerst een bestand in die submap opent; tot dat moment staan ze niet in autocomplete. En mappen die je toevoegt met --add-dir of /add-dir laden hun .claude/skills/ wel, terwijl de instelling permissions.additionalDirectories dat juist niet doet.

Wijzigingen worden live opgepikt

Bewerk je een SKILL.md terwijl Claude Code draait, dan pikt hij dat binnen dezelfde sessie op. Herstarten hoeft niet. Twee uitzonderingen: maak je een top-level skills-map aan die er bij sessiestart nog niet was, dan moet je wel herstarten, en gaat het om een skillmap die tegelijk plugin is, dan vereisen wijzigingen in hooks/, .mcp.json, agents/ en output-styles/ een /reload-plugins.

Waar je hem installeert bepaalt wat hij mag

Een detail dat pas opvalt als je een skill maakt die iets ophaalt: netwerktoegang verschilt per oppervlak. In Claude Code heeft een skill volledige netwerktoegang, net als elk ander programma op je machine. Via de API draait de code in een container zonder netwerktoegang en zonder de mogelijkheid om tijdens de run pakketten te installeren, met een maximum van acht skills per verzoek. Op claude.ai hangt het af van de instellingen van jou of je beheerder: volledig, gedeeltelijk of geen netwerk. Dezelfde skill kan dus op het ene oppervlak werken en op het andere stilvallen. De vier standen die een beheerder kan zetten staan in de veiligheidssectie hieronder.

De directory op claude.ai

Sinds de samengevoegde directory vind je skills, connectors en plugins op een plek: Customize in de linkerzijbalk, het juiste tabblad, dan de plus-knop en "Browse skills". Je ziet er vier soorten skills: die van Anthropic (documentcreatie), je eigen custom skills, skills die je organisatie heeft geprovisioneerd, en partner-skills van onder meer Notion, Figma en Atlassian. Klik op Install en de skill staat aan; Claude gebruikt hem daarna vanzelf wanneer hij relevant is. Uitzetten kan altijd zonder verwijderen. Op Team en Enterprise toont een apart tabblad "Your organization" wat er organisatiebreed is gedeeld.

Zelf bouwen

Zelf een skill maken: een compleet voorbeeld om te kopieren

Je hebt geen programmeerkennis nodig. Wat je nodig hebt is het vermogen om je eigen werkwijze op te schrijven zoals je die aan een nieuwe collega zou uitleggen. Hieronder staat een compleet SKILL.md voor een scenario dat in vrijwel elk Nederlands B2B-bedrijf voorkomt: de opvolgmail na een verstuurde offerte.

De twee velden die moeten kloppen

Het veld name mag maximaal 64 tekens zijn, alleen kleine letters, cijfers en koppeltekens bevatten, niet met een koppelteken beginnen of eindigen, geen dubbele koppeltekens hebben, en moet exact gelijk zijn aan de mapnaam. De woorden claude en anthropic zijn niet toegestaan. Ongeldige voorbeelden uit de documentatie: PDF-Processing (hoofdletters), -pdf (begint met een koppelteken) en pdf--processing (dubbel koppelteken). Anthropic adviseert de gerundiumvorm of een naamwoordgroep: processing-pdfs, spreadsheet-analysis, offerte-opvolgmail. Vermijd vage namen als helper, utils of tools.

Het veld description is de schakelaar die bepaalt of je skill ooit aanslaat. Zet er wat de skill doet in, plus wanneer je hem gebruikt, met de woorden die jouw collega's echt typen. Derde persoon, altijd.

Compleet SKILL.md voor een Nederlandse offerte-opvolging

---
name: offerte-opvolgmail
description: Schrijft een Nederlandse opvolgmail na een verstuurde offerte, met de bezwaren uit het gesprek en een concrete vervolgstap. Gebruik bij offerte opvolgen, nabellen, follow-up, of als er salesnotities gedeeld worden.
license: Intern gebruik
metadata:
version: "1.0"
eigenaar: sales
---

Je schrijft de mail die wij sturen nadat een offerte is verstuurd en het eerste gesprek is geweest.

Vraag eerst om deze vier dingen als ze er niet zijn. Verzin ze nooit:
1. De naam van het bedrijf en van de contactpersoon.
2. Wat er in de offerte staat: dienst, prijs, looptijd.
3. De notities of het transcript van het gesprek.
4. De afgesproken vervolgstap, als die er is.

Vaste opbouw, altijd in deze volgorde:
1. Een openingszin die verwijst naar iets concreets uit het gesprek. Geen "leuk je te spreken".
2. Een zin die de offerte samenvat in hun woorden, niet in de onze.
3. Het belangrijkste bezwaar uit het gesprek, letterlijk benoemd, met ons antwoord erop in maximaal drie zinnen.
4. Een vervolgstap met een datum en een tijd, als voorstel geformuleerd.
5. Ondertekening volgens assets/handtekening.md.

Regels voor de toon:
- Je-vorm. Korte zinnen. Geen superlatieven en geen uitroeptekens.
- Nooit "ik hoor graag van je" als afsluiting. Zet er een concreet voorstel neer.
- Noem de prijs alleen opnieuw als de klant er in het gesprek zelf over begon.
- Maximaal 180 woorden. Wordt het langer, schrap dan punt 3 tot een enkele zin.

Regels voor bezwaren:
- Herhaal het bezwaar eerst in hun eigen bewoording voordat je erop reageert.
- Is het bezwaar prijs, verwijs dan naar references/prijsbezwaren.md.
- Is het bezwaar timing, stel dan een concrete datum voor waarop je terugkomt.
- Staat er geen bezwaar in de notities, sla punt 3 dan over en zeg dat erbij.

Lever de mail als platte tekst, met een onderwerpregel erboven. Geef daarnaast in een zin aan welke informatie je miste.

De mapstructuur eromheen

De skill uit het voorbeeld is een map, geen los bestand:

offerte-opvolgmail/
SKILL.md
references/prijsbezwaren.md
assets/handtekening.md

De specificatie kent drie standaardmappen. scripts/ voor uitvoerbare code die self-contained moet zijn of zijn afhankelijkheden duidelijk noemt. references/ voor achtergrondinformatie die Claude er op verzoek bij pakt. assets/ voor sjablonen, afbeeldingen en datafiles. Verwijs vanuit SKILL.md altijd expliciet naar die bestanden, anders weet Claude niet wanneer hij ze moet openen. Houd SKILL.md zelf onder de 500 regels en houd verwijzingen een niveau diep: bij geneste verwijzingsketens leest Claude bestanden soms maar half in en werkt hij met onvolledige informatie. Gebruik altijd forward slashes in paden, ook op Windows.

Maak hem bewust een beetje dwingend

Dit advies staat niet in de gewone documentatie maar wel in de SKILL.md van Anthropics eigen skill-creator, en het is het nuttigste dat we tegenkwamen: Claude heeft op dit moment de neiging skills te ondertriggeren, dus ze niet te gebruiken op momenten waarop ze wel zouden helpen. De remedie is je beschrijving iets pusheriger schrijven. Dus niet "Hoe je een dashboard bouwt", maar "Hoe je een dashboard bouwt. Gebruik deze skill zodra iemand dashboards, datavisualisatie of interne cijfers noemt, ook als er niet expliciet om een dashboard gevraagd wordt." Alle "wanneer"-informatie hoort in de beschrijving, niet in de body: de body is voor uitvoeren, de beschrijving voor kiezen.

Schrijf instructies met een reden erbij

De skill-creator adviseert de gebiedende wijs en een uitleg waarom iets belangrijk is, in plaats van een muur hoofdletters. De eval-gids bevestigt dat: "Doe X, omdat Y meestal Z veroorzaakt" werkt beter dan "ALTIJD X, NOOIT Y", omdat modellen instructies betrouwbaarder volgen als ze het doel snappen. Wordt een regel structureel genegeerd, dan mag je alsnog opschalen naar hardere taal ("MUST filter" in plaats van "always filter"). Stem daarbij de mate van detail af op hoe fragiel de taak is: bij een taak waar meerdere aanpakken kloppen geef je richting, bij een taak waar een fout duur is (een databasemigratie, een factuur) schrijf je precies voor welk script gedraaid moet worden en dat er niets aan de opdracht veranderd mag worden.

Test hem zoals een collega hem zou aanroepen

Dat een skill aanslaat bewijst alleen dat Claude hem gevonden heeft, niet dat hij deed wat je bedoelde. Meet die twee apart. Anthropics werkwijze: draai elke testprompt in een verse sessie met de skill aan, en nog een keer met de skill uit, en vergelijk. Een verse sessie is nodig omdat achtergebleven context uit het schrijfproces de gaten in je instructies maskeert. Begin met twee tot drie realistische testprompts, varieer de formulering van slordig tot precies, dek minstens een randgeval en gebruik echte bestandsnamen en kolomnamen. Schrijf pas assertions nadat je de eerste resultaten hebt gezien, en houd ze verifieerbaar ("het bestand is geldige JSON") in plaats van vaag ("de uitvoer is goed").

Laat Claude het schrijven, of gebruik de skill-creator

Je hoeft dit niet met de hand te doen. Claude begrijpt het skillformaat van nature: beschrijf in een gewoon gesprek hoe je werkt en vraag om er een skill van te maken, dan krijg je een correct opgebouwde SKILL.md terug. In Claude Code installeer je de officiele skill-creator (385.083 installaties op 1 augustus 2026) die je interviewt, testcases in evals/evals.json zet, ze met en zonder skill in aparte subagents draait en de resultaten aggregeert. En wil je zeker weten dat je frontmatter overal door de validatie komt, dan draai je de referentievalidator van de open standaard: skills-ref validate ./offerte-opvolgmail.

Debuggen

Waarom slaat mijn skill niet aan?

Bijna alle klachten over skills vallen in vier bakjes, en de eerste drie zijn saai en snel op te lossen. Loop ze in deze volgorde af.

De gereedschapskist

Vier commando's en twee vlaggen brengen je in vrijwel alle gevallen bij de oorzaak. /skills laat zien welke skills geladen zijn, per bron (project, gebruiker, plugin). /context toont alles wat contextruimte inneemt, inclusief de skillregel. /doctor doet een setup-check en schat wat je skilllijst aan context kost en welke skills de grootste bijdragers zijn. /debug [probleem] zet debug-logging aan en laat Claude zelf diagnosticeren. Met claude --safe-mode start je een sessie waarin alle aanpassingen uitstaan (CLAUDE.md, skills, plugins, hooks en MCP-servers): verdwijnt je probleem daar, dan zit het in een van die lagen. Voor een echt schone test: cd /tmp && CLAUDE_CONFIG_DIR=/tmp/claude-clean claude.

De verborgen oorzaak: je beschrijving is afgekapt

Dit is de oorzaak die bijna niemand kent. Claude Code laadt een lijst met alle skillnamen en beschrijvingen in de context, en die lijst heeft een budget: standaard 1 procent van het contextvenster van het model. Per skill wordt de gecombineerde tekst van description en when_to_use afgekapt op 1.536 tekens. Loopt het totaal over, dan begint Claude Code beschrijvingen weg te laten, te beginnen bij de skills die je het minst gebruikt. Precies de sleutelwoorden waar je skill op moet triggeren kunnen dan verdwenen zijn. De namen blijven wel altijd staan. Verhogen kan met skillListingBudgetFraction (0.02 is 2 procent) of met de omgevingsvariabele SLASH_COMMAND_TOOL_CHAR_BUDGET. Ruimte vrijmaken kan door onbelangrijke skills op name-only te zetten in skillOverrides. En de praktische les: zet je belangrijkste toepassing vooraan in de beschrijving.

Het omgekeerde probleem: hij slaat juist te vaak aan

Gebruikt Claude je skill op momenten dat je dat niet wilt, dan maak je de beschrijving specifieker, of je zet disable-model-invocation: true zodat alleen jij hem kunt aanroepen. Voor skills waarvan je de SKILL.md niet kunt aanpassen (een gedeelde repo, een plugin van iemand anders) gebruik je de instelling skillOverrides met een van de vier waarden: on, name-only, user-invocable-only of off. Het /skills-menu schrijft dat voor je weg naar .claude/settings.local.json: markeer een skill, druk op spatie om door de standen te lopen en op enter om op te slaan. Pluginskills vallen niet onder skillOverrides; die beheer je via /plugin.

De skill lijkt na een paar beurten uitgewerkt

Zodra een skill wordt aangeroepen, komt de inhoud van SKILL.md als een bericht in het gesprek en blijft daar staan. Claude Code leest het bestand daarna niet opnieuw. Schrijf richtlijnen die de hele taak moeten gelden dus als staande instructies en niet als eenmalige stappen. Lijkt de invloed weg te ebben, dan is de inhoud er meestal nog wel en kiest het model gewoon andere aanpakken; versterk dan de beschrijving en de instructies, of dwing het gedrag af met een hook. En let op wat er bij auto-compaction gebeurt: aangeroepen skills gaan mee binnen een tokenbudget van de eerste 5.000 tokens per skill met 25.000 tokens in totaal, gevuld vanaf de meest recent aangeroepen skill. Oudere skills kunnen daardoor helemaal wegvallen. Roep hem in dat geval opnieuw aan.

Delen

Een Claude skill uitrollen naar collega's, een team of de hele organisatie

Er zijn vier manieren om een skill bij anderen te krijgen, en welke je kiest hangt af van waar je collega's werken. Voor Team en Enterprise is er sinds kort echt centraal beheer, wat een oudere pagina in Anthropics eigen documentatie nog ontkent.

De adminkant op claude.ai, stap voor stap

Een organisatie-eigenaar gaat naar Organization settings > Skills en zet twee schakelaars aan: "Code execution and file creation" en "Skills". Daarna upload je zipbestanden met een SKILL.md erin. Die skills worden direct aan alle gebruikers geprovisioneerd en staan voor iedereen standaard aan, met een team-indicator erbij. Leden kunnen ze individueel uitzetten, maar niet verwijderen: dat kan alleen de oorspronkelijke deler of een eigenaar. Wil je een skill niet aan iedereen maar aan een specifieke groep geven, dan bestaat daar geen directe route voor: je bundelt hem in een plugin en wijst die plugin via het pluginbeheer aan een groep toe.

Twee schakelaars voor collegiaal delen, allebei standaard uit

Naast de adminroute kunnen leden onderling delen, maar alleen als de beheerder dat aanzet. Er zijn twee onafhankelijke schakelaars en beide staan standaard uit. "Skill sharing" laat leden een skill met specifieke collega's delen; die verschijnt bij de ontvanger onder "Shared with you". "Share with organization" laat leden publiceren naar de organisatiedirectory. Het punt om te weten voordat je die tweede aanzet: er is geen goedkeuringsworkflow. Wat een medewerker publiceert, staat er.

Gedeelde skills zijn alleen-lezen

Skills die je van een collega krijgt of uit de directory installeert, kun je aanzetten en gebruiken maar niet bewerken. Wil je er toch iets aan veranderen, dan download je een kopie, past die aan en uploadt hem als je eigen persoonlijke skill. Dat is meteen het praktische advies bij partner-skills en officiele voorbeeldskills: brand-guidelines en internal-comms zijn juist bedoeld om te forken naar je eigen huisstijl en je eigen formats.

De tegenstrijdigheid in Anthropics eigen documentatie

De platform-overviewpagina stelt nog steeds dat custom skills op claude.ai per gebruiker zijn, niet organisatiebreed gedeeld worden en niet centraal door beheerders beheerd kunnen worden. Dat wordt tegengesproken door het actuele supportartikel over skills beheren als admin, dat organisatiebrede provisioning en de adminschakelaars uitgebreid beschrijft. Ga uit van de supportdocumentatie; de platformpagina loopt op dit punt achter. Wij hebben geen changelog kunnen vinden die dateert wanneer die omslag kwam.

Zelf iets publiceren in de marketplace

Wil je een plugin openbaar aanbieden, dan kan dat via claude.ai/admin-settings/directory/submissions/plugins/new (vereist Team of Enterprise) of via platform.claude.com/plugins/submit. Let op waar je terechtkomt: die inzendformulieren voegen je plugin toe aan de community-marketplace, niet aan de officiele. Opname in de officiele marketplace gebeurt naar eigen inzicht van Anthropic en kent geen aanmeldprocedure. In de community-marketplace wordt elke plugin vastgepind op een specifieke commit-SHA en gaat hij door geautomatiseerde validatie en veiligheidsscreening.

Veiligheid

Wat een skill mag, en waar je op let bij skills van derden

Anthropics eigen formulering is streng en verdient het om letterlijk overgenomen te worden: gebruik alleen skills uit vertrouwde bronnen, dus skills die je zelf hebt gemaakt of die van Anthropic komen. Een kwaadaardige skill kan Claude tools laten aanroepen of code laten uitvoeren die niet past bij het beschreven doel, met datalekken of ongeautoriseerde systeemtoegang als gevolg. Behandel het installeren van een skill als het installeren van software, niet als het aanpassen van een instelling.

De vier netwerkstanden op Team en Enterprise

Bij code-uitvoering draait Claude in een geisoleerde sandbox, en beheerders op Team en Enterprise kunnen de netwerktoegang in vier standen zetten: helemaal uit, alleen pakketbeheerders (de standaard), pakketbeheerders plus specifieke domeinen, of alle domeinen. Anthropic noemt die laatste stand zelf de risicovolste, omdat prompt injection dan een route naar buiten heeft om data mee te sturen. Voor Nederlandse organisaties met persoonsgegevens in het spel is "pakketbeheerders plus een eigen lijst domeinen" in de praktijk de verstandige middenweg.

Projectskills en het vertrouwen dat je aan een repo geeft

Een detail dat makkelijk misgaat: het frontmatterveld allowed-tools van een projectskill werkt pas nadat je de workspace trust-dialoog hebt geaccepteerd. Dat betekent dat je projectskills moet lezen voordat je een repository vertrouwt, want een skill kan zichzelf brede toolrechten geven. Bij een repo van een klant of van GitHub is dat geen theoretische zorg. In Claude Code kun je de shell-substitutie in skills bovendien organisatiebreed uitzetten met "disableSkillShellExecution": true; elk commando wordt dan vervangen door een melding dat uitvoering door beleid is geblokkeerd. Bundled en managed skills zijn daarvan uitgezonderd.

De reviewchecklist die Anthropic voor bedrijven publiceert

Voordat je een skill van derden of van een interne bijdrager uitrolt: lees alle inhoud van de skillmap; verifieer in een sandbox dat het scriptgedrag overeenkomt met wat de skill zegt te doen; zoek naar instructies die Claude opdragen veiligheidsregels te negeren, acties te verbergen, data naar buiten te sturen of zich anders te gedragen bij bepaalde invoer; zoek naar netwerkpatronen (http, requests.get, urllib, curl, fetch); controleer op hardgecodeerde inloggegevens; inventariseer alle bash-commando's, bestandsoperaties en toolverwijzingen; en verifieer waar redirects naartoe wijzen. De hoogste risico-indicatoren zijn uitvoerbare scripts, instructiemanipulatie, verwijzingen naar MCP-servers, netwerktoegang en hardgecodeerde credentials. En de organisatorische regel eronder: zorg voor functiescheiding, want de auteur van een skill mag niet zijn eigen reviewer zijn.

Drie signalen bij community-skills

Kijk voordat je installeert naar drie dingen die je in dertig seconden ziet. De datum van de laatste wijziging: gsd-build/get-shit-done heeft 64.784 sterren maar is gearchiveerd sinds 31 mei 2026, en lackeyjb/playwright-skill (2.969 sterren) is sinds 19 december 2025 niet bijgewerkt. De licentie: verschillende populaire repo's hebben er geen, en juridisch betekent dat standaard alle rechten voorbehouden, dus formeel geen toestemming om te kopieren of aan te passen. En de bron van je informatie: de verzamellijsten zijn deels automatisch samengesteld en bevatten aantoonbaar skills die niet bestaan. Controleer altijd tegen de repo zelf.

Waar je bewaartermijn zit

Voor je verwerkingsregister: Agent Skills valt niet onder zero data retention-afspraken. Skilldefinities en uitvoeringsdata worden bewaard volgens het standaard bewaarbeleid van Anthropic. Werk je met persoonsgegevens in skills of in de bestanden die ze verwerken, dan is dat het punt om in je DPIA op te nemen. Het volledige kader staat op Privacy en zakelijk gebruik.

Kiezen

Skill, MCP, connector, Project of Cowork: wat pak je wanneer?

Deze begrippen worden door elkaar gebruikt, ook in artikelen die het goed bedoelen. Het verschil is eenvoudig: een skill is kennis, een MCP-server is toegang, een connector is de knop waarmee je die toegang aanzet, een Project is een werkruimte en Cowork is een manier van werken. Het scherpste onderscheid komt van Anthropic zelf: MCP verbindt Claude met externe diensten en data, skills leren Claude procedurele kennis. Je gebruikt ze meestal samen, niet in plaats van elkaar.

De officiele formulering, en waarom die klopt

Anthropic vat het zelf samen als: MCP verbindt met externe diensten, skills leren procedures aan, en ze werken samen. Een voorbeeld uit de praktijk van een Nederlands bureau. De MCP-server haalt de cijfers van vorige maand uit het analytics-account. De skill bepaalt hoe de rapportage eruitziet: welke volgorde, welke afrondingsregels, welke toon. Zonder de server heeft Claude geen cijfers. Zonder de skill krijg je elke maand een ander document.

Twijfelgeval: mag een skill een MCP-tool aanroepen?

Dat kan, en het is precies de combinatie die werk uit handen neemt. Wees er wel bewust van dat Anthropic in de eigen enterprise-richtlijnen een verwijzing naar MCP-tools in een skill aanmerkt als een indicator voor extra review. Reden: die skill kan namens jou acties in een echt systeem starten. Prima om te doen, maar niet iets wat je zonder te kijken van internet plukt.

Skill of plugin?

Een plugin is geen alternatief voor een skill maar een doos eromheen: hij kan skills, agents, hooks, MCP-servers, LSP-servers, monitors en uitvoerbare bestanden bundelen, met een manifest in .claude-plugin/plugin.json. Praktisch verschil dat je merkt: een losse skill in .claude/ heet /naam, terwijl een skill uit een plugin altijd /plugin-naam:skill-naam heet, zodat er nooit een naambotsing ontstaat. Anthropics advies is simpel: standalone voor je persoonlijke werkwijzen, plugin zodra je met een team of de community deelt.

Waar de MCP-kant staat

Deze pagina gaat over skills. De koppelingenkant (wat MCP precies is, hoe je een server aan claude.ai, Claude Desktop of Claude Code hangt, welke servers er zijn, wat er voor Nederlandse pakketten ontbreekt en wat een beheerder kan afdwingen) staat volledig uitgewerkt op MCP. Wil je weten hoe skills zich verhouden tot de agentische manier van werken, dan is Cowork de plek. Voor het bouwen van skills die code raken: Claude Code.

Hoeveel skills kun je tegelijk aan?

Anthropic geeft voor claude.ai en Claude Code geen hard maximum, maar wel een waarschuwing: beperk het aantal gelijktijdig geladen skills, want elke metadata concurreert om aandacht in de systeemprompt en bij te veel actieve skills kiest Claude de verkeerde of mist hij de juiste. Voor de API is er wel een grens: acht skills per request. Het advies is smal beginnen en later samenvoegen. Dus eerst drie afgebakende skills (bijvoorbeeld offerte-opvolgmail, maandrapportage-klant en klantcase-schrijven) en die pas tot een sales-skill samenvoegen als je hebt gemeten dat de prestaties gelijk blijven.

Onderhoud

Skills bijwerken, versiebeheren en opruimen

Skills zijn goedkoop om te maken en daardoor makkelijk te laten verslonzen. Wat je nu vastlegt over versies en eigenaarschap, scheelt over een halfjaar de vraag wie deze skill ook alweer heeft geschreven en of hij nog klopt.

Er is geen versieveld, behalve in de API

Dit verrast mensen: de Agent Skills-specificatie kent geen versieveld, en Claude Code ook niet. Wil je versies bijhouden, dan doe je dat in het vrije metadata-veld (metadata met author en version: "1.0"), maar dat is jouw eigen conventie en de standaard geeft er geen betekenis aan. In de praktijk is Git de bron van waarheid: historie, review via pull requests en terugrollen doe je daar. De Claude API is de uitzondering en kent wel echte versies: vooraf gebouwde Anthropic-skills dragen datumnummers (bijvoorbeeld 20251013), custom skills krijgen automatisch een epoch-timestamp. Een nieuwe versie maak je met POST naar /v1/skills/{skill_id}/versions, en per bericht kies je tussen een vastgepind versienummer of "latest". Verwijderen gaat in twee stappen: eerst alle versies wissen, dan de skill, anders krijg je een foutmelding.

De uitrolstrategie die Anthropic voor bedrijven adviseert

Bewaar skillmappen in Git. Pin skills in productie op een specifieke versie en draai je volledige testset voordat je een nieuwe versie promoveert. Behandel elke update als een nieuwe deployment die opnieuw een security review vraagt, niet als een tekstwijziging. Gebruik "latest" alleen in ontwikkeling en test. Houd de vorige versie als terugvaloptie en rol direct terug als een nieuwe versie in productie faalt. Wil je het strak: bereken checksums van gereviewde skills en verifieer die bij uitrol, en werk met ondertekende commits zodat de herkomst vaststaat.

Houd een intern register bij

Anthropic adviseert per skill vijf dingen vast te leggen: het doel (welke werkwijze hij ondersteunt), de eigenaar (het team of de persoon die verantwoordelijk is), de huidige versie, de afhankelijkheden (MCP-servers, pakketten, externe diensten) en de evaluatiestatus (datum en uitslag van de laatste test). Dat register is geen bureaucratie maar noodzaak, want gebruiksanalytics zijn niet beschikbaar via de Skills API: je kunt niet opvragen welke skill hoe vaak is aangeslagen. Wil je dat weten, dan moet je zelf logging op applicatieniveau bouwen.

Opruimen kost je context terug

Elke geinstalleerde skill kost ongeveer 100 tokens aan metadata, altijd, ook als je hem nooit gebruikt. Met tientallen skills tikt dat aan en gaat het bovendien ten koste van de herkenning, omdat de beschrijvingen bij overloop worden ingekort. /doctor in Claude Code laat precies zien welke skills, MCP-servers en plugins ongebruikt zijn en wat ze aan context kosten. Bij het installeren van een plugin toont het detailvenster daarnaast een schatting van de contextkosten, de datum van de laatste update en een overzicht dat opsomt welke commando's, agents, skills, hooks en servers erbij komen. Kijk daar naar voordat je installeert, niet nadat je contextvenster vol zit.

Wat je bij community-skills periodiek nakijkt

Zet een halfjaarlijkse herinnering. Kijk per geinstalleerde community-skill naar drie dingen: is de repo nog niet gearchiveerd, is er sinds je installatie iets gewijzigd dat je moet herlezen, en klopt de licentie nog met hoe je hem gebruikt. Het skill-ecosysteem beweegt hard: van de repo's in dit artikel had een deel op 1 augustus 2026 die week nog een wijziging, terwijl andere al maanden stillagen. Sterren zeggen daar niets over. De datum van de laatste push wel.