Marktmannen wiki Claude Cowork en Kenniswerk

Skills, Hooks en Geheugen (AI Report)

Laatst bijgewerkt: 29-06-2026

TL;DR: Nadat je map met bestanden staat, laat je de AI het werk dóen — skills die je met één woord oproept, routines die vanzelf draaien, en twee hooks plus een sessie.md die je geheugen tussen sessies vasthouden.

Sessie 2 van de AI Report kennissysteem-reeks (Oscar Lepoeter), voortbouwend op Kennissysteem Fundering (AI Report). Het uitgangspunt: skills, automatisering en geheugen werken op elke tool (Claude, Cowork, Codex) en vragen geen regel code. Oscar heeft inmiddels 128 skills en schrijft ze zelden zelf — hij vraagt zijn chatbot er een te maken of haalt het jargon uit een gevonden skill. "Ik kijk hier bijna nooit naar. Ik toets alleen of het werkt."

Skills: leg je aanpak één keer vast

Een skill is een Markdown-bestand met een instructie in mensentaal, opgeroepen met één woord (/brief). Je kijkt naar de output, niet naar de skill. Werkt iets niet, dan pas je de skill aan via de chat — niet het opgeleverde bestand. Eén handigheid: een woord achter de skill kiest een variant/smaak (één skill, meerdere smaken).

De drie skills uit de ProRail-casus, in de volgorde van een drukke maandagochtend (wat weet ik al / wat moet ik nog weten / wat lever ik op):

  • brief — gespreksvoorbereiding van max één pagina uit je dossier: doel, deelnemers + rol, context, 3-5 gesprekspunten, openstaande acties en deliverables. Gebaseerd op je eigen bestanden, niet verzonnen. Aanroep: /brief prorail "Karel Donders" werkdocument.
  • research — web-onderzoek in drie snelheden (eerste woord kiest): quick (één ronde, ~2 min, zuinig), standaard (splitst de vraag, meerdere rondes), deep (uitgebreid verslag). Leest échte pagina's, vat samen mét bronlink, schrijft op verzoek weg in je map zodat het eigen context wordt.
  • rapport — brengt interviews + onderzoek samen tot een tussenrapportage. Truc: een mapje references/ in de skill met 2-4 echte voorbeelddocumenten (puur voor schrijfstijl, niet inhoud) zodat het niet als AI-tekst leest. Output blijft Markdown; converteer pas na controle naar Word/PDF.
  • naar-markdown (helper) — zet een Word/PDF/office-bestand of URL om naar schone, volledige Markdown. Maakt rommelige bronbestanden leesbaar voor de rest van het systeem.

De gouden regel: de agent is een stagiair, jij blijft de baas. Gebruik elke output als basis, lees na, fact-check wat ertoe doet, en verbeter de skill in plaats van het opgeleverde bestand.

Automatisering: drie lagen oplopend in zelfstandigheid

  1. Skill — jij roept aan (typt het woord, drukt enter).
  2. Routine — draait op een vast tijdstip zonder dat jij iets doet. Heet per tool anders: Routines (Claude-app), Scheduled (Cowork), Pulse (Codex). Onder de motorkap een cron-taak of launch agent. Voorbeeld: elke ochtend 8:00 checkt het systeem je agenda op één-op-één-afspraken met externen en draait automatisch de brief-skill; de briefing staat klaar als je gaat zitten.
  3. Hook — draait op een gebeurtenis i.p.v. een tijdstip (app openen, AI klaar met antwoorden).

Je beschrijft alle drie in gewone taal aan je chatbot, die het script maakt.

Geheugen dat blijft: de twee hooks

Een chatbot vergeet tussen sessies en zijn contextvenster loopt vol. Oplossing: een geheugenbestand sessie.md (scratchpad met koppen "Laatst gedaan" en "Volgende stap") plus twee hooks:

  • Hook 1 op Stop (AI klaar met antwoorden) — herinnert de agent sessie.md bij te werken. De agent cureert zelf, dus het bestand loopt niet vol.
  • Hook 2 op SessionStart (je begint opnieuw) — laadt sessie.md weer in, zodat de agent meteen weet waar je was.

settings.json koppelt beide aan de juiste momenten (pas het pad aan naar je eigen map). Belangrijk: skills en hooks kunnen globaal of project-/mapgebonden zijn. De hook schrijft naar de sessie.md in de map waarin hij draait — zo blijven projecten gescheiden (je medische aantekeningen lekken niet in je werkgeheugen). Dat is precies waarom werken-in-mappen zo aantrekkelijk is.

Waarschuwingen

  • ⚠️ Agent = stagiair, jij blijft de baas. Laat de output nooit beslissen.
  • 💡 Fact-check wat ertoe doet — skills hallucineren minder door uit jouw bestanden te putten, maar zijn niet onfeilbaar (zeker cijfers, data, citaten).
  • ⚠️ Em-dashes verraden AI-tekst. Ze sluipen er steeds in; maak een aparte skill die ze vervangt door punten/komma's/haakjes.
  • ⚠️ Privacy is niet vanzelf veilig. Lokale bestanden naar Claude sturen betekent dat ze naar de server gaan. Oplossingen in opkomst: lokale modellen (Gemma), datamaskering (bijv. Amable), inference bij NL-datacenter of Azure Sweden. Gevoelige persoonsgegevens zonder verwerkersovereenkomst? Gebruik gefingeerde namen.
  • ⚠️ Alleen skills/hooks van een vertrouwde bron — behandel als software.

Open vragen

  • Welke van de vier skills (brief/research/rapport/naar-markdown) zijn 1-op-1 bruikbaar in het Marktmannen-OS, en welke overlappen met bestaande Marktmannen-skills?

Verwante concepten

Bronnen

#skills #hooks #routines #geheugen #automatisering #niet-technisch

Backlinks