🛠 Claude Skills: een map vol instructies + templates waar Claude zelf uit kiest

Hoofdonderwerpen

• Claude Skills uitgelegd — Anthropic's nieuwe feature waarmee je Claude een vaardigheid leert via een mapje met instructies, templates en tools. Niet alleen een prompt, maar een heel pakket.
• De IKEA-analogie — een skill is als het plastic zakje bij een IKEA-kast: zit een handleiding in (SKILL.md), losse onderdelen (templates, logo's, voorbeelden) en gereedschap (Python-scripts). Claude pakt wat hij nodig heeft.
• Progressive disclosure (techniek waarbij de AI eerst alleen de titel en korte beschrijving van een skill leest, en pas het volledige document opent als hij besluit dat de skill relevant is) — zo blijft de context limiet (het maximale aantal woorden dat Claude tegelijk kan verwerken, rond de 200.000 tokens) niet vol lopen.
• Sub-agents (AI's die een andere AI zelf opstart om een deeltaak uit te voeren met zijn eigen schone context) — gerelateerd aan skills omdat Claude onderliggend werk kan delegeren.
• Praktijkvoorbeelden — Wouter's proposal-skill (80 skills in totaal), Milou's 'column wrapped' (Spotify Wrapped-stijl overzicht van haar columns), en Guido's experiment met de Remotion-skill voor video-generatie.

Key insights

• Skills zijn de volgende stap na prompten: in plaats van instructies tikken, geef je Claude een heel werkpakket dat hij zelf kan raadplegen.
• Een skill bevat minimaal een SKILL.md (markdown-bestand met instructies en YAML frontmatter — dat is een kort metadata-blok bovenaan met name + description), plus optioneel templates, voorbeelden, logo's en scripts.
• Claude leest alleen de name + description (max 1024 tekens) van elke skill om te beslissen of hij hem opent. Pas als het relevant is, duikt hij de rest in. Dit is waarom je 80 skills kunt hebben zonder dat de context dichtslibt.
• Er bestaat een Skill Creator skill — een meta-skill die je helpt nieuwe skills te bouwen via gesprek. Je zegt gewoon tegen Claude "maak een skill voor X" en hij genereert de structuur.
• skills.sh (en alternatieven zoals vercel-labs/skills via npx skills add) is een library met kant-en-klare skills die je kunt downloaden en in je .claude/skills/ map zetten.
• Skills werken nu in Claude-web, Claude Code en Cursor. ChatGPT volgt waarschijnlijk snel — Anthropic publiceerde de Agent Skills-standaard als open standaard, vergelijkbaar met wat ze deden met MCP (Model Context Protocol — de open standaard die Anthropic bedacht om AI-agents veilig met externe tools en databronnen te laten praten).

What to Build

1. Proposal-skill met Stooker huisstijl

Wat het is Een Claude-skill die offertes/voorstellen schrijft in jouw huisstijl — met logo, kleuren, font, en in de juiste toon. Claude kiest zelf welk template hij gebruikt op basis van het soort voorstel (workshop, groot transformatieproject, losse opdracht).

Hoe Wouter het bouwt

• Map .claude/skills/proposal/ met daarin:
  • SKILL.md — instructies: hoe schrijf je een voorstel, welke toon, welke secties
  • templates/ — Word-documenten met placeholders ({{klantnaam}}, {{prijs}})
  • examples/ — 20+ voorbeeldvoorstellen die hij al heeft gemaakt
  • brand/ — logo (SVG + PNG), kleurenpalet, fontinstructies
  • Variant-documenten: een voor workshops, een voor transformatietrajecten, etc.
• Claude leest Word-bestanden door Python te schrijven die het document bewerkt (niet door Word te openen). Logo komt daardoor consistent op dezelfde plek.

Web research (uit context)

• claude-office-skills op GitHub is de directe basis voor Word/PowerPoint-manipulatie.
• Vercel-labs/skills CLI: npx skills add vercel-labs/agent-skills --agent claude-code installeert skills direct in je project.
• VoltAgent/awesome-agent-skills — curated lijst van 1000+ skills om van te jatten.
• Geen kant-en-klare Nederlandse proposal-skill gevonden — kans om zelf te bouwen en te delen.

Analyse: wat kan beter voor Stooker

• Voor coffee-B2B (horeca, kantoren, retail) zijn voorstellen vaak prijsgedreven met bonenselecties, machines en service-contracten. Een goede skill heeft varianten per klantsegment (café, restaurant, kantoor).
• Overweeg meerdere sub-skills in plaats van één monoliet: offer-horeca, offer-office, quarterly-review. Focused skills werken beter dan brede skills (dat is ook de best practice uit de Anthropic docs).
• Voeg case studies en klantquotes toe als aparte resources — Claude kan die inzetten waar relevant.

Stappenplan (Stooker-versie)

1. Maak .claude/skills/stooker-proposal/ aan in een repo (of in je Claude web-settings via upload).
2. Dump 5-10 bestaande voorstellen (liefst gewonnen deals) als PDF of Word in examples/.
3. Maak één "masterproposal" in Word met je huisstijl als templates/base.docx — met placeholders waar variabele content komt.
4. Schrijf SKILL.md met: wie Stooker is, toon (specialty, direct, zonder poeha), sectievolgorde, Dutch-first, prijs-disclaimer, B Corp-vermelding.
5. Vraag de Skill Creator skill om het af te ronden: "gebruik de skill creator om mijn stooker-proposal skill te verbeteren en te testen".
6. Test met een echte recente deal: "schrijf een voorstel voor [klant X], type [horeca/office], volume [Y kg/maand]".
7. Itereer — als Claude iets mist, voeg het toe aan SKILL.md of als extra voorbeeld.

2. Remotion video-skill

Wat het is Een skill waarmee Claude via je terminal video's genereert: data-visualisaties met beweging, product-demo's, uitlegfilmpjes. Alles lokaal op je Mac.

Hoe Guido het bouwt

• npx create-video@latest — scaffold een Remotion-project (Remotion is een React-library waarmee je video's programmeert in plaats van monteert).
• npx skills add remotion-dev/skills — installeert de Remotion-skill.
• Node.js + homebrew als dependencies (waar Guido in de podcast nerveus van werd — packages zijn kleine software-onderdelen die je code nodig heeft, vaak 100+ stuks voor één project).
• npm run dev om de preview te starten, apart terminalvenster met claude voor de prompts.

Web research (uit context)

• Officiële docs: remotion.dev/docs/ai/claude-code
• Use cases: education explainers, product demos, data-viz met beweging, avatar-video's met captions, UI-animaties.
• YouTube-tutorials beschikbaar (onder andere een 16-min motion-graphics walkthrough).

Analyse: wat zou voor jou werken

• Voor Stooker super interessant voor Instagram/LinkedIn content: geanimeerde grafiekjes over cupping scores, origins, brew-parameters. Veel mooier dan een statisch plaatje.
• Ook voor interne training: korte uitlegfilmpjes over brew recipes, machine-onderhoud, etc.
• Pas op met dependencies: als je Next.js/Supabase stack al werkt, zet Remotion in een apart project-mapje zodat het elkaar niet bijt.

Stappenplan

1. Maak een nieuwe map ~/projects/stooker-videos/.
2. npx create-video@latest daarin.
3. npx skills add remotion-dev/skills --agent claude-code.
4. Start Claude Code in die map, prompt: "maak een animatie van een espresso extractie-grafiek met bloom, pre-infusion, extractie over 28 seconden".
5. Itereer tot het mooi is, export als mp4.
6. Bouw een eigen stooker-video-brand skill met je kleuren/logo zodat elke video consistent is.

3. Column Wrapped (Milou's experiment) — voor Stooker te vertalen als "Klant Wrapped" of "Jaaroverzicht"

Wat het is Spotify Wrapped-stijl overzicht gegenereerd door Claude uit je eigen tekstcorpus. Milou deed het met 80 columns (23.000 woorden). Output: favoriete woorden, langste zin, persona-analyse ("je bent een tech-optimist"), stats.

Hoe Milou het bouwt

• Gewoon alle columns in een map, die als context aan Claude geven.
• Prompt: "maak een Spotify Wrapped van mijn columns".
• Geen skill, gewoon ad-hoc — maar perfect om er een skill van te maken.

Web research (uit context)

• Geen directe "text-wrapped" implementaties gevonden, wel veel Spotify-clones op GitHub (Spotipy + Pillow + Chart.js patroon).
• Gat in de markt voor een text-based wrapped-skill.

Stappenplan voor Stooker

1. Verzamel één jaar aan content: klantcommunicatie, nieuwsbrieven, blog posts, Instagram captions.
2. Maak een skill stooker-yearly-wrap met instructies: analyseer woordgebruik, toon, veelgebruikte onderwerpen, genereer shareable stats.
3. Eind van het jaar: Claude genereert een LinkedIn-post + visuals (combineer met Remotion-skill voor bewegend beeld).
4. Variant: "Bean Wrapped" per origin — welke koffies heb je dit jaar verkocht, welke cupping scores, welke smaakprofielen. Data uit je admin-systeem plus Claude-analyse.

Takeaways voor MKB

• Skills zijn voor ondernemers veel praktischer dan custom GPTs of losse prompts. Je bouwt één keer een skill voor "offertes", "klantmails", "nieuwsbrief" — en Claude kiest zelf wanneer hij wat gebruikt. Geen copy-paste van prompts meer.
• Start met één skill, niet tien. Focus op je meest repetitieve taak (voor veel MKB: voorstellen, facturen of klantmails). Wouter heeft er 80, maar die bouwde hij over maanden op.
• De Skill Creator skill is je vriend — je hoeft niet zelf te weten hoe de structuur moet. Vraag Claude om te helpen, hij genereert de juiste bestanden.
• Huisstijl consistentie is eindelijk oplosbaar. Logo, kleuren, fonts, toon — allemaal in één skill-map. Voor een merk als Stooker (waar huisstijl veel waard is) is dit belangrijker dan voor een random corporate.
• Download first, build second. Check skills.sh, vercel-labs/skills en VoltAgent/awesome-agent-skills eerst — vaak bestaat er al iets wat je kunt aanpassen.
• Packages zijn niet eng — het is normaal dat je 100+ kleine softwareonderdelen installeert voor één project. Wel opletten: alleen van officiële bronnen (npm, homebrew), niet van willekeurige sites.
• Tinkeren wint — Milou's punt: de ondernemers die gewoon beginnen te experimenteren lopen uit op degenen die wachten tot het "volwassen" is. Een weekend avond investeren in je eerste skill is meer waard dan tien artikelen lezen.