Configuratie en multi-file skills

Wat je leert

Geschatte tijd: 20 minuten

Aan het einde van deze les kun je:

• Geavanceerde skill-metagegevensvelden configureren, inclusief allowed-tools en model
• Effectieve skill-beschrijvingen schrijven die betrouwbaar op de juiste verzoeken reageren
• allowed-tools gebruiken om te beperken wat Claude kan doen wanneer een skill actief is
• Complexe skills organiseren met behulp van progressieve onthulling en multi-file-structuren

Configuratie en multi-file skills

(4 minuten)

Deze video behandelt de geavanceerde technieken die skills krachtiger maken: de volledige set metagegevensvelden, hoe je beschrijvingen schrijft die betrouwbaar reageren, het beperken van tool-toegang voor beveiligingsgevoelige workflows, en het organiseren van grotere skills over meerdere bestanden met behulp van progressieve onthulling. Je leert hoe je je skills efficiënt houdt terwijl je nog steeds complexe use cases ondersteunt.

Belangrijkste inzichten

• name en description zijn verplicht — allowed-tools en model zijn optioneel maar krachtige toevoegingen
• Een goede beschrijving beantwoordt twee vragen : Wat doet de skill? Wanneer moet Claude deze gebruiken?
• allowed-tools beperkt welke tools Claude kan gebruiken wanneer de skill actief is — nuttig voor read-only of beveiligingsgevoelige workflows
• Progressieve onthulling : houd SKILL. md onder de 500 regels en link naar ondersteunende bestanden (referenties, scripts, assets) die Claude alleen leest wanneer nodig
• Scripts worden uitgevoerd zonder hun inhoud in context te laden — alleen de output verbruikt tokens, wat context efficiënt houdt

Een basis skill werkt met alleen een naam en beschrijving, maar er zijn verschillende geavanceerde technieken die je skills veel effectiever kunnen maken in Claude Code. Laten we de belangrijkste velden, best practices voor beschrijvingen, tool-beperkingen en hoe je grotere skills structureert, doorlopen.

Skill-metagegevensvelden

De agent skills open standard ondersteunt verschillende velden in de SKILL. md frontmatter. Twee zijn verplicht, en de rest zijn optioneel:

• name (verplicht) — Identificeert je skill. Gebruik alleen kleine letters, cijfers en koppeltekens. Maximaal 64 tekens. Moet overeenkomen met je mapnaam.
• description (verplicht) — Vertelt Claude wanneer de skill moet worden gebruikt. Maximaal 1. 024 tekens. Dit is het belangrijkste veld omdat Claude het gebruikt voor matching.
• allowed-tools (optioneel) — Beperkt welke tools Claude kan gebruiken wanneer de skill actief is.
• model (optioneel) — Geeft aan welk Claude-model voor de skill moet worden gebruikt.

Effectieve beschrijvingen schrijven

Wees expliciet met je instructies. Als iemand je zou zeggen "je taak is om met docs te helpen," zou je niet weten wat je moet doen — en Claude denkt hetzelfde.

Een goede beschrijving beantwoordt twee vragen:

• Wat doet de skill?
• Wanneer moet Claude deze gebruiken?

Als je skill niet triggert wanneer je dat verwacht, probeer dan meer trefwoorden toe te voegen die overeenkomen met hoe je je verzoeken daadwerkelijk formuleert. De beschrijving is wat Claude gebruikt om te bepalen of een skill relevant is, dus de taal is belangrijk.

Tools beperken met allowed-tools

Soms wil je een skill die alleen bestanden kan lezen, niet wijzigen. Dit is nuttig voor beveiligingsgevoelige workflows, read-only taken, of elke situatie waarin je guardrails wilt.

In dit voorbeeld is het allowed-tools-veld ingesteld op Read, Grep, Glob, Bash. Wanneer deze skill actief is, kan Claude alleen deze tools gebruiken zonder toestemming te vragen — geen bewerking, geen schrijven.

--- name: codebase-onboarding description: Helps new developers understand the system works. allowed-tools: Read, Grep, Glob, Bash model: sonnet ---

Als je allowed-tools volledig weglaat, beperkt de skill niets. Claude gebruikt zijn normale machtigingsmodel.

Progressieve onthulling

Skills delen Claude's context window met je gesprek. Wanneer Claude een skill activeert, laadt het de inhoud van die SKILL. md in context. Maar soms heb je referenties, voorbeelden of hulpscripts nodig waarvan de skill afhankelijk is.

Alles in één 2. 000-regels bestand proppen heeft twee problemen: het neemt veel context window-ruimte in beslag, en het is niet leuk om te onderhouden.

Progressieve onthulling lost dit op. Houd essentiële instructies in SKILL. md en plaats gedetailleerd referentiemateriaal in aparte bestanden die Claude alleen leest wanneer nodig.

De open standard suggereert het organiseren van je skill-map met:

• scripts/ — Uitvoerbare code
• references/ — Aanvullende documentatie
• assets/ — Afbeeldingen, sjablonen of andere gegevensbestanden

Link vervolgens in SKILL. md naar de ondersteunende bestanden met duidelijke instructies over wanneer ze moeten worden geladen:

In dit voorbeeld leest Claude architecture-guide. md alleen wanneer iemand naar systeemontwerp vraagt. Als ze vragen waar ze een component moeten toevoegen, laadt het dat bestand nooit. Het is alsof je een inhoudsopgave in het context window hebt in plaats van het hele document.

Een goed vuistregel: **houd SKILL. md onder de 500 regels**. Als je dat overschrijdt, overweeg dan of de inhoud in aparte referentiebestanden moet worden gesplitst.

Scripts efficiënt gebruiken

Scripts in je skill-map kunnen worden uitgevoerd zonder hun inhoud in context te laden. Het script wordt uitgevoerd en alleen de output verbruikt tokens. De sleutelinstructie die je in je SKILL. md moet opnemen, is Claude vertellen om het script uit te voeren, niet te lezen.

Dit is vooral nuttig voor:

• Omgevingsvalidatie
• Gegevenstransformaties die consistent moeten zijn
• Bewerkingen die betrouwbaarder zijn als geteste code dan gegenereerde code

Lesreflectie

• Denk na over een skill die je zou willen bouwen en die meerdere bestanden omvat. Hoe zou je de SKILL. md versus ondersteunende referentiebestanden structureren?
• Zijn er workflows in je team waar het beperken van tool-toegang met allowed-tools een belangrijke veiligheidslaag zou toevoegen?

Wat komt volgende

In de volgende les vergelijken we skills met de andere manieren waarop je Claude Code kunt aanpassen — CLAUDE. md, subagents, hooks en MCP servers — zodat je het juiste hulpmiddel voor elke situatie kunt kiezen.

Feedback

Terwijl je door de cursus vordert, horen we graag hoe je skills in je werk gebruikt, plus eventuele feedback die je hebt. Deel je feedback hier.