Skills die je agent echt slimmer maken
Een skill is een mapje met instructies dat je agent zelf oppakt zodra hij het nodig heeft. Ik publiceer ze in het open SKILL.md-formaat, dus ze werken in Claude Code, Codex, Cursor en de rest. Gratis, open source, en je pakt ze mee.
8 skills
Wat is een skill precies?
Geen plug-in en geen API. Een skill is een map met een SKILL.md erin, en je agent leest hem pas als hij denkt dat hij hem nodig heeft. Dat laatste is de hele truc.
Ontdekken
Bij het opstarten leest je agent alleen de naam en de beschrijving van elke skill. Dat kost een paar tientallen tokens per skill, dus je kunt er honderd hebben zonder dat het iets kost.
~30 tokensActiveren
Vraag je iets waar een beschrijving op past, dan laadt de agent die ene skill volledig in. Pas op dat moment leest hij de instructies, de voorbeelden en de valkuilen.
volledige inhoudUitvoeren
De skill mag scripts meebrengen. Die draaien gewoon op jouw machine, met jouw bestanden, en het resultaat gaat terug naar het gesprek.
op jouw machineHoe een skill in elkaar zit
Eén map, één verplicht bestand. De rest is optioneel en laadt alleen als de agent er echt naartoe gaat.
- mijn-skill/
SKILL.md
Het enige verplichte bestand. Bovenin twee velden in YAML: een naam en een beschrijving die zegt wanneer je de skill gebruikt. Die beschrijving is het enige waar de agent op afgaat bij het kiezen, dus daar zit het meeste werk in.
---
name: seo-audit
description: Audit a page for technical and
on-page SEO problems. Use when
asked to review SEO or diagnose
why a page does not rank.
---
# SEO audit
Audit a page the way a search engine
reads it: fetch the rendered HTML...
De description is het enige waar je agent op afgaat bij het kiezen. Schrijf er wanneer je de skill gebruikt in, niet alleen wat hij doet.
Werkt in jouw agent
SKILL.md is een open formaat en dat is precies waarom dit de moeite waard is. Je legt een map neer en je client pakt hem op. Elke installatiemap hieronder heb ik nagekeken in de documentatie van die client zelf.
Codex, Cursor, Gemini CLI en OpenCode lezen alle vier ook uit ~/.agents/skills/. Zet een skill daar neer en vier clients zien hem tegelijk.
Veelgestelde vragen
Wat mensen meestal willen weten voordat ze er een installeren.
Heb je er zelf een gebouwd?
Stuur hem in. Ik kijk hem na en zet hem erbij, met je naam erbij. Of laat me er een bouwen die precies past bij hoe jij werkt.