Skills, Subagents, MCP en Plugins in Claude Code: welke kies je

Op dit moment zijn er in Claude Code vijf manieren om dezelfde codebeoordeling uit te voeren: een slash-opdracht, een skill, een subagent, een plugin of gewoon een prompt in de chat. Standaard is geen van deze manieren beter dan de andere — de keuze hangt af van de taak, het tokenbudget en wie behalve jij de functie zal gebruiken.

Dit is de handleiding die ik mezelf een jaar geleden had willen geven. Een boom met 4 vragen, een kant-en-klare matrix “taak → laag” en 5 veelvoorkomende fouten die tokens verspillen bij vrijwel elke vibe coder met wie ik werk.

Informatie over werken met de dienst vind je in de Ailoot-documentatie.

Wat zijn skills, subagents, MCP en plugins in één zin?#

Laten we de termen onderscheiden voordat we een keuze maken. Alle vier de lagen hebben hetzelfde doel: uitbreiden wat Claude standaard kan. Maar elke laag heeft een eigen aard.

Skill is een map met een bestand SKILL.md dat beschrijft wanneer en hoe je een specifieke methode toepast. Anthropic vergelijkt een skill met instructies voor een nieuwe medewerker: je dicteert niet elke dag elke stap; je geeft diegene een procedure.

Subagent is een afzonderlijke Claude-sessie met een eigen context, gestart vanuit het hoofdgesprek. De belangrijkste eigenschap is isolatie. Een subagent kan 30 bestanden lezen, een samenvatting maken en alleen die terugsturen naar de hoofdchat. De context van het hoofdgesprek blijft overzichtelijk.

MCP (Model Context Protocol) is een open standaard van Anthropic om Claude met externe systemen te verbinden. In een blogbericht van 13 november 2025 legde Anthropic het onderscheid zo helder mogelijk uit:

Plugin is een kant-en-klare set van iemand anders met skills, subagents, hooks en opdrachten, verpakt in een marketplace. Installeer deze met één regel via /plugin install en je krijgt alles in één keer. Als een skill jouw eigen procedure is, is een plugin een procedure die je bij een ander bedrijf hebt gekocht.

Kort gezegd: skills zijn recepten, subagents zijn gespecialiseerde collega’s en MCP biedt externe tools waarmee Claude diensten en data kan bereiken. De tokenkosten verschillen: een skill is het goedkoopst (deze wordt geactiveerd wanneer nodig), terwijl MCP aanzienlijk duurder is (elke verbonden server neemt voortdurend ruimte in het contextvenster in).

Waarom 4 lagen als je ook één CLAUDE.md kunt gebruiken?#

In het beschreven project is CLAUDE.md een grote kaart met regels: waar dingen thuishoren, hoe je publiceert en welke afspraken gelden. Zonder dit bestand zou Claude elke nieuwe sessie vanaf nul beginnen.

Maar CLAUDE.md heeft een grens. Ik licht drie situaties toe waarin het niet meer werkt.

Situatie 1: een regel werkt maar soms. In CLAUDE.md staat: “voer altijd npm run build uit vóór git push.” Claude leest dit aan het begin van de sessie, knikt, begint na 25 berichten code te schrijven en vergeet het. Ik heb mezelf al drie keer zien pushen zonder een build uit te voeren; die pushes mislukten in productie. Een correct ingestelde en geteste hook kan een deterministische buildcontrole uitvoeren en de gedekte actie weigeren. De dekking hangt van gebeurtenis en toolpad af: een Claude Code-hook onderschept op zichzelf niet elke push vanuit een andere terminal of applicatie. Controleer dat een bewust mislukte build het echte pad dat je gebruikt blokkeert.

Situatie 2: een proces van 15 stappen dat steeds terugkomt. In het beschreven voorbeeld doorloopt elke handleiding 14 fasen: onderzoek → structuur → MDX → 7 parallelle QA-controles → publicatie naar productie → IndexNow. Als ik elke keer een prompt schrijf met “voer fase 1 uit, dan 2, dan 3”, verspil ik tokens voordat ik überhaupt begin. Daarom is de hele workflow verpakt in de skill build-masterskaya-guide — een instructieset van 34 KB die je start met de zin “laten we een nieuwe handleiding voor het project maken”.

Situatie 3: een taak die context opslokt. Om een al gepubliceerde handleiding op actualiteit te controleren, moet Claude een livestreamtranscript van 30 KB en 20 retrospectives van elk 5 KB lezen en die vergelijken met de huidige site. Als ik dit in de hoofdchat doe, zit mijn context aan het eind van de beoordeling vol met 200K tokens aan rommel. Een subagent doet hetzelfde werk, stuurt alleen een samenvatting van 300 woorden terug naar het hoofdgesprek en sluit af.

Situatie 4: ik wil dat het team dezelfde sjablonen krijgt als ik. Een kant-en-klare set regels voor frontendontwerp, hooks voor publicatie via Coolify en MCP voor Playwright-controles. Dat is een plugin: ik verpak mijn setup, publiceer die in de marketplace en een collega installeert hem met één regel.

CLAUDE.md behandelt de basis: “zo doen we de dingen hier”. De 4 extra lagen dekken af wat CLAUDE.md fysiek niet kan: herhaling via triggers, contextisolatie, toegang tot de buitenwereld en delen.

Wanneer heb je een skill nodig in plaats van CLAUDE.md?#

De test voor een skill is eenvoudig: je merkt dat je steeds dezelfde lange prompt uit je notities naar de chat kopieert. De derde keer is al een signaal.

Ik heb momenteel 7 mappen in ~/.claude/skills/: build-masterskaya-guide, build-vc-spoke, build-reel-script, build-practicum-instruction, update-config, simplify en keybindings-help. De meest gebruikte is build-masterskaya-guide (deze handleiding is ermee geschreven). Daarin zit 34 KB aan methodologie: welke fasen je moet doorlopen, welke multi-agent-QA-controles je moet uitvoeren, welke gate-voorwaarden het proces moeten stoppen en welke artefacten je in /tmp/ moet opslaan.

Wanneer je geen skill moet maken.

• Een regel als “antwoord in de voorkeurstaal van de gebruiker” hoort in CLAUDE.md, niet in een skill. Een skill wordt geactiveerd wanneer deze wordt aangeroepen, maar deze regel moet altijd gelden.
• Een eenmalige instructie als “voer de refactoring nu uit” hoort in de chat, niet in een skill.
• Een taak die een aparte context nodig heeft kan een subagent gebruiken; volgt ze ook een terugkerende procedure, bewaar die methode dan in een skill.

Het belangrijkste antipatroon. De meest voorkomende fout van vibe coders is een procedure in een subagent proppen terwijl het een skill zou moeten zijn. Een subagent kost meer tokens (deze heeft een eigen context), start langzamer op en is vaak overkill. Als de taak past in een methodologie van 1,500–2,000 woorden zonder externe bestanden te lezen, is het een skill.

Hoe je een skill structureert, wat je in de frontmatter zet en welke triggerzinnen werken, lees je in de handleiding Claude Code Skills in 2026: How to Build a Personal Skills Library.

Wanneer heb je een subagent nodig in plaats van een skill?#

Een skill bewaart de methode; een subagent doet het werk. Het zijn verschillende lagen, die vaak worden verward omdat beide “vanuit de chat” worden gestart.

Een subagent is alleen zinvol voor contextisolatie. De hoofdClaude-sessie heeft een budget van 200,000 tokens (of 1 miljoen in bèta). Als je in de hoofdchat vraagt om 30 bestanden te lezen en elk ervan te analyseren, verbruik je de helft van het venster aan tussentijdse leesresultaten. Een subagent doet hetzelfde werk in een aparte sessie en stuurt alleen het resultaat terug naar de hoofdchat.

Een concreet projectvoorbeeld. Elke handleiding doorloopt verschillende parallelle QA-controles: stijl, citaten en feiten vergeleken met primaire bronnen, structuur voor zoekmachines en integriteit van interne en externe links. Elke controle heeft een eigen context nodig: een woordenlijst met regels, WebFetch voor tientallen URL's en grep-zoekopdrachten in de tekst.

Als ik al deze controles in één chat uitvoerde, zou de context me verstikken voordat de eerste klaar was. Subagents parallel uitvoeren met run_in_background: true lost dit op: ze werken op de achtergrond, de hoofdchat gaat verder en na 4–6 minuten ontvang ik compacte rapporten en voer ik de wijzigingen door.

Een tweede voorbeeld — zwaar onderzoek. Als ik een onderwerp kies voor een nieuwe handleiding, verzamelen 4 subagents parallel signalen:

• V1 - forums en communities gedurende 14 dagen
• V2 - sociale netwerken
• V3 - videoplatforms + Anthropic-blog
• V4 - SEO-hiaten

Elk levert 30–40 items met viraliteitsscores op. Ik verzamel ze in een pool, weeg ze af op 9 dimensies en kies een winnaar. Zonder subagents duurt deze fase 2–3 uur en verbruikt ze de hoofdcontext.

Wanneer je geen subagent moet maken.

• Een taak waarvoor je geen bestanden hoeft te lezen of WebFetch hoeft te gebruiken, hoort in de hoofdchat.
• Een herhaalbare procedure hoort in een skill, maar kan binnen een subagent draaien wanneer isolatie nuttig is.
• Externe toegang vereist een toegestane tool zoals MCP of een CLI; een subagent kan die tool gebruiken wanneer de taak wordt gedelegeerd.

Het belangrijkste antipatroon. Een subagent met de naam backend-engineer of qa maken in de hoop dat Claude zelf uitzoekt wanneer die moet worden gebruikt. Specifieke subagents (zoals migration-test-writer of api-route-reviewer) leveren veel betere kwaliteit dan generieke. Hoe preciezer de naam en instructies van de subagent, hoe nauwkeuriger Claude de juiste kiest.

Hoe je subagents voor specifieke taken maakt, de syntaxis van frontmatter en 5 kant-en-klare voorbeelden vind je in de handleiding Claude Code Subagents in 2026: A Step-by-Step Guide.

Wanneer heb je MCP nodig in plaats van een skill of subagent?#

Anthropic gaf in een blogbericht de kortste formule voor het verschil: MCP verbindt Claude met data; skills leren Claude wat het met die data moet doen.

Een GitHub-issuebeoordelingsskill heeft bijvoorbeeld issue-inhoud nodig. Lever die via een toegestane MCP-tool, CLI of aangeleverde tekst. De skill bepaalt daarna hoe de beoordeling en bevindingen worden opgebouwd; MCP-toegang alleen schrijft die procedure niet voor.

Mijn specifieke MCP-stack.

• Playwright MCP - visuele QA voor elke handleiding. Open de pagina op desktop en mobiel, controleer de containerbreedte en of de blokken zijn weergegeven.
• Stitch MCP - toegang tot het designsysteem en componenten genereren in de merkstijl.
• vidIQ MCP - trendanalyse en ideeën controleren op viraliteit.
• Railway MCP - deploymentinfrastructuur beheren.

Elk van deze 4 is een brug naar een extern systeem. Zonder MCP zou ik zelf wrappercode schrijven of overschakelen naar een browser. Met MCP gebeurt alles binnen de Claude-sessie.

Tokenkosten. MCP is de duurste laag. Elke verbonden server neemt voortdurend ruimte in het contextvenster in: tooldeclaraties, argumentenschema's en beschrijvingen. Ik heb 4 MCP-servers — dat is ongeveer 8–12K tokens in elke nieuwe sessie voordat ik iets heb gevraagd.

Dit betekent dat we MCP alleen verbinden als het in de meeste sessies echt nodig is. Als je Sentry MCP één keer per week gebruikt, kun je het beter op aanvraag inschakelen met de vlag --mcp sentry dan het permanent in de lijst te houden.

Wanneer je MCP niet moet gebruiken.

• De methode voor “werken met data” hoort in een skill, niet in MCP.
• Een lange leestaak kan baat hebben bij een subagent; staan sommige bestanden of records extern, dan kan die ook MCP-toegang nodig hebben.
• Publiceren met één opdracht vraagt om een hook of plugin, niet om MCP.

Het belangrijkste antipatroon. Een MCP-server bouwen voor iets dat beter met een skill kan. Ik zag een voorbeeld in een HN-discussie (diezelfde thread met 422 punten op 27 mei): de auteur schreef een MCP-server die “instructies voor codebeoordeling” biedt. Maar dat is geen toegang tot de buitenwereld; het is een procedure. Een skill doet hetzelfde met 10 keer minder tokens.

Een incident met concurrerende bronnen. Eens liep Playwright MCP vast met de foutmelding “Browser is already in use” — ik had tegelijkertijd een Chrome-venster open en MCP kon de browser niet overnemen. Dit is een belangrijke les: een MCP-server gebruikt gedeelde systeembronnen. Als een bron bezet kan zijn (een browser, poort of bestand), denk dan vanaf het begin na over isolatie.

Een kant-en-klare handleiding voor het verbinden van 7 werkende MCP's staat in Claude Code MCP Servers in 2026: 7 Ready-to-Use Setups.

Wanneer heb je een plugin nodig in plaats van een skill of subagent?#

Skills, subagents en MCP gaan over jouw methodologie. Een plugin is de kant-en-klare methodologie van iemand anders die je in je setup importeert.

In oktober 2025 lanceerde Anthropic Claude Code Plugins, een officieel distributiemechanisme. Een plugin is een map die het volgende kan bevatten:

• eigen slash-opdrachten
• eigen skills
• eigen subagents
• eigen hooks
• eigen MCP-configuraties
• eigen uitvoerstijlen

Dit alles wordt met plugin.json verpakt in één bundel. Installeren kan met één regel in ~/.claude/settings.json of met de opdracht /plugin install <name>.

Mijn specifieke plugin-stack.

• frontend-design uit het officiële claude-plugins-official — 67 stijlen, 96 paletten, 57 lettertypecombinaties, 13 frameworks. Wanneer ik een nieuw blok voor de site of een e-mailsjabloon maak, laad ik deze plugin en krijg ik de hele bibliotheek in één keer.
• playwright uit dezelfde officiële marketplace — een set skills plus MCP-configuraties voor browsertests.
• telegram — een kant-en-klare set voor het beheren van een Telegram-account vanuit Claude Code (beleid, allowlist, koppeling).
• trailofbits/skills — een set beveiligingsskills van Trail of Bits, een bedrijf dat ik vertrouw op het gebied van beveiliging.

Alle 4 zijn samen drie regels in settings.json. Zonder plugins zou ik uren kwijt zijn aan het handmatig opbouwen van dezelfde bibliotheek.

Wanneer je geen plugin moet gebruiken.

• Als de methode helemaal van jou is en niet voor anderen is bedoeld, houd deze dan als skill.
• Als je nog niet weet wie deze zal gebruiken, probeer hem dan eerst zelf als skill.
• Als je snel drie bestanden naar een nieuwe machine wilt kopiëren, volstaat cp ~/.claude/skills/X /new/machine/.claude/skills/.

Het belangrijkste antipatroon. Een plugin gebruiken als vervanging voor CLAUDE.md — bijvoorbeeld een plugin met regels over “hoe we in dit project werken”. Een plugin is bedoeld voor distributie en hergebruik. Als regels specifiek zijn voor één repository, horen ze in CLAUDE.md, niet in een plugin.

Vooruitkijkend naar 2026: Anthropic beweegt duidelijk richting een teammarketplace voor plugins. Dat betekent dat bedrijven hun interne methodes als plugins kunnen publiceren, versiebeheer erop kunnen toepassen en ze met één opdracht voor alle medewerkers kunnen bijwerken. Voor een zelfstandige ondernemer betekent dit: installeer wat al klaar is en vind het wiel niet opnieuw uit.

Beslisboom: 4 vragen die je vóór elke taak moet stellen#

Vraag 1: is er een herhaalbare procedure die het bewaren waard is?

Zo ja, verpak de methode als een skill in een SKILL.md-bestand met een duidelijke beschrijving van wanneer je die gebruikt. Dit levert de procedure, niet op zichzelf externe toegang of een aparte context.

Vraag 2: heeft het werk een aparte context of gerichte gedelegeerde rol nodig?

Zo ja, gebruik een subagent. Geef een precieze taak en tools. Dezelfde taak kan binnen die geïsoleerde context de methode van een skill volgen.

Vraag 3: heeft de taak een tool of toegang tot externe gegevens nodig?

Zo ja, geef toegestane toegang via MCP of een andere passende tool, zoals een al ingestelde CLI. Een skill beschrijft hoe je die toegang gebruikt; een subagent kan de uitvoerder zijn.

Vraag 4: moet deze configuratie als pakket worden verspreid en onderhouden?

Zo ja, gebruik een plugin om de relevante skills, agentdefinities, hooks of MCP-configuratie te verspreiden. Het pakket kan van jezelf of van een andere auteur zijn.

Gecombineerd voorbeeld: terugkerende GitHub-issuebeoordeling. Een skill definieert procedure en resultaatvorm. Een ingestelde GitHub-MCP of CLI biedt toegestane toegang tot issues. Een subagent kan een lange issuethread in zijn eigen context lezen en bevindingen teruggeven. Een plugin kan die combinatie onder het team verspreiden. Alle vier de antwoorden kunnen “ja” zijn; geen antwoord sluit een ander uit.

5 fouten die vibe coders maken bij het kiezen van een laag#

Ik zie deze 5 patronen eens per week bij de vibe coders met wie ik werk. De helft maakt er in de eerste week minstens één.

Fout 1: subagent in plaats van skill.

Symptoom: iemand heeft een subagent gemaakt voor “een nieuwe blogpost schrijven”. Elke keer dat diegene de subagent start, wordt deze geladen, leest hij 2 KB aan methodologie, maakt hij een post en sluit hij af. Na een week merkt de auteur dat elke uitvoering 5K extra tokens kost om de subagent te laden.

Wat er had moeten gebeuren: “hoe schrijf je een post” is een methode — dus een skill. De trigger is de zin “nieuwe blogpost”. De skill wordt in de hoofdchat geladen en opent geen aparte sessie. Dit is 3–5 keer goedkoper.

Fout 2: MCP-server in plaats van skill.

Symptoom: iemand heeft een MCP-server geschreven die instructies geeft over “hoe je codebeoordeling uitvoert”. Tooldeclaraties, beschrijvingen van argumentschema's en documentatie blijven context innemen. Elk verzoek verspilt 2–3K tokens aan niets.

Wat er had moeten gebeuren: “hoe je codebeoordeling uitvoert” is een procedure, geen toegang tot een extern systeem. Gebruik een skill. MCP is alleen gerechtvaardigd als je live toegang nodig hebt — bijvoorbeeld tot Sentry om de nieuwste fouten op te halen.

Fout 3: plugin in plaats van CLAUDE.md.

Symptoom: iemand heeft projectregels (“gebruik altijd de strikte TypeScript-modus”, “gebruik geen streepjes”, “gebruik alleen pnpm, geen npm”) in een plugin verpakt en geïnstalleerd. Elke nieuwe sessie laadt nu een plugin die dupliceert wat in CLAUDE.md hoort te staan.

Wat er had moeten gebeuren: regels voor één project horen in de CLAUDE.md van dat project. Een plugin is voor een methode die voor meerdere mensen of repositories bruikbaar is.

Fout 4: een skill proberen te maken via een hook.

Symptoom: iemand zag dat een hook automatisch wordt uitgevoerd bij een gebeurtenis (bijvoorbeeld voordat een bestand wordt opgeslagen). Diegene besloot een “skill via een hook” te maken, zodat Claude de methode bij elke bewerking automatisch zou toepassen. Het resultaat was een eindeloze triggerlus, verspilde context en onvoorspelbaar gedrag.

Wat er had moeten gebeuren: een hook is deterministische code die een opdracht uitvoert, het resultaat opmaakt of een bewerking blokkeert. Een hook laadt geen skill en roept Claude niet aan. Als je “methode X altijd wilt toepassen”, gebruik dan een skill met een trigger of een regel in CLAUDE.md.

Fout 5: een extra laag terwijl er helemaal niets nodig is.

Symptoom: iemand hoort over skills, leest handleidingen, besluit “ik moet deze methode verpakken” en besteedt een avond aan een skill voor een taak die één keer per maand voorkomt.

Wat er had moeten gebeuren: een eenmalige taak hoort ad hoc in de chat. Een skill is alleen gerechtvaardigd als je dit meer dan één keer per dag doet. Anders is het overengineering die daarna onderhouden moet worden.

Controleer in deze voorbeelden de behoeften onafhankelijk: procedure, context- of rolisolatie, tooltoegang en verspreiding. Voeg elke laag toe die een concreet doel heeft en combineer lagen wanneer een taak er meerdere nodig heeft.

Wat Anthropic zegt over versnippering: waar gaat Claude Code in 2026 naartoe?#

Wat dit betekent voor de komende zes maanden tot een jaar.

Ten eerste: skills worden de belangrijkste laag voor procedurele taken. Anthropic zet duidelijk in op deze laag als de goedkoopste en meest voorspelbare. Als je in 2026 niet begrijpt waarom je een skill nodig hebt, bestudeer die dan eerst. Alle andere lagen zullen eromheen draaien.

Ten tweede: subagents worden gespecialiseerd. De belangrijkste functie van subagents is contextisolatie voor zware taken. Generieke subagents zoals qa-engineer zullen verdwijnen; specifieke zoals migration-test-writer en api-route-reviewer blijven bestaan.

Ten derde: de nieuwe aankondigingen van Anthropic in de afgelopen 14 dagen — de opdracht /workflows (28 mei 2026) voor het aansturen van tientallen subagents en de gesplitste facturering voor de Agent SDK vanaf 15 juni — betekenen dat programmatisch gebruik naar een afzonderlijke pool verhuist. Dit is een signaal dat Anthropic infrastructuur bouwt voor geautomatiseerde systemen met 10+ agents, in plaats van individuele sessies.

Voor een vibe coder in 2026 betekent dit één eenvoudig ding: de vier lagen blijven minstens nog zes maanden bestaan; daarna zullen sommige samensmelten. Maar de beslisboom met vier vragen blijft ook na die samenvoeging werken — die gaat over de aard van de taak, niet over de specifieke naam van de laag.

Kant-en-klare matrix: 10 typische taken → de juiste laag#

De belangrijkste regel voor het gebruik van deze tabel is dat je niet moet proberen “alle 10 tegelijk te doen”. De meeste solo-vibe coders redden het met CLAUDE.md + 5–7 skills + 2–4 MCP-servers. Subagents en plugins worden toegevoegd wanneer het project groeit.

Wat nu: je werkruimte in Claude Code opbouwen#

Deze vijf lagen staan niet achter elkaar; ze passen in elkaar. CLAUDE.md is het fundament van het project en de andere vier worden verbonden naarmate de taken groeien.

Maak kennis met Ailoot.