Wat er werkelijk in de SKILL.md staat
Een skill is zo goed als zijn instructies, dus die beschrijven we hier gewoon. Het bestand telt 2.744 woorden en bestaat uit tien hoofdstukken: de theorie, wat de skill altijd doet, een verplichte inputchecklist, de schrijfregels, de outputstructuur, een uitgewerkt voorbeeld, wanneer je welke variant gebruikt, hoe je bestaand werk reviewt, wat de skill nooit doet, en de bronnen.
Het opent met een frontmatter waarin staat wanneer Claude de skill moet oppakken. Niet alleen bij de expliciete termen als eerste principes denken, eerste beginselen, first principles, vanaf de basis denken, aannames blootleggen, assumption mapping, riskiest assumption en kostenopbouw afpellen. Ook bij vragen die niets met een framework te maken hebben: klopt mijn businessplan, wat zie ik over het hoofd, waarom is dit zo duur, kan dit fundamenteel anders.
En bij verzuchtingen die je eerder in een kantine hoort dan in een strategiesessie: iedereen in de branche werkt zo dus wij ook, we hebben dit gekopieerd van een concurrent, mijn investeerder vraagt waarom dit werkt en ik heb geen goed antwoord, onze prijs is gebaseerd op wat de rest vraagt.
Direct daaronder staat de rolomschrijving, en die is ongewoon streng voor een AI-instructie: de skill bevestigt niets uit beleefdheid, zoekt de aanname waar het hele plan op rust en die niemand heeft gecontroleerd omdat iedereen in de branche hem deelt, en verzint geen cijfers, marktgegevens of onderzoeksresultaten.
De kern is een lijst van acht vaste handelingen. Hij herschrijft het doel tot een meetbare zin met een termijn en haalt de oplossing eruit als die er al in verstopt zit. Hij pelt het plan af en scheidt natuurwetten en rekenkundige feiten van contractuele feiten en van conventies. Hij legt acht tot twaalf aannames bloot, verdeeld over de klant, de markt, de uitvoering, de techniek, het geld en de regelgeving, elk als falsifieerbare bewering. Hij scoort elke aanname op kans en impact, van 1 tot 5, en noteert de bewijssterkte.
Daarna wordt het scherper. Hij markeert de hoogst scorende als primaire gevaren, meestal twee tot vier. Hij levert per gevaar een herontwerpstap die je deze week kunt uitvoeren plus de goedkoopste toets. Hij bouwt het plan opnieuw op vanaf wat er overbleef en benoemt per stap of die afwijkt van het oorspronkelijke plan en waarom. En hij sluit af met de risico's die je bewust accepteert, zodat er een keuze ligt in plaats van een blinde vlek.
Voordat er iets gebeurt loopt de skill een verplichte inputchecklist na van zeven punten: het plan in je eigen woorden, de termijn waarbinnen het moet slagen, wat er op het spel staat aan geld, tijd, reputatie of bedrijf, waar het plan vandaan komt, de harde randvoorwaarden, wat je al zeker weet en waarop dat is gebaseerd, en wat er eerder in deze richting is geprobeerd. Hij vraagt alleen na wat ontbreekt en stopt daarna met vragen, dus je krijgt geen formulier maar hooguit een paar gerichte vragen.
De output ligt vast in acht blokken in vaste volgorde: het doel scherp gesteld, afgepeld in drie lijsten, de aannames, de scoretabel, de primaire gevaren, het herontwerp per gevaar, het plan opnieuw opgebouwd in vijf tot acht stappen, en bewust geaccepteerd. Daarnaast bevat het bestand een uitgewerkte casus over een online cursus, zes situaties waarin je welke variant kiest, een reviewmodus met zes controles voor een bestaand plan of een bestaande risicoanalyse, zeven dingen die de skill nooit doet, en zes bronnen. Wil je zien hoe zo'n bestand technisch is opgebouwd, van frontmatter tot weigeringenlijst, dan legt een SKILL.md schrijven dat stap voor stap uit.
Opvallend veel regels gaan over taal, en ze zijn niet allemaal cosmetisch. Helder Nederlands, je-vorm, geen streepjes in lopende tekst, AI in hoofdletters, geen rijtjes van precies drie, concreet boven abstract, cijfer boven bijvoeglijk naamwoord. Maar de laatste schrijfregel is inhoudelijk en misschien wel de belangrijkste van het hele bestand: formuleer elke aanname zo dat hij fout kan blijken. Die ene regel bepaalt of de rest van de analyse ergens over gaat.
