Claude Code-skills: zelf een skill maken, installeren en testen
Een skill in Claude Code is een map in .claude/skills met een bestand SKILL.md. Claude Code leest alleen de korte beschrijving en pakt de skill zelf zodra je vraag erbij past. Hieronder bouwen we er een die CSV-exports controleert, met een klein script erbij. In onze test laadde hij bij een vraag over het importeren van een klantenbestand en bleef hij dicht bij een vraag over een slogan.
Zelf getest op 11 november 2026.
Waar Claude Code skills zoekt
| Plek | Map | Geldt voor |
|---|---|---|
| Persoonlijk | ~/.claude/skills/<naam>/SKILL.md | Al je projecten op deze computer |
| Project | .claude/skills/<naam>/SKILL.md | Dit project; zet hem in Git en je team heeft hem ook |
| Plugin | <plugin>/skills/<naam>/SKILL.md | Waar de plugin aan staat, als /plugin-naam:skill-naam |
Een skill voor één klant of één codebase zet je in het project. Een werkwijze die je overal gebruikt, zoals je schrijfstijl, hoort in je persoonlijke map. Skills in claude.ai staan los hiervan: die upload je als zip en ze komen niet vanzelf in Claude Code terecht.
Een skill maken in vier stappen
Maak de map
In de hoofdmap van je project maak je
.claude/skills/csv-controle/scripts. De mapnaam wordt de naam van de skill. Gebruik kleine letters, cijfers en streepjes.bashmkdir -p .claude/skills/csv-controle/scriptsSchrijf SKILL.md
Bovenaan staan tussen twee regels
---de naam en de beschrijving. Zet in de beschrijving wat de skill doet en welke vragen erbij horen, in de woorden die je zelf typt. Daaronder komt de werkwijze. Het volledige bestand staat hieronder.Leg vaste controles in een script
Alles wat elke keer hetzelfde gaat, hoort in code en niet in de instructie. Het script zoekt lege velden, dubbele nummers en ongeldige datums. Claude leest de code van het script niet in, alleen wat het script terugmeldt. Zo kost het controleren geen ruimte in het gesprek.
Test met een gewone vraag
Start
claudein het project en vraag iets wat bij de beschrijving past, zonder de skill te noemen. Typ/skillsom te zien welke skills Claude Code kent. Wil je hem zeker laten draaien, begin je bericht dan met/csv-controle.
---
name: csv-controle
description: Controleert een CSV-export (klanten, facturen, bestellingen) op lege verplichte velden, dubbele nummers en datums die niet kloppen, voordat je hem importeert of doorstuurt. Gebruik bij "controleer deze export", "klopt dit bestand", "kan ik dit importeren".
---
# CSV controleren
1. Draai het script op het bestand dat de gebruiker noemt:
`python3 .claude/skills/csv-controle/scripts/controleer.py <bestand.csv>`
2. Het script geeft per probleem regelnummer, kolom en wat er mis is. Verzin geen extra problemen.
3. Rapporteer zo:
- Eerste regel: "Klaar om te importeren" of "N problemen in M regels".
- Daarna een tabel: Regel | Kolom | Probleem | Voorstel.
- Pas het bestand niet aan, tenzij de gebruiker dat vraagt..claude/skills/csv-controle/SKILL.md, getest met Claude Code 2.1.321 op 11 november 2026.
#!/usr/bin/env python3
"""Controleert een CSV: lege velden in de eerste kolom en kolommen met 'naam', 'mail' of 'datum', dubbele waarden in de eerste kolom, datums die niet JJJJ-MM-DD zijn."""
import csv, sys, datetime
pad = sys.argv[1]
with open(pad, newline='', encoding='utf-8-sig') as f:
rijen = list(csv.DictReader(f))
if not rijen:
print("Leeg bestand"); sys.exit()
kol = list(rijen[0].keys()); sleutel = kol[0]
verplicht = [k for k in kol if k == sleutel or any(w in k.lower() for w in ('naam', 'mail', 'datum'))]
gezien, n, fout = {}, 0, set()
for i, r in enumerate(rijen, start=2):
for k in verplicht:
if not (r.get(k) or '').strip():
print(f"regel {i} | {k} | leeg"); n += 1; fout.add(i)
v = (r.get(sleutel) or '').strip()
if v and v in gezien:
print(f"regel {i} | {sleutel} | dubbel, ook op regel {gezien[v]}"); n += 1; fout.add(i)
gezien.setdefault(v, i)
for k in kol:
if 'datum' in k.lower() and (r.get(k) or '').strip():
try: datetime.date.fromisoformat(r[k].strip())
except ValueError: print(f"regel {i} | {k} | geen geldige datum (JJJJ-MM-DD): {r[k].strip()}"); n += 1; fout.add(i)
print(f"{n} problemen in {len(fout)} van de {len(rijen)} regels").claude/skills/csv-controle/scripts/controleer.py. Alleen Python zelf nodig, geen extra pakketten.
(opent op ware grootte)Zo hebben we getest of hij op het goede moment laadt
We maakten een testproject met klanten.csv: vier klanten, met een leeg e-mailadres, een lege naam, 30 februari als startdatum en een klantnummer dat twee keer voorkomt. Daarna stelden we Claude Code twee vragen met claude -p, de modus waarin je één opdracht geeft en het antwoord terugkrijgt. Met de optie --output-format stream-json zie je elke stap, ook het moment waarop een skill wordt geladen.
| Vraag | Skill geladen? | Wat er gebeurde |
|---|---|---|
| Kan ik klanten.csv zo importeren in mijn boekhouding? | Ja | Script gedraaid, tabel met 4 problemen en een voorstel per regel. Klaar na 15,6 seconden. |
| Bedenk een korte slogan voor een bakkerij in Utrecht. | Nee | Direct een slogan, zonder skill of script. |
Eén ding verraste ons. Het script meldde eerst ‘4 problemen in 4 regels’, terwijl de problemen in drie regels zaten. Claude Code zette dat recht in zijn rapport. Wij pasten het script daarna aan: nu staat er ‘4 problemen in 3 van de 4 regels’. Lees de eerste rapporten van een nieuwe skill dus kritisch. Zo vind je de fouten in je eigen werkwijze.
Wat kost een skill die niet gebruikt wordt? We stelden vier keer dezelfde korte vraag, twee keer met en twee keer zonder de skill in het project. Het totaal aan tokens lag tussen 28.682 en 28.713, met en zonder skill door elkaar. Een token is een stukje tekst van een paar letters. De beschrijving kostte dus minder dan het verschil tussen twee gewone runs. Anthropic noemt zo'n 100 tokens per skill.
Skill, CLAUDE.md, plugin of subagent
| Wat | Wat het is | Kies het voor |
|---|---|---|
| CLAUDE.md | Instructies die bij elke start van het project worden gelezen | Regels die altijd gelden |
| Skill | Werkwijze die pas laadt als de vraag erbij past | Een klus die af en toe terugkomt |
| Plugin | Pakket met skills, commando's, hooks of MCP-servers | Een set delen met anderen |
| Subagent | Aparte helper met een eigen, leeg gesprek | Zoekwerk dat veel leest maar weinig terugmeldt |
Een skill kan ook als subagent draaien. Zet dan context: fork in de kop van SKILL.md. Dat is handig als de skill veel bestanden leest die je daarna niet meer nodig hebt.
Skills van anderen installeren
Anthropic zet voorbeeldskills op GitHub, waaronder de skills voor Word, Excel, PowerPoint en PDF. In Claude Code voeg je die verzameling toe als plugin-marktplaats en installeer je daarna een pakket:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skillsZo houden wij honderd skills werkbaar
Wij werken met zo'n honderd skills naast elkaar. Ons instructiebestand noemt alleen de soorten skills in een paar regels, als een dunne wegwijzer; de inhoud staat in de skills zelf. Elke beschrijving is één of twee zinnen, met de woorden die mensen typen vooraan. Overlappen twee skills, dan krijgt elk een eigen taak of voegen we ze samen. Wat dat kost, zagen we met /context in een gewone sessie: alle beschrijvingen samen namen 10.000 tokens in, zo'n 1% van het contextvenster. Per skill was dat 60 tot 230 tokens, afhankelijk van de lengte van de beschrijving.
Eigen regels zetten we altijd in een eigen skill en nooit in een skill van een ander. Die worden bij een update overschreven en dan ben je je aanpassing kwijt. Met /skill-doctor (Claude Code 2.1.252 of nieuwer) zie je per skill wat hij kost en hoe vaak hij gebruikt wordt.
Vragen
Hoe installeer je een skill in Claude Code?
Zet de map met SKILL.md in ~/.claude/skills/ of in .claude/skills/ van je project. Komt hij uit een plugin-marktplaats, gebruik dan /plugin install. Bestond de map skills nog niet, typ dan /reload-skills.
Wanneer laadt Claude een skill, en hoe stuur je dat?
Als je vraag past bij de beschrijving. Je stuurt het met de beschrijving: zeg wat de skill doet en welke vragen erbij horen. Wil je hem alleen zelf kunnen starten, zet dan disable-model-invocation: true in de kop.
Hoe zie je of een skill gebruikt is?
In een gewone sessie zie je de aanroep in het gesprek. Met claude -p en --output-format stream-json staat hij als stap in de uitvoer.
Hoe beheer je veel skills zonder dat ze de context vullen?
Houd de beschrijvingen kort. Alleen die staan altijd in beeld; de rest laadt pas als hij nodig is. Gebruik /skill-doctor om ongebruikte skills op te sporen.
Bronnen
- Claude Code: Skills (mappen, velden, /skills, /skill-doctor, context: fork) gecontroleerd op
- Claude Platform: Agent Skills overview gecontroleerd op
- GitHub: anthropics/skills (installeren via plugin-marktplaats) gecontroleerd op
Meer over claude in de praktijk
- Wat zijn Claude Skills? Uitleg, een werkend voorbeeld en wanneer je ze gebruiktClaude Skills uitgelegd met een werkende skill die Nederlandse teksten nakijkt. Getest in Claude Code, met het verschil met CLAUDE.md, MCP en prompts.
- Claude Code installeren: kiezen, installeren en je eerste taakClaude Code installeren met één commando: getest op een schone Mac en Linux. Met de keuze terminal, app of editor, de foutmeldingen en een eerste taak.
- Wat is Claude Code? Uitleg met vijf taken die we het zelf lieten doenClaude Code leest je bestanden, past ze aan en voert opdrachten uit. Wij gaven het vijf kantoorklussen: dit deed het, dit kost het en hier schoot het tekort.
- De beste Claude-skills: tien getest tegen Claude Code zonder skillWij lieten tien bekende Claude-skills dezelfde taak doen als Claude Code zonder skill. Drie voegden echt iets toe. Met de scores, de afvallers en waarom.
Ook handig
- AI-nieuws deze week: wat er van 2 tot 10 november 2026 veranderde in de tools die je gebruiktAI-nieuws van 2 tot 10 november 2026 voor ondernemers: nieuwe Claude-modellen, updates van Codex, Gemini CLI en n8n, en wat je ermee doet.
- Claude Code kosten: abonnement, limieten en wat een klus kostClaude Code zit in Pro ($20), Max en Ultra. Wij maten vijf klussen drie keer: gemiddeld $0,28 per klus met Opus en $0,09 met Sonnet. Met rekenvoorbeeld.
- Claude Code changelog in gewone taal: wat er van 2 tot 10 november 2026 veranderdeDe Claude Code-changelog van 2 tot 10 november 2026 in gewone taal: wat je gebruikt, wat breekt en onze eigen test. Laatste versie: 2.1.322.