Naar de inhoud
Mia Automation
NLEN Inloggen Zet Mia aan het werkBeginnen

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.

Claude in de praktijkBijgewerkt op 7 min lezen

Zelf getest op 11 november 2026.

Bewegend schema in vier stappen: de vraag of klanten.csv geïmporteerd kan worden, de skill csv-controle past, het script controleer.py draait en het rapport meldt 4 problemen in 3 regels

Waar Claude Code skills zoekt

Uit de documentatie van Claude Code, gecontroleerd op 11 november 2026.
PlekMapGeldt voor
Persoonlijk~/.claude/skills/<naam>/SKILL.mdAl je projecten op deze computer
Project.claude/skills/<naam>/SKILL.mdDit project; zet hem in Git en je team heeft hem ook
Plugin<plugin>/skills/<naam>/SKILL.mdWaar 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

  1. 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.

    bash
    mkdir -p .claude/skills/csv-controle/scripts
  2. Schrijf 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.

  3. 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.

  4. Test met een gewone vraag

    Start claude in het project en vraag iets wat bij de beschrijving past, zonder de skill te noemen. Typ /skills om te zien welke skills Claude Code kent. Wil je hem zeker laten draaien, begin je bericht dan met /csv-controle.

markdown
---
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.

python
#!/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.

PowerShell-venster op Windows 10 met de mapstructuur .claude\skills\csv-controle met SKILL.md en scripts\controleer.py, de kop van SKILL.md en de uitvoer van het script: 4 problemen in 3 van de 4 regels (opent op ware grootte)
Dezelfde skill op een Windows-pc. Het script werkt ook zonder Claude, zo test je het eerst los.

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.

Claude Code 2.1.321 op Linux, 11 november 2026.
VraagSkill geladen?Wat er gebeurde
Kan ik klanten.csv zo importeren in mijn boekhouding?JaScript gedraaid, tabel met 4 problemen en een voorstel per regel. Klaar na 15,6 seconden.
Bedenk een korte slogan voor een bakkerij in Utrecht.NeeDirect 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

WatWat het isKies het voor
CLAUDE.mdInstructies die bij elke start van het project worden gelezenRegels die altijd gelden
SkillWerkwijze die pas laadt als de vraag erbij pastEen klus die af en toe terugkomt
PluginPakket met skills, commando's, hooks of MCP-serversEen set delen met anderen
SubagentAparte helper met een eigen, leeg gesprekZoekwerk 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:

text
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

Zo 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