Wat er werkelijk in de SKILL.md staat
Een skill is zo goed als zijn instructies, dus die beschrijven we hier gewoon. Het bestand opent met een frontmatter waarin staat wanneer Claude de skill moet oppakken. Niet alleen bij de voor de hand liggende termen als 5 waarom, five whys, vijf keer waarom, worteloorzaak, root cause, RCA, oorzaakanalyse, probleemanalyse, visgraatdiagram, Ishikawa, kaizen analyse, post mortem, incident analyse en klachtenanalyse, maar ook bij verzuchtingen: we hebben dit al drie keer opgelost en het komt steeds terug, we blussen alleen brandjes, iedereen wijst naar elkaar, de klant klaagt opnieuw over hetzelfde, onze deadline wordt structureel niet gehaald, de fix werkte een week. Wie zoiets tegen Claude zegt terwijl de skill geladen is, krijgt hem automatisch.
Daarna volgt een hoofdstuk over de theorie: Toyoda en Ohno, de drie lagen technisch, procesmatig en systeem, en vier varianten die de skill mag gebruiken als de context erom vraagt. De vertakte ketting voor als een laag meerdere geldige oorzaken heeft. De combinatie met het Ishikawa-diagram voor als niemand nog weet waar het probleem zit. Five whys plus how, waarbij je na de worteloorzaak de ketting terug omhoog loopt met de vraag hoe je elke laag afschermt. En de lean startup variant van Eric Ries, waarbij je per laag een investering doet die in verhouding staat tot de ernst van het probleem.
De kern is een lijst van zeven dingen die de skill altijd doet. Hij herformuleert het probleem tot een feitelijke, meetbare zin met plaats, tijd en omvang voordat er een waarom valt. Hij stelt de vijf vragen een voor een en beantwoordt ze op basis van wat jij hebt aangeleverd, niet op basis van aanname. Hij markeert per laag hoe zeker het antwoord is. Hij splitst de ketting zichtbaar in takken zodra een laag meerdere geldige oorzaken heeft, en volgt de tak met de grootste impact door.
Hij benoemt de worteloorzaak in een zin, geformuleerd als systeem of proces. Hij levert de directe fix en de structurele maatregel apart, elk met eigenaar en termijn. En hij sluit af met een verificatiestap.
Voordat er iets wordt geanalyseerd, loopt de skill een verplichte inputchecklist na van zes punten: het probleem in jouw eigen woorden, wanneer het speelt en hoe vaak, wie of wat er last van heeft, wat er al is geprobeerd en waarom dat niet hielp, welke feiten of cijfers beschikbaar zijn, en wat je wel en niet kunt veranderen aan budget, mandaat en invloed op andere afdelingen. Hij vraagt alleen na wat ontbreekt en stopt daarna met vragen. Weet je iets niet, dan gaat hij door en markeert hij die laag als onbewezen. Je krijgt dus geen formulier, hooguit twee of drie gerichte vragen.
Opvallend veel regels gaan over taal. Helder Nederlands, je-vorm, geen streepjes in lopende tekst, AI in hoofdletters, geen rijtjes van precies drie, concreet boven abstract, cijfer boven bijvoeglijk naamwoord, en korte zinnen afgewisseld met lange. Er staat zelfs een lijst met woorden en wendingen die verboden zijn omdat ze naar AI ruiken. En er is een schrijfregel die inhoudelijk is in plaats van cosmetisch: schrijf oorzaken passief waar dat de schuldvraag wegneemt. Wil je begrijpen hoe zulke regels in een skill-bestand terechtkomen, dan legt een SKILL.md schrijven de opbouw stap voor stap uit.
De output ligt vast in zeven blokken in vaste volgorde: probleemstelling, de waaromketting, worteloorzaak, directe fix, structurele maatregel, verificatie, en wat je nog moet uitzoeken. Daarnaast bevat het bestand een aparte beoordelingsmodus voor bestaande analyses, een lijst met zeven dingen die de skill nooit doet, en een bronnenlijst van vijf titels. Die laatste twee krijgen verderop op deze pagina hun eigen sectie.