Wat er werkelijk in de SKILL.md staat
Een skill is zo goed als zijn instructies, dus die beschrijven we hier gewoon. Bovenaan staat een frontmatter waarin is vastgelegd wanneer Claude de skill moet oppakken: bij directe vragen als maak een beslismatrix of werk scenario's uit, maar ook bij de verzuchtingen hierboven, en bij reviewverzoeken als beoordeel mijn strategie of wat mis ik in deze analyse. Er staat ook expliciet in wanneer níet: kleine operationele keuzes die binnen een dag terug te draaien zijn, en puur creatieve of copytaken.
Daarna volgt de kern: zeven vaste handelingen die elke analyse doorloopt. Eerst wordt je vraagstuk herschreven tot één beslisvraag met een tijdshorizon, en die krijg je ter bevestiging voorgelegd. Hij schrijft een diagnose van hooguit zes zinnen die de werkelijke belemmering benoemt, los van wat je wilt horen. Hij bouwt drie tot vijf scenario's op de twee onzekerheden met de grootste impact, elk met vroege signalen.
Hij zet minimaal vier opties op tafel, waaronder altijd niets doen en altijd één optie die je zelf niet noemde. Hij scoort de opties in een gewogen beslismatrix waarvan de criteria en gewichten eerst vaststaan. Hij voert een blinde vlekken check uit met minimaal vier vragen die de aanbeveling kunnen omverwerpen. En hij sluit af met een actieplan in drie tijdvakken plus tripwires.
Voordat er iets geanalyseerd wordt, loopt de skill een verplichte inputchecklist met acht punten na: het vraagstuk in jouw woorden, de termijnen, het bedrijf, de harde randvoorwaarden zoals budget en contracten, wat er gebeurt als je niets doet, wie er meebeslist, welke opties je zelf al ziet inclusief de opties die je bij voorbaat afwijst, en waar je bang voor bent. Die laatste is geen psychologie maar techniek: angsten leveren volgens het bestand vaak de scherpste beslicriteria op. Wat ontbreekt vraagt hij in één keer na, en daarna werkt hij door met wat er is.
De outputstructuur ligt vast in negen blokken, altijd in dezelfde volgorde: de beslisvraag met scope-afbakening, de diagnose, de scenario's, de opties, de beslismatrix met uitleg waar hij wankelt, de risico's en blinde vlekken, het advies met actieplan en een expliciet vertrouwensniveau, de tripwires, en een verantwoording van welke modelonderdelen zijn gebruikt en welke aannames zijn ingevuld.
Daarnaast kent het bestand een reviewmodus met zes checks voor bestaand werk en een hoofdstuk over varianten: de strategiecascade van Lafley en Martin voor de vraag hoe het hele bedrijf moet winnen, real options denken voor besluiten die je kunt opknippen, en het tweerichtingsdeur onderscheid, waarbij omkeerbare besluiten bewust een verkorte analyse krijgen. Wil je zelf zo'n bestand leren schrijven, dan legt SKILL.md schrijven die opbouw stap voor stap uit.
Opvallend veel regels gaan over taal en eerlijkheid. Hij schrijft in de je-vorm, wisselt korte en lange zinnen af, vermijdt AI-wendingen en holle superlatieven, kiest een cijfer boven een bijvoeglijk naamwoord, en schrijft de aanbeveling als een keuze in plaats van een overweging. Elke zelf ingevulde aanname draagt zichtbaar het woord aanname. Onderaan staat een lijst van zeven dingen die de skill nooit doet en een bronnenlijst van zeven titels. Daarover hieronder meer.