Je eerste skill maken

Wat je leert

Geschatte tijd: 20 minuten

Aan het einde van deze les kun je:

Een skill helemaal opnieuw maken met de juiste frontmatter-structuur
Testen en verifiëren dat een skill correct in Claude Code wordt geladen
Uitleggen hoe Claude Code inkomende verzoeken aan beschikbare skills koppelt
De skill-prioriteitshiërarchie beschrijven (Enterprise, Personal, Project, Plugins)

(4 minuten)

Deze video laat zien hoe je een skill helemaal opnieuw bouwt — een persoonlijke PR-beschrijvingsskill die in al je projecten werkt. Je ziet precies hoe je het SKILL. md-bestand structureert, het test en begrijpt hoe Claude Code skills ontdekt en aan je verzoeken koppelt. De video behandelt ook de prioriteitshiërarchie die bepaalt welke skill wint wanneer namen conflicteren.

Belangrijkste inzichten

Een skill is een **directory met eenSKILL. md-bestand** met metadata (naam, beschrijving) in frontmatter en instructies eronder
Claude laadt alleen skill-namen en beschrijvingen bij het starten, en koppelt inkomende verzoeken vervolgens semantisch aan die beschrijvingen
Je krijgt een bevestigingsprompt voordat Claude de volledige skill-inhoud in de context laadt
Prioriteit voor naamconflicten: Enterprise → Personal → Project → Plugins
Om een skill bij te werken, bewerk je het SKILL. md-bestand. Om er een te verwijderen, verwijder je de directory. Start Claude Code altijd opnieuw voor wijzigingen

Laten we stap voor stap een skill helemaal opnieuw maken, en dan kijken hoe Claude Code skills achter de schermen daadwerkelijk laadt en koppelt.

Een Skill maken

We bouwen een persoonlijke skill die Claude leert hoe je PR-beschrijvingen in een consistent format schrijft. Omdat het een persoonlijke skill is, staat deze in je home directory en werkt deze in al je projecten.

Maak eerst een directory voor je skill in de skills-map. De directorynaam moet overeenkomen met je skill-naam:

mkdir -p ~/. claude/skills/pr-description

Maak vervolgens een SKILL. md-bestand in die directory. Het bestand heeft twee delen gescheiden door frontmatter-streepjes:

--- name: pr-description description: Writes pull request descriptions. Use when creating a PR, writing a PR, or when the user asks to summarize changes for a pull request. ---

When writing a PR description:

Run git diff main... HEAD to see all changes on this branch
Write a description following this format:

What

One sentence explaining what this PR does.

Why

Brief context on why this change is needed

Changes

Bullet points of specific changes made
Group related changes together
Mention any files deleted or renamed

De name identificeert je skill. De description vertelt Claude wanneer het moet worden gebruikt — dit zijn de matchingcriteria. Alles na de tweede set streepjes zijn de instructies die Claude volgt wanneer de skill wordt geactiveerd.

Je Skill testen

Claude Code laadt skills bij het starten, dus start je sessie opnieuw nadat je er een hebt gemaakt. Je kunt verifiëren dat het beschikbaar is door de lijst met beschikbare skills te controleren.

Je skill zou in de lijst moeten staan. Om het te testen, breng je wat wijzigingen aan op een branch en zeg je iets als "write a PR description for my changes. " Claude geeft aan dat het de PR-beschrijvingsskill gebruikt, controleert je diff en schrijft een beschrijving volgens je template — elke keer hetzelfde format.

Hoe Skill Matching werkt

Wanneer Claude Code start, scant het vier locaties voor skills, maar laadt alleen de naam en beschrijving — niet de volledige inhoud. Dit is een belangrijk detail.

Wanneer je een verzoek verzendt, vergelijkt Claude je bericht met de beschrijvingen van alle beschikbare skills. Bijvoorbeeld, "explain what this function does" zou overeenkomen met een skill beschreven als "explain code with visual diagrams" omdat de intentie overlapt.

Zodra een match is gevonden, vraagt Claude je om het laden van de skill te bevestigen. Deze bevestigingsstap houdt je op de hoogte van welke context Claude inlaadt. Nadat je hebt bevestigd, leest Claude het volledige SKILL. md-bestand en volgt de instructies ervan.

Skill-prioriteit

Als je een repository klont die een skill met dezelfde naam als een van je persoonlijke skills heeft, welke wint? Er is een duidelijke prioriteitsvolgorde:

Enterprise — beheerde instellingen, hoogste prioriteit
Personal — je home directory (~/. claude/skills)
Project — de . claude/skills-directory in een repository
Plugins — geïnstalleerde plugins, laagste prioriteit

Dit stelt organisaties in staat om normen af te dwingen via enterprise-skills, terwijl individuele aanpassingen nog steeds mogelijk zijn. Als je bedrijf een enterprise "code-review"-skill heeft en je maakt een persoonlijke "code-review"-skill met dezelfde naam, heeft de enterprise-versie voorrang.

Om conflicten te voorkomen, gebruik je beschrijvende namen. In plaats van alleen "review", gebruik je iets als "frontend-review" of "backend-review".

Skills bijwerken en verwijderen

Om een skill bij te werken, bewerk je het SKILL. md-bestand. Om er een te verwijderen, verwijder je de directory. Start Claude Code opnieuw na wijzigingen.

Reflectie op de les

Wat is één taak in je dagelijkse workflow die je nu in een skill zou kunnen omzetten? Hoe zou de beschrijving eruitzien?
Hoe zou de prioriteitshiërarchie je team's skill-beheerstrategie kunnen beïnvloeden? Zou je meer op persoonlijke of project-level skills vertrouwen?

Wat komt volgende

In de volgende les leer je over geavanceerde configuratieopties, waaronder metagegevensvelden, tool-beperkingen met allowed-tools, en hoe je grotere skills structureert met progressieve openbaarmaking en multi-file-organisatie.

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.