Een SEO skill is een map met een instructiebestand waarin je vastlegt hoe een terugkerende SEO-taak wordt uitgevoerd. Claude leest die instructie pas op het moment dat je werk erom vraagt. Het verschil met een prompt: je legt de werkwijze een keer vast, inclusief je uitzonderingen, je bronnen en de vorm van de oplevering. Daarna komt er elke keer hetzelfde uit.
Wij draaien er zelf elf, waarvan acht voor SEO-werk. Hieronder staat hoe ze zijn opgebouwd, plus een complete skill voor een on-page check die je kunt kopieren.
Waarom een skill en niet gewoon een prompt
Wie Claude of ChatGPT voor SEO gebruikt, loopt na een paar weken tegen hetzelfde aan. De uitkomst is goed zolang je zelf in het gesprek zit, maar elke keer net anders. De ene keer krijg je een tabel, de andere keer een verhaal. De ene keer wordt de zoekterm uit je export gehaald, de andere keer verzint het model er een. Je herhaalt in elk gesprek dezelfde uitleg over je klanten, je bronnen en je regels.
Een skill lost dat op. Het is geen slimmere prompt, maar een vastgelegde werkwijze: een mapje op je computer of in je account met een instructiebestand, en optioneel een sjabloon, een script en voorbeelden. Claude ziet standaard alleen de naam en de omschrijving. Vraag je om werk dat bij die omschrijving past, dan leest het model de rest van het bestand en volgt het je eigen stappenplan.
Dat verschil is groter dan het klinkt. In een prompt schrijf je op wat je wilt. In een skill schrijf je op hoe het werk gaat, inclusief de fouten die je niet meer wilt zien. Bij ons staat in de analyse-skill bijvoorbeeld dat er nooit een site wordt voorgesteld met minder dan duizend organische bezoekers per maand, en dat de site eerst live bekeken wordt voordat er iets over geschreven wordt. Dat zijn regels die uit fouten zijn ontstaan, en ze staan er nu voorgoed in.
Vorm | Wanneer actief | Waar hij voor bedoeld is |
Prompt in een gesprek | Eenmalig, geldt alleen in dat gesprek | Losse vraag, verkenning, iets wat je een keer doet |
Vaste projectinstructie | Altijd actief, geldt voor alles in dat project | Achtergrond over je bedrijf, toon, taal |
Skill | Ligt klaar, wordt geladen als het werk erom vraagt | Een taak met stappen, bronnen en een vaste oplevering |
Hoe een skill technisch werkt
Een skill bestaat uit drie lagen die op verschillende momenten worden gelezen. Dat is de reden dat je er tientallen kunt hebben zonder dat het model traag of onnauwkeurig wordt.
Laag | Wanneer geladen | Wat erin staat |
1. Naam en omschrijving | Altijd | Ongeveer honderd tokens per skill. Hieraan herkent Claude of jouw vraag bij deze skill hoort. |
2. De instructie zelf | Zodra de skill wordt gebruikt | De inhoud van SKILL.md: je stappenplan, je regels, je opleveringsvorm. |
3. Bijlagen en scripts | Alleen als ernaar verwezen wordt | Sjablonen, naslag, voorbeelddocumenten en scripts. Kost niets zolang ze niet gebruikt worden. |
Praktisch gevolg: je mag een skill zo groot maken als je werkwijze is. Onze analyse-skill verwijst naar een stappenplan van meerdere pagina’s, een stijlgids en een script dat de exports uit de downloadmap haalt. Dat hele pakket kost niets in de dagelijkse praktijk, tot het moment dat er een analyse gemaakt moet worden.
Waar skills werken
Claude Code. Skills zijn hier gewone mappen: ~/.claude/skills/ voor jezelf, .claude/skills/ in een project dat je met collega’s deelt. Je kunt ze ook met de hand starten met een schuine streep en de naam, bijvoorbeeld /onpage-check.
Claude in de browser. Je uploadt de skill als zipbestand onder Instellingen, bij de functies. Beschikbaar op de betaalde abonnementen met code-uitvoering aan. Skills zijn daar persoonlijk: elke collega uploadt zijn eigen kopie.
De API. Via de skills-endpoints, in combinatie met de code-uitvoeringstool. Daar zijn ze wel voor de hele werkruimte beschikbaar.
Let op dat deze drie niet met elkaar synchroniseren. Een skill die je in de browser uploadt, staat niet in Claude Code en andersom. Voor de meeste SEO-teams is Claude Code de handigste plek, omdat je skills daar in een map beheert, in versiebeheer kunt zetten en met het hele team kunt delen.
Welke SEO-taken zich lenen voor een skill
De vuistregel: een taak is geschikt als je hem vaker dan drie keer per maand doet, als je er een vaste volgorde in hebt en als de uitkomst een vaste vorm heeft. Taken waarbij je elke keer opnieuw bepaalt wat je wilt weten, kun je beter in een gesprek doen.
Taak | Skill? | Waarom |
Export omzetten in een analyse | Ja | Vaste bronbestanden, vaste secties, vaste oordeelsregels |
On-page check van een pagina | Ja | Vaste checklist, altijd dezelfde volgorde van beoordelen |
Contentbriefing per zoekterm | Ja | Vaste opbouw: zoekvraag, koppen, feiten, veelgestelde vragen |
Maandrapportage voor een klant | Ja | Vaste databronnen en vaste grafieken, alleen de cijfers wisselen |
Linkselectie uit een aanbodbestand | Ja | Vaste filters, vaste beoordeling per zoekterm |
Interne links voorstellen | Ja | Vaste bron (sitemap of export), vaste vorm van de oplevering |
Strategie bepalen voor een nieuwe markt | Nee | Eenmalig, de vraag verschilt elke keer |
Een tekst schrijven zonder vaste vorm | Nee | Een gesprek werkt hier beter dan een stappenplan |
De anatomie van een SEO-skill
Elke skill is een map met daarin minimaal een bestand SKILL.md. Bovenaan dat bestand staat een blok met instellingen, daaronder de instructie in gewone taal.
Veld | Status | Waar het voor is |
name | Verplicht | Kleine letters, cijfers en streepjes. Dit is ook de naam waarmee je hem zelf start. |
description | Verplicht | Het belangrijkste veld. Hierin staat wat de skill doet en wanneer hij gebruikt moet worden. |
allowed-tools | Optioneel | Welke handelingen vooraf zijn goedgekeurd, bijvoorbeeld een bestand ophalen. |
disable-model-invocation | Optioneel | Op waar zetten als de skill alleen mag starten wanneer jij erom vraagt. |
user-invocable | Optioneel | Op onwaar zetten voor achtergrondkennis die je nooit zelf aanroept. |
De omschrijving is het scharnierpunt
Van alle regels in een skill is de omschrijving de belangrijkste. Dat is de enige tekst die altijd meeleest, en dus het enige waaraan het model kan zien of jouw vraag hierbij hoort. Een omschrijving als "voor SEO-analyses" is te vaag: dan start de skill nooit, of juist op het verkeerde moment. Zet er dus twee dingen in: wat de skill oplevert en met welke woorden je hem oproept.
Vier onderdelen die in elke goede SEO-skill staan
Het stappenplan. Genummerd, in de volgorde waarin jij het werk doet. Bij ons begint elk stappenplan met het ophalen van de bron, niet met het schrijven.
De bronregels. Waar de cijfers vandaan komen en welke bron leidend is als twee bronnen elkaar tegenspreken. Wij gebruiken bijvoorbeeld altijd Search Console voor zoekvolume in rapportages, en nooit de schatting van een tool.
De verificatieplicht. Een korte lijst met dingen die niet beweerd mogen worden zonder controle. Dit is het onderdeel dat het meeste oplevert en dat de meeste mensen vergeten.
De opleveringsvorm. Welke secties, welke tabellen, hoeveel pagina’s, welk bestand. Zonder dit onderdeel krijg je elke keer een andere vorm.
Een complete SEO-skill om te kopieren
Hieronder staat een werkende skill voor een on-page check. Maak in Claude Code de map ~/.claude/skills/onpage-check/ aan, zet de tekst in een bestand SKILL.md en start een nieuw gesprek. Vanaf dat moment kun je zeggen "on-page check op deze pagina" met een URL erbij.
Die laatste regel is met opzet toegevoegd. Een on-page check eindigt vaak bij een pagina die inhoudelijk in orde is en toch op plek elf staat. Dan ligt het niet aan de tekst, maar aan het aantal sites dat naar die pagina verwijst. Een skill die dat benoemt, houdt je weg van eindeloos sleutelen aan een pagina die iets anders nodig heeft.
De acht SEO-skills die wij zelf draaien
Wij gebruiken Claude dagelijks voor klantwerk. Wat begon als losse prompts, staat nu vast in skills. Ter illustratie, met wat elke skill oplevert:
Skill | Wat erin gaat | Wat eruit komt |
Analyse | Ahrefs-exports staan klaar | Analyse-PDF van tien pagina's over posities, markt en linkprofiel |
Scan | Alleen een domeinnaam | Lichte analyse van drie pagina's voor een nieuwe aanvraag |
Keyword research | Exports per markt | Bestand met volume, huidige positie, gewenste pagina en conclusie per zoekterm |
Copy | Een URL of een zoekterm | Ontleding van de bestaande tekst, daarna de herschreven pagina |
Onderzoek | Een site die opnieuw geschreven wordt | Briefings per pagina, vragenlijst voor de klant, voorbeeldtekst |
Linksuggesties | URL plus linkprofiel | Vijf onderbouwde plaatsingen uit het actuele aanbod |
Voorstel | Na een analyse | Voorstel met budgetopties en aanpak |
Reporting | Maandelijkse data | Bijgewerkte klantomgeving met posities en cijfers per markt |
De winst zit niet in het schrijven. Die zit in de regels die elke keer meegaan. In de analyse-skill staat bijvoorbeeld dat een site pas voorgesteld mag worden bij minimaal duizend organische bezoekers per maand, dat de site eerst live bekeken moet worden voordat er een oordeel over verschijnt, en dat een tabel met zoekresultaten altijd de volledige top tien laat zien. Elk van die regels komt voort uit een keer dat het misging.
Dat is meteen het beste advies over skills: begin niet met het schrijven van de perfecte instructie. Doe het werk een keer met de hand, kijk wat er misgaat, en schrijf die correctie op. Na vijf keer heb je een skill die beter werkt dan wat je vooraf had kunnen bedenken.
Anthropic publiceert open source skills op github.com/anthropics/skills. Daar zit geen SEO-skill bij, wel een skill die je helpt skills te maken (skill-creator). Handig als startpunt: je beschrijft je werkwijze en krijgt de mapstructuur terug. De inhoud, en dus het verschil met je concurrent, blijft je eigen werkwijze.
Wat er misgaat bij SEO-skills
De omschrijving is te vaag. Gevolg: de skill start nooit vanzelf. Zet de woorden erin die je zelf gebruikt als je om het werk vraagt.
De skill is een verlanglijst in plaats van een werkwijze. Een goede skill beschrijft de volgorde van handelingen, niet de gewenste uitkomst.
Geen bronregels. Zonder afspraak over waar de cijfers vandaan komen, krijg je aannemelijke getallen die niet kloppen. Dit is bij SEO het grootste risico, omdat een verzonnen zoekvolume er precies zo uitziet als een gemeten zoekvolume.
Alles in een skill. Een skill per taak werkt beter dan een grote skill die alles doet. Ze kunnen elkaar aanroepen.
Skills uit onbekende bron. Een skill kan het model opdracht geven om bestanden te lezen, dingen op te halen en code uit te voeren. Gebruik alleen skills die je zelf hebt gemaakt of die uit een bron komen die je vertrouwt, en lees ze door voor je ze installeert.
Betaalde koppelingen zonder rem. Laat een skill niet ongelimiteerd data ophalen bij een tool die per opvraging kost. Zet er een grens in.
Waar een skill ophoudt
Een skill maakt je werk sneller, consistenter en beter overdraagbaar. Wat een skill niet doet, is je site autoriteit geven. Als je pagina inhoudelijk klopt en toch onder de concurrentie blijft staan, is dat vrijwel altijd omdat er minder sites naar je pagina verwijzen dan naar die van hen. Dat is precies het punt waarop een on-page check stopt.
Dat geldt inmiddels ook voor de vraag of je in AI-antwoorden wordt genoemd. Uit onze eigen meting bleek dat AI-assistenten vrijwel altijd de pagina van het merk zelf als bron pakken, en niet het artikel dat elders over dat merk is geschreven. De route loopt dus via je eigen pagina’s, en die pagina’s moeten daarvoor wel bovenaan de zoekvraag staan. Meer daarover in onze analyse van waarom het ene merk wel in ChatGPT verschijnt en het andere niet en in de tien prompts voor linkbuilding met Claude en ChatGPT.
Wil je weten hoeveel verwijzingen je tekortkomt op je belangrijkste pagina’s? Vraag een gratis analyse van je linkprofiel aan. Wil je het werk niet zelf doen, dan kun je linkbuilding uitbesteden en houd je je skills over voor het werk op je eigen site.
Veelgestelde vragen
Kan Claude mijn SEO doen?
Claude kan het werk doen dat een vaste vorm heeft: analyses uit exports, checks op pagina’s, briefings, rapportages en selecties. Wat het niet doet, is bepalen waar je bedrijf op moet winnen en of een markt de investering waard is. Dat blijft een keuze die je zelf maakt, met de analyse als onderbouwing.
Wat is het verschil tussen een skill en een custom GPT of een project?
Een project of custom GPT is een omgeving met vaste instructies die altijd meelezen. Een skill ligt klaar, wordt pas geladen als het werk erom vraagt en kan bestanden en scripts meenemen. Je kunt er daardoor tientallen naast elkaar hebben.
Heb ik Claude Code nodig voor een SEO-skill?
Nee. Je kunt een skill als zipbestand uploaden in Claude in de browser, op de betaalde abonnementen met code-uitvoering aan. Claude Code is wel handiger zodra je met meerdere mensen aan dezelfde werkwijze werkt.
Bestaan er kant-en-klare SEO-skills?
Er is geen officiele SEO-skill. Losse skills zijn online te vinden, maar de waarde zit in jouw werkwijze, jouw bronnen en jouw regels. Een gekopieerde skill levert het werk van iemand anders op.
Kan ik een skill delen met mijn team?
In Claude Code zet je de skill in de projectmap en deel je hem via versiebeheer. Via de API geldt een skill voor de hele werkruimte. In de browser is een skill persoonlijk: daar uploadt iedereen zijn eigen kopie.