Claude Skills en Plugins: Een Technische Analyse van Inhoud vs. Container

De termen 'Claude skill' en 'Claude plugin' worden vaak door elkaar gebruikt, wat verwarring schept voor ontwikkelaars die Claude Code willen uitbreiden. In werkelijkheid zijn ze niet hetzelfde. Het onderscheid begrijpen is niet slechts academisch; het is fundamenteel voor het effectief bouwen, installeren en debuggen van aangepast gedrag.

Bij SkillProof werken we dagelijks met deze mechanismen. We lezen niet alleen de documentatie; we installeren en draaien skills op echt werk, zowel vanuit losse mappen als vanuit plugin-bundels. Van de 1877 skills die we tot nu toe hebben getest, slaagden er slechts 1159 (62%) voor onze evaluatie. Nog eens 624 vereisten configuratie, een bijbehorende skill, of een integratie voordat ze resultaat leverden, en 94 scoorden onder de baseline zonder skill — ze draaiden ofwel helemaal niet, of ze draaiden en lieten je slechter af dan wanneer je niets had geïnstalleerd. Deze ervaring geeft ons een duidelijk, op de praktijk gebaseerd perspectief op het verschil tussen een Claude skill en een plugin, en welke je zou moeten gebruiken.

De eenvoudigste manier om erover na te denken is als volgt: een skill is de inhoud—de set instructies die Claude een nieuw gedrag aanleert. Een plugin is een container—een distributiepakket dat een of meer skills kan bundelen, samen met andere soorten extensies.

Dit artikel scheidt de twee concepten, gebruikmakend van de exacte bestandspaden en commando's die we in onze dagelijkse tests gebruiken. We behandelen wat een skill is, wat een plugin is, hoe ze worden geïnstalleerd, en wanneer je de een versus de ander zou moeten bouwen.

Wat is een Claude Code Skill? De Atomaire Eenheid van Gedrag

Een Claude skill is de meest fundamentele bouwsteen. Het is, letterlijk, een map die een bestand met de naam SKILL.md bevat. Dat is alles. De mapnaam wordt de identifier van de skill.

Het SKILL.md-bestand heeft een eenvoudige, tweedelige structuur:

1. YAML Frontmatter: Een blok bovenaan het bestand, omsloten door ---, dat de metadata van de skill definieert. Het veld dat ertoe doet is description. name is optioneel en de waarde is standaard de mapnaam, en er zijn nog een tiental andere optionele velden (allowed-tools, when_to_use, model, paths en dergelijke) die de meeste skills nooit gebruiken.
2. Markdown Instructies: Onder de frontmatter schrijf je platte markdown die de taak aan Claude uitlegt. Dit is je prompt, je set instructies voor hoe het gedrag moet worden uitgevoerd.

Cruciaal is dat het SKILL.md-formaat geen complexe syntax bevat voor het definiëren van tool-functies, API-schema's of parametertypes. Er is geen verplicht blok voor few-shot examples. Het hele systeem is gebouwd op natuurlijke taal.

Het belangrijkste veld in de frontmatter is description. Dit is niet alleen voor menselijke lezers; het is de primaire trigger voor de skill. Wanneer je Claude een taak geeft, scant het de description-velden van alle geïnstalleerde skills om een match te vinden. Als je taakomschrijving overeenkomt met de description van een skill, laadt Claude de markdown-instructies van die skill in zijn context om zijn antwoord te sturen. Laat je dit weg, dan valt Claude terug op de eerste paragraaf van de body, die zelden is geschreven om als trigger te fungeren.

Dit is een veelvoorkomend faalpunt dat we in onze tests documenteren. We hebben veel skills gezien met briljante instructies in de markdown body die Claude nooit gebruikt omdat de description in de frontmatter te vaag, te specifiek of volledig afwezig was. Een skill met een beschrijving als "Aids in development" zal bijna nooit worden getriggerd. Voor een diepgaandere kijk op wat een goede skill maakt, zie onze gids over wat Claude skills zijn.

Hoe een Ruwe Skill te Installeren

Als een skill slechts een map is, is het installeren ervan net zo eenvoudig als het kopiëren van die map naar de juiste plek. Claude Code zoekt naar skills op twee locaties:

1. Globaal: ~/.claude/skills/
2. Projectspecifiek: <your-project-directory>/.claude/skills/

Skills in de globale map zijn beschikbaar in elk project dat je opent met Claude Code. Skills in een projectspecifieke map worden alleen geladen wanneer je binnen dat project werkt. Dit is nuttig voor taken die specifiek zijn voor een enkele codebase.

Om een skill te installeren die je hebt gedownload van een Git-repository, is het proces een directe bestandsoperatie. Bijvoorbeeld, na het clonen van een repository die een skill bevat, voer je uit:

# Example: Installing a skill into the global directory
cp -r path/to/cloned-repo/the-skill-folder ~/.claude/skills/

Claude Code houdt die skill-mappen in de gaten, dus een skill die je toevoegt, bewerkt of verwijdert, wordt binnen de huidige sessie opgepikt zonder herstart. De uitzondering is een skill-map die niet bestond toen de sessie startte; als je er zo een aanmaakt, moet je wel herstarten zodat Claude Code deze begint te monitoren.

Er is geen speciale command-line interface voor het installeren van een ruwe skill, en geen --skill-vlag die Claude voor een enkele run naar een SKILL.md-bestand wijst. Het kopiëren van de map is de installatie.

Deze directe, bestandsgebaseerde aanpak is hoe we de meerderheid van de skills in onze catalogus installeren. Het is eenvoudig, transparant en gemakkelijk te debuggen. Meer gedetailleerde installatievoorbeelden vind je in onze gids voor het installeren van Claude skills.

Wat is een Claude Plugin? Een Distributiepakket

Als een skill de inhoud is, is een plugin de transportkist. Een plugin is een opzichzelfstaande map met componenten, die meestal een .claude-plugin/plugin.json-manifest bevat met zijn identiteitsmetadata (naam, beschrijving, versie, auteur) en kan verwijzen naar waar de componenten zich bevinden.

Dit is het kernverschil tussen een Claude skill en een plugin: een plugin is ontworpen als een bundel. Hoewel het een enkele skill kan bevatten, ligt zijn ware kracht in het vermogen om meerdere, gerelateerde extensies samen te verpakken. Een plugin kan het volgende leveren:

• Skills: Een of meer SKILL.md-mappen.
• Agents: Gespecialiseerde subagents waaraan de hoofd-Claude-agent werk kan overdragen.
• Slash Commands: Aangepaste /-commando's die je direct in de Claude Code chat-interface kunt uitvoeren.
• Hooks: Scripts die automatisch draaien op bepaalde punten in de levenscyclus van de sessie.
• MCP Servers: Verbindingen met een Model Context Protocol-server, zodat een plugin een externe integratie kan configureren als onderdeel van de installatie, in plaats van dat je dit handmatig moet doen. Voor meer hierover, zie onze analyse van skills vs MCP.
• LSP Servers: Language server-verbindingen die Claude typefouten en codenavigatie geven.

Een plugin is niet zomaar een wrapper voor een enkele skill. Het is een complete toolkit. Een plugin voor een specifiek testframework kan bijvoorbeeld een skill bundelen voor het schrijven van nieuwe tests, een slash command om ze uit te voeren, en een hook om tests voor elke commit te draaien. De skill is slechts één stukje van de puzzel.

Hoe Plugins en Marketplaces Werken

Omdat plugins complexere pakketten zijn, is hun installatieproces anders. Je kopieert plugin-mappen niet handmatig. Je gebruikt marketplaces: een marketplace is een Git-repository die een .claude-plugin/marketplace.json-bestand bevat met een lijst van de plugins die het aanbiedt.

Anthropic beheert een officiële marketplace, claude-plugins-official, die Claude Code automatisch voor je toevoegt bij het opstarten, plus een community-marketplace op anthropics/claude-plugins-community die je zelf toevoegt en waarvan de plugins geautomatiseerde validatie en veiligheidscontroles hebben doorstaan. Maar het systeem is niet gesloten: iedereen kan een marketplace publiceren door een marketplace.json in een repo te plaatsen, en niets weerhoudt je ervan om deze toe te voegen. Opname in de officiële catalogus is ter beoordeling van Anthropic; alles daarbuiten heeft de kwaliteit die de beheerder eraan heeft willen geven.

Om een plugin te installeren, voeg je de marketplace toe en installeer je vervolgens de plugin op naam:

1. Voeg de marketplace toe:

   /plugin marketplace add anthropics/claude-code
   

2. Installeer de plugin:

   /plugin install commit-commands@claude-code-plugins
   

Voer vervolgens /reload-plugins uit om het in de huidige sessie te activeren.

Plugin-beheer is echter niet beperkt tot de interactieve interface. Er is een claude plugin shell-commandogroep (alias claude plugins) die install, uninstall, enable, disable, update, list, details, init en validate omvat — de gedocumenteerde manier om te installeren zonder de interactieve stap, en waar je naar grijpt bij het scripten van een team-setup:

claude plugin install commit-commands@claude-code-plugins --scope project

Er zijn ook --plugin-dir- en --plugin-url-vlaggen om een plugin voor slechts één sessie te laden, wat de manier is om iets uit te proberen voordat je het vastlegt.

Het onderscheid tussen een marketplace en een gecureerde directory is hier van belang, en het is niet dezelfde as als skill versus plugin. Een marketplace is een distributiekanaal: het vertelt je dat een plugin bestaat en installeert het. Screening, voor zover het al gebeurt, is geautomatiseerd. Niets daarvan vertelt je of het ding werkt voor jouw taak.

Claude Code Skills vs Plugins: Een Directe Vergelijking

Om het onderscheid volkomen duidelijk te maken, volgt hier een directe vergelijking van de belangrijkste kenmerken:

Kenmerk	Ruwe Skill	Plugin
Definitie	Een map met een SKILL.md-bestand dat één enkel gedrag definieert.	Een opzichzelfstaande map met componenten, die als een pakket fungeert.
Kernbestand	SKILL.md	.claude-plugin/plugin.json
Reikwijdte	Een enkele set instructies voor één taak.	Een bundel van skills, agents, commando's, hooks, MCP- en LSP-servers.
Installatie	Handmatige kopie: cp -r ... ~/.claude/skills/	/plugin install <name>@<market>, of claude plugin install
Distributie	Direct delen van mappen, Git-repository.	Via een Marketplace (een Git-repo met een manifest).
Gebruiksscenario	Persoonlijk gebruik, single-purpose tools, snelle prototyping.	Teamdistributie, complexe toolkits, meerdelig gedrag.

Hoe SkillProof Beide Test

Onze testmethodologie is agnostisch ten opzichte van de installatiemethode. Of een skill nu als een ruwe map of binnen een plugin-bundel wordt geleverd, ons proces is hetzelfde. We installeren het en evalueren vervolgens de prestaties van de onderliggende SKILL.md-instructies aan de hand van een gestandaardiseerde set taken.

De distributiemethode verandert het gedrag van de skill niet. Een slecht geschreven SKILL.md-bestand zal net zo slecht presteren, of je het nu handmatig kopieert of installeert met /plugin install.

Sterker nog, een terugkerende fout die we tegenkomen is een pakket dat perfect installeert maar een skill bevat die nooit wordt geactiveerd. De installatie voltooit zonder fouten, de skill verschijnt in de lijst, en vervolgens gebruikt Claude hem nooit, omdat de description in zijn SKILL.md te summier is om te matchen met wat een gebruiker daadwerkelijk zou typen. Niets in de installatie meldt dit. Je komt er alleen achter door Claude de taak te geven die de skill zou moeten afhandelen en te zien hoe het antwoordt alsof de skill er niet is — wat precies de test is die wij uitvoeren.

Dit is mede de reden waarom 624 van de 1877 skills die we hebben getest het oordeel "Werkt met configuratie" krijgen in plaats van te slagen: ze leveren resultaat, maar niet direct uit de doos, en de verpakking neigt ertoe de reden te verbergen.

Moet ik een Skill of een Plugin Bouwen?

Dit brengt ons bij de praktische vraag: wanneer je een nieuw gedrag voor Claude hebt, moet je dan een skill of een plugin bouwen?

Het antwoord is eenvoudig: begin altijd met het bouwen van een skill.

1. Maak je your-skill-name/SKILL.md-bestand aan. Focus op het schrijven van duidelijke, effectieve instructies en een precieze, trigger-vriendelijke description. Test het lokaal door het naar ~/.claude/skills/ te kopiëren.

2. Itereer op de SKILL.md totdat het betrouwbaar werkt. Dit is 99% van het werk. De inhoud van dit bestand is wat de waarde levert.

Pas nadat je een bewezen, werkende skill hebt, zou je moeten overwegen om het als een plugin te verpakken. De beslissing om een plugin te maken moet worden gedreven door distributiebehoeften, niet door de complexiteit van de skill zelf.

Verpak als een plugin als:

• Je meer dan één component levert. Bijvoorbeeld, een skill om API-documentatie te genereren en een slash command /generate-docs om het voor het hele project te triggeren.
• Je een set skills moet distribueren naar een team met één eenvoudig installatiecommando.
• Je een geavanceerdere extensie bouwt die afhankelijk is van hooks, subagents of andere plugin-only features.

Als je een enkele skill hebt voor je eigen persoonlijk gebruik, is het maken van een plugin onnodige overhead. Een ruwe skill-map in ~/.claude/skills/ is eenvoudiger en directer.

Conclusie: Focus op de Skill, Niet op de Wrapper

De centrale conclusie is dat prestaties voortkomen uit de kwaliteit van het SKILL.md-bestand, niet uit de verpakking. Een plugin is een distributiemechanisme, geen kwaliteitsgarantie. Zoals onze data aantoont, falen zelfs netjes verpakte skills: 94 van de door ons geteste skills scoorden lager dan wat Claude doet zonder enige geïnstalleerde skill.

Het verschil tussen Claude skills en plugins is geen kwestie van goed versus slecht, maar van reikwijdte en doel. De een is de instructie; de ander is de doos waarin het wordt verzonden.

Gerelateerde lectuur: voor een diepgaande kijk op de verpakkingskant — manifesten, marketplace-structuur en wat je moet controleren voordat je iemands repo toevoegt — zie onze gids over Claude Code plugins. Voor de inhoudelijke kant behandelt wat Claude skills zijn hoe het formaat werkt voordat je je eerste schrijft.

Het vinden van de 1159 skills die daadwerkelijk slagen voor onze tests is de reden waarom we SkillProof hebben gebouwd. Als je het vallen en opstaan wilt overslaan, is onze catalogus van geteste codeerskills een goed startpunt. Als je liever een set installeert die al samen is getest, verkopen we rolgebaseerde pakketten van tien — Developer Toolkit, Writer Pack, Security & Code Review en vijf andere — voor $10 per stuk op /bundles.