De AI Pyramid Principle Schrijver skill voor Claude
Je plakt een rommelige tekst, mail of pitch in Claude en je krijgt hem terug als piramide: de kernboodschap bovenaan, daaronder 3 tot 5 argumenten die elkaar niet overlappen, en onder elk argument het bewijs. De methode komt van Barbara Minto, die haar bij McKinsey ontwikkelde, en de skill dwingt haar strengste regel af: begin met het antwoord, niet met de context. Wat je terugkrijgt is geen los blok tekst maar een schema, een executive summary van maximaal 250 woorden en een inleiding van drie zinnen, klaar om te plakken in een mail, rapport of slide.
de regels hierboven komen uit de zip op deze pagina · SKILL.md is 5.333 bytes
Rommel in, piramide uit
reg. P.001De governing thought in dit voorbeeld komt letterlijk uit de SKILL.md: het is de zin die het bestand zelf opvoert als goed voorbeeld van een kernboodschap. De argumenten en cijfers eromheen zijn schematisch ingevuld om de werkwijze te tonen. Let op de volgorde van de zes stappen: het antwoord wordt eerst scherp gemaakt, en pas daarna mag er geschreven worden.
Wat de AI Pyramid Principle Schrijver is
De AI Pyramid Principle Schrijver is een gratis skill uit onze eigen skill-bibliotheek. Een skill is een instructiebestand, SKILL.md, dat een AI-assistent een vaste werkwijze meegeeft voor één taak. Geen software die je installeert, geen abonnement, geen sjabloon: één tekstbestand van 785 woorden dat Claude vertelt hoe hij elke tekst moet ombouwen naar de structuur van Barbara Minto, in welke volgorde de zes stappen lopen en welk outputformaat er altijd uitkomt. Je downloadt de zip bovenaan deze pagina, zet hem in je Claude-omgeving en vanaf dat moment structureert Claude je teksten volgens deze logica. Weet je nog niet precies wat een skill is, lees dan eerst wat Claude skills zijn.
Het probleem dat de skill oplost herken je aan één symptoom: je tekst is lang, maar de kern is onduidelijk. De mail aan de investeerder begint bij de oprichting van je bedrijf. De memo aan de directie bouwt drie pagina's spanning op naar een conclusie die niemand meer leest. Het jaarplan somt twaalf punten op waarvan er drie hetzelfde zeggen. De lezer moet door alle bijzaken heen voordat hij snapt waar het over gaat, en de meeste lezers halen dat punt nooit. Die volgorde draait de skill om: eerst het antwoord, dan de argumenten, dan pas het bewijs.
Volgens zijn eigen beschrijving is hij bedoeld voor wie hoort: schrijf dit gestructureerder, mijn boodschap landt niet, mijn e-mail is rommelig, maak dit pitch ready. De sterkste toepassingen staan er zelf in genoemd: een e-mail aan een investeerder over een pivot, een interne memo over een reorganisatie, de executive summary van een slide deck, een pitch voor een nieuwe klant, een jaarplan voor de directie, of een blogartikel dat moet overtuigen. Hij hoort bij de bibliotheek van 100 gratis skills die we vanuit de dienst AI en automatisatie beschikbaar stellen, zonder account en zonder verkoopmail achteraf. Alle skills staan op de hub skills.
Eén ding moet je vooraf weten: de skill structureert, hij verzint niet. De argumenten komen uit jouw materiaal en het bewijs moet van jou komen. Ontbreekt er data onder een argument, dan komt daar geen mooie volzin te staan maar een open punt met een vraag aan jou. Dat is geen beperking, dat is de reden dat de eindtekst een kritische lezer overleeft.
Waarom de meeste zakelijke teksten niet landen
Barbara Minto ontwikkelde de Pyramid Principle in de jaren zestig bij McKinsey, waar ze als een van de eerste vrouwelijke consultants rapporten van collega's moest redigeren. Haar observatie was simpel en is sindsdien de standaard geworden voor consultants, executives en managers: de meeste mensen schrijven in de volgorde waarin ze dachten, niet in de volgorde waarin een lezer beslist. Ze beginnen bij de aanleiding, werken door de analyse heen en eindigen met de conclusie. De lezer wil precies het omgekeerde.
De kern komt te laat. Een drukke lezer geeft een stuk dertig seconden om duidelijk te maken waar het over gaat. Staat het antwoord op pagina drie, dan is de lezer op pagina één al gestopt of, erger, zelf een conclusie gaan raden. Daarom eist de skill dat de governing thought de allereerste zin van de eindtekst is, nog voor de inleiding.
De kernzin is geen antwoord. Veel teksten hebben wel een soort kern, maar het is een beschrijving: wij hebben de markt geanalyseerd. Dat is geen boodschap, dat is een activiteit. In het bestand staat dat de governing thought een mening of aanbeveling moet zijn, in één zin moet passen, concreet en meetbaar is, en de vraag uit de inleiding beantwoordt. Marketing speelt een belangrijke rol wordt in het bestand letterlijk als slecht voorbeeld afgewezen.
De argumenten overlappen of missen. Twaalf losse punten zijn geen redenering. Wat hij afdwingt zijn 3 tot 5 argumenten die MECE zijn: ze sluiten elkaar uit en dekken samen het geheel, op dezelfde logische laag. Appels naast appels, geen half argument dat eigenlijk bij een ander hoort.
Het bewijs is lucht. Studies tonen aan, iedereen weet, het is algemeen bekend: zulke ondersteuning wijst de skill af. Onder elk argument hoort een concreet cijfer, voorbeeld of bron, en waar dat ontbreekt komt een open punt te staan in plaats van een gok.
In diff-vorm, met de voorbeelden uit het bestand: wat eruit gaat en wat ervoor terugkomt.
Drie lagen, vaste volgorde
reg. P.002Elke output van de skill heeft dezelfde vorm: een top, een middenlaag en een fundament. De lezer leest van boven naar beneden en mag op elk punt stoppen, want het belangrijkste is dan al gezegd. De inhoud in de blokken volgt het voorbeeld uit FIG.01.
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 beschrijving van wanneer Claude de skill moet oppakken: bij expliciete termen als pyramid principle, Minto methode, MECE denken of McKinsey structuur, maar ook bij alledaagse verzuchtingen als schrijf dit gestructureerder, mijn e-mail is rommelig, haal de hoofdboodschap eruit, of wanneer een tekst lang is maar de kern onduidelijk. Wie zoiets tegen Claude zegt terwijl de skill is geladen, krijgt hem automatisch.
Daarna volgen de zes stappen. Stap één is de SCQA-framing: de skill vraagt naar de situatie die iedereen als bekend aanneemt, de complicatie die er verandering in bracht, de vraag die daaruit volgt en jouw korte antwoord daarop. Stap twee maakt van dat antwoord de governing thought en toetst hem aan vier eisen: een mening of aanbeveling, in één zin, concreet en meetbaar, en een echt antwoord op de vraag. Stap drie laat Claude 3 tot 5 argumenten voorstellen en toetst ze op MECE: geen overlap, samen dekkend, op dezelfde logische laag.
Stap vier kiest de redeneervorm: deductief, met premissen die naar een conclusie leiden, of inductief, met parallelle punten die dezelfde boodschap dragen, waarbij het bestand aantekent dat inductie voor executive communicatie vaak sneller en krachtiger is. Stap vijf eist bewijs per argument en wijst vage ondersteuning af.
En stap zes bouwt de eindtekst volgens een vaste opbouw van zeven onderdelen: de governing thought als eerste zin, de SCQA-inleiding in maximaal drie zinnen, een signpost, drie argumenten met elk twee zinnen bewijs, en een slotzin die de kernboodschap herhaalt.
Het outputformaat ligt ook vast, en dat is voor de praktijk misschien wel het nuttigst. Je krijgt altijd drie blokken: de piramide als schema met de argumenten en het bewijs eronder, de volledige tekst in executive summary vorm van maximaal 250 woorden, en de SCQA-inleiding van drie zinnen als los blok. Het schema plak je in een slide, de tekst in een mail, de inleiding boven een rapport. Wie zelf zo'n instructiebestand wil bouwen vindt de opbouw stap voor stap in een SKILL.md schrijven.
Het bestand sluit af met een bronnenlijst van drie titels: het boek van Minto zelf, de structured communication guidelines uit het McKinsey Quarterly archief, en Power Cues van Nick Morgan. Daarover hieronder meer.
MECE: niets dubbel, niets vergeten
reg. P.003MECE is het strengste onderdeel van de methode en het punt waar de meeste zelfgebouwde piramides omvallen. Elk argument wordt op twee manieren getoetst, precies zoals het bestand ze voorschrijft: overlappen twee argumenten, dan worden ze samengevoegd, en valt de redenering niet om als je een argument weghaalt, dan gaat dat argument eruit. De inhoud hieronder is schematisch, de toetsen zijn letterlijk.
De theorie waarop de skill rust
De SKILL.md noemt drie bronnen bij naam, en dat is bewust: dan kun je ze nalezen en zelf beslissen of je het met de methode eens bent.
De methode komt van Barbara Minto. The Pyramid Principle: Logic in Writing and Thinking verscheen in 1987 bij Pearson Education en is de canonieke uitwerking van wat ze in de jaren zestig bij McKinsey ontwikkelde. Alles wat de skill afdwingt staat daar: het antwoord eerst, de SCQA-inleiding, de piramide van argumenten, en het onderscheid tussen deductief en inductief redeneren. Het boek is geen vlot leesvoer, en dat is precies waarom een skill die de methode uitvoert praktischer is dan de methode uit je hoofd leren.
De praktijkregels komen uit het McKinsey Quarterly archief. De structured communication guidelines die daar door de jaren heen zijn gepubliceerd, vertalen Minto naar het dagelijkse werk: hoe kort een inleiding mag zijn, hoe je een signpost gebruikt, waarom een executive summary met de aanbeveling begint. De vaste opbouw van zeven onderdelen in stap zes leunt op die traditie.
De ontvangerkant komt van Nick Morgan. Power Cues verscheen in 2014 bij Harvard Business Review Press en gaat over hoe boodschappen overkomen: wat een luisteraar of lezer in de eerste seconden oppikt en waarom de volgorde van informatie zo zwaar weegt. Het onderbouwt de dertig-seconden-eis die de skill aan de eindtekst stelt.
Ook zonder de skill te installeren kun je met deze principes je eigen tekst verbeteren: schrijf eerst je conclusie op in één zin, streep elk argument weg dat de redenering niet nodig heeft, en zet onder elk overgebleven argument een cijfer dat je kunt laten zien. Wie na de structuur ook wil dat de boodschap zelf blijft hangen, vindt de meetlat daarvoor in de Made to Stick Coach skill, en wie het opdelen van problemen als losse vaardigheid wil trainen begint bij de MECE Probleem Structuur Coach skill.
Wat de skill afwijst
reg. P.004De SKILL.md heeft geen losse verbodslijst, maar de zes stappen zelf zitten vol harde afwijzingsregels, en die zijn minstens zo belangrijk als wat de skill wel doet. In het gesprek pakken ze zo uit: elke regel is een verzoek of een aanlevering die je zou kunnen doen, met de reactie die de skill volgens zijn eigen instructies geeft.
Installeren in Claude Code, Claude.ai of Codex
De zip bevat één map met daarin de SKILL.md. Installeren is een kwestie van het bestand op de juiste plek zetten, en die plek verschilt per omgeving. SKILL.md is sinds december 2025 een open standaard, en dezelfde skill werkt daardoor ook in Codex, Cursor en Gemini CLI. Je downloadt dus geen Claude-bestand maar een werkinstructie die elke moderne AI-assistent kan lezen.
- Pak de zip uit in
~/.claude/skills/(of.claude/skills/in je project). - Claude herkent de skill daarna vanzelf zodra je een tekst wilt structureren.
- Direct aanroepen kan ook, met
/ai-pyramid-principle-schrijver.
- Ga naar Customize en dan Skills.
- Upload de zip daar als skill.
- Of plak de inhoud van SKILL.md in de projectinstructies van een Project.
- Open
AGENTS.mdin je repo. - Plak de inhoud van SKILL.md erin, of zet SKILL.md er als los bestand naast en verwijs ernaar vanuit
AGENTS.md. - Codex leest dat bij elke sessie mee.
Daarna is het gebruik simpel: plak je rommelige tekst, mail of aantekeningen en zeg wat het moet worden, bijvoorbeeld een memo aan de directie of een executive summary. Hij stelt de SCQA-vragen die nodig zijn om het antwoord scherp te krijgen en bouwt daarna de piramide. Loop je vast bij het installeren, dan staat de volledige route per omgeving in Claude skills installeren. De bredere uitleg over werken met AI vind je in de kennisbank.
Wanneer je hem wel en niet gebruikt
Op zijn sterkst is hij bij teksten die om een beslissing vragen: de mail aan de investeerder, de memo over een gevoelige verandering, het jaarplan, de pitch, de executive summary boven een lang rapport. Overal waar een drukke lezer in dertig seconden moet snappen wat je van hem wilt, betaalt de piramide zich direct uit. Ook als denkgereedschap werkt hij goed: wie zijn eigen plan niet in één governing thought met drie dragende argumenten krijgt, weet meteen waar het plan zelf nog rammelt. Dat is vaak de grootste winst: de structuur legt bloot wat er inhoudelijk ontbreekt.
Er zijn ook situaties waarin je hem beter laat liggen. Teksten die het juist van spanning en opbouw moeten hebben, een verhaal, een casestudy die naar een onthulling toewerkt, een speech met een climax, verliezen hun kracht als het antwoord in de eerste zin staat. Voor beschrijvende documentatie zonder boodschap, een handleiding of een verslag, voegt een piramide weinig toe: daar is niets te beargumenteren. En de methode ordent argumenten, maar maakt ze niet waar: een governing thought die inhoudelijk niet klopt wordt door een strakke structuur alleen maar sneller doorgeprikt, omdat de lezer hem nu wel meteen ziet staan.
De eerlijkste grens zit in het bewijs. Cijfers eist hij wel, en wat ontbreekt markeert hij, maar hij kan niet controleren of jouw cijfers kloppen. Die controle blijft gewoon bij jou liggen. De open punten die hij teruggeeft zijn dus huiswerk, geen formaliteit: een piramide op ongecontroleerd bewijs is een risico met een mooie structuur eromheen.
Zelf draaien of laten draaien
reg. P.005Deze skill is de gratis doe-het-zelf-versie van werk dat we ook als dienst leveren. Hij blijft compleet en zonder addertjes, maar besef wat een skill is: hij leert je AI hoe hij iets doet, terwijl elke nieuwe sessie leeg begint. Hij is niet de motor en niet het geheugen. Jij prompt, jij levert elke keer opnieuw je cijfers en je context aan, jij controleert. Wie dat anders wil, heeft twee vervolgstappen: de motor uit handen geven, of het geheugen regelen.
waar je nu bent De skill: jij bent de motor Je draait de AI Pyramid Principle Schrijver zelf in Claude, Codex of Cursor. Kost niets, werkt vandaag, en je houdt het volledig in eigen hand: geen proefperiode, geen afgeschermde onderdelen. De grens is je eigen tijd: het gebeurt alleen wanneer jij prompt, en je levert elke sessie opnieuw de cijfers en context aan waar de piramide op moet staan.
laten voorbereiden De Offertemedewerker: het terugkerende schrijfwerk staat klaar Een adviesnota of een pitch schrijf je zelf, want de kernboodschap is een keuze en geen samenvatting. Wat wel als dienst kan is het schrijfwerk dat elke week terugkomt: binnenkomende aanvragen gesorteerd op kans en urgentie, met per aanvraag een conceptantwoord dat al is opgebouwd van kernboodschap naar onderbouwing. Dat is de Offertemedewerker van Mansotti, de onderneming waarvan TheSEO de handelsnaam is, die daarnaast de andere twee rollen bouwt en het werk daaromheen op maat inricht. De controle blijft bij jou, want output blijft concept tot een mens akkoord geeft. Lees wat een AI-medewerker is en doet.
alles uit een bron Jarvis: al je AI's werken vanuit dezelfde bedrijfskennis De skill leert de AI, het brein is waar het geheugen leeft. Wil je dat al je AI's vanuit dezelfde bedrijfskennis werken: dat is Jarvis, het organisatiebrein. Het verbindt ChatGPT, Claude, Codex en je mensen met dezelfde projecten, kernkennis en beslissingen, zodat je volgende AI-sessie niet opnieuw begint. Jarvis selecteert context, delegeert werk en bewaart alleen wat is goedgekeurd: klantkennis blijft geïsoleerd en elke stap laat een controleerbaar spoor na. Ook deze skill wordt daar beter van, want de cijfers en besluiten waar je piramides op rusten hoef je dan niet meer per gesprek aan te leveren. Wat dat concreet oplevert, van de plannen tot je eerste week, lees je bij Jarvis zelf.
Wat Jarvis concreet oplevert
reg. P.006Trede 3 verdient meer dan een alinea, want dit is het verschil tussen een slimme chat en een systeem waar je op kunt bouwen. Jarvis is het organisatiebrein: het onthoudt wat je AI's moeten weten, verdeelt het werk en houdt bij wat er gebeurde. Bij gestructureerd schrijven merk je dat meteen, want een piramide staat op bewijs, en het bewijs, de eerdere besluiten en de huisregels voor directie-stukken zijn precies wat je anders elke sessie opnieuw aanlevert.
Wij draaien zelf al maanden op dit systeem. Elke agent-sessie, elke taak en elke beslissing wordt erin gelogd en is terug te lezen. Een nieuwe sessie begint daardoor niet blanco: hij haalt eerst de vastgelegde besluiten, de lopende projecten en de laatste wijzigingen op, en werkt verder waar de vorige stopte. We beschrijven dus geen belofte maar de werkwijze waar we zelf dagelijks in werken.
Bekijk de vier plannen op jarvis/prijzen. Via de wachtlijst geef je alleen vrijblijvend je voorkeursplan door. Dat maakt nog geen account, bestelling of betalingsplicht. Zakelijk maatwerk bespreken we eerst.
De skills eromheen
reg. P.007Structuur is één schakel: er komt een boodschap in de piramide en er moet iemand van overtuigd raken. Deze skills uit dezelfde bibliotheek pakken elk een ander stuk van dat werk.
Dezelfde schrijffamilie
de structuurDe piramide ordent het betoog. Deze twee geven andere tekstsoorten hun vaste vorm.
AIDA CopywriterBouwt advertenties en salesteksten langs aandacht, interesse, verlangen en actie.SKILL StoryBrand SchrijverZet de klant in de hoofdrol van je verhaal, voor teksten die juist wel spanning nodig hebben.SKILLVoor de logica
het denkwerkMECE is hier één stap. Deze twee maken er een complete denkdiscipline van.
MECE Probleem Structuur CoachTraint het opdelen van problemen zonder overlap en zonder gaten, los van het schrijven.SKILL Overtuigingskracht AnalistToetst of je argumentatie ook overtuigt bij de lezer die het er niet mee eens is.SKILLVoor de boodschap
de plakkrachtEen strakke piramide met een vergeetbare kern blijft vergeetbaar. Dit is het vervolg.
Made to Stick CoachScoort je governing thought op de zes SUCCESs-principes en maakt hem memorabel.SKILL Een SKILL.md schrijvenZelf zo'n instructiebestand bouwen, stap voor stap uitgelegd.DOCVerder kijken
de contextWaar deze skill vandaan komt en wat er nog meer is.
Wat zijn Claude skillsDe uitleg onder alles: wat een SKILL.md is en waarom het een open standaard werd.DOC De hele skill-bibliotheekAlle 100 gratis skills op een rij, per onderwerp gesorteerd.HUB AI en automatisatieDe dienst erachter: van losse skills naar werkende automatisering in je bedrijf.SRV AI-trainingenAls je team dit soort werk zelf wil leren opzetten.SRVVeelgestelde vragen
Wat kost de Pyramid Principle Schrijver skill?
Niets. De skill is gratis, valt onder de MIT-licentie en je hoeft geen account aan te maken en geen e-mailadres achter te laten. Je downloadt een zip van 2,7 KB met daarin een map en een enkel bestand, SKILL.md, en dat is de complete skill. Er is geen betaalde versie en er komt geen verkoopmail achteraan.
Werkt deze skill ook in Codex, Cursor of Gemini CLI?
Ja. SKILL.md is sinds december 2025 een open standaard, en hetzelfde bestand werkt daardoor ook in Codex, Cursor, Gemini CLI en andere tools die de standaard volgen. In Codex pak je de zip uit in .agents/skills/ in je project, of in ~/.agents/skills/ voor al je projecten; Codex ondersteunt SKILL.md sinds de open standaard van december 2025 rechtstreeks. De inhoud van SKILL.md in je AGENTS.md zetten kan ook nog steeds. De instructies zijn leesbare tekst, dus een AI-assistent die instructiebestanden accepteert kan ermee overweg.
Wat is een governing thought precies?
De zin die bovenaan de piramide staat: je kernboodschap. Het bestand stelt er vier eisen aan. Het moet een mening of aanbeveling zijn en geen beschrijving, hij moet in een zin passen, hij moet concreet en meetbaar zijn, en hij moet de vraag uit de SCQA-inleiding beantwoorden. Marketing speelt een belangrijke rol wordt afgewezen als te vaag. Verhoog het Google Ads budget met 40 procent in Q3 is er wel een: daar kun je het mee oneens zijn, en dat is precies de bedoeling.
Wat betekent MECE en waarom is het belangrijk?
MECE staat voor Mutually Exclusive, Collectively Exhaustive: de 3 tot 5 argumenten onder je kernboodschap mogen elkaar niet overlappen en moeten samen de volledige redenering dekken, op dezelfde logische laag. De skill toetst dat actief. Overlappen twee argumenten, dan worden ze samengevoegd. En valt de redenering niet om als je een argument weghaalt, dan was dat argument niet nodig en gaat het eruit. Zo blijft alleen de redenering over die echt draagt.
Wat als ik geen cijfers of bewijs heb voor een argument?
Dan verzint de skill niets. Vage ondersteuning zoals studies tonen aan of iedereen weet wordt volgens het bestand afgewezen, en een argument zonder data wordt gemarkeerd als open punt, met de vraag aan jou om het aan te leveren. Dat voelt streng, maar het is de reden dat de eindtekst overeind blijft als iemand kritisch doorvraagt: elk argument draagt bewijs dat je kunt laten zien.
Kiest de skill zelf tussen deductief en inductief redeneren?
De skill kent beide vormen uit het werk van Minto en kiest welke bij jouw boodschap past. Deductief is premisse, premisse, conclusie: drie stappen die werken voor logische bewijsvoering. Inductief is drie parallelle punten die dezelfde boodschap ondersteunen, en dat werkt voor business cases en overtuigen. Het bestand geeft daarbij de vuistregel dat inductie voor executive communicatie vaak sneller en krachtiger is, omdat alle argumenten op hetzelfde niveau staan.
Wat krijg ik precies terug en hoe lang is dat?
Altijd hetzelfde vaste formaat, in drie delen. Eerst de piramide zelf: de governing thought met daaronder de argumenten en per argument het bewijs, als schema. Dan de volledige tekst in executive summary vorm van maximaal 250 woorden, opgebouwd volgens een vaste volgorde van zeven onderdelen. En tot slot de SCQA-inleiding van drie zinnen die je boven een mail of memo kunt zetten. Je kunt het schema in een slide plakken en de tekst in een mail, zonder nabewerking.
Een piramide met een lezer eronder
Een piramide zorgt dat je boodschap landt bij wie hem leest. In een mail regel je dat publiek zelf; op je website beslist de zoekmachine mee wie er binnenkomt. Zet je deze structuur in op pagina's die nauwelijks bezocht worden, dan schrijf je de scherpste kernboodschap voor niemand. De gratis SEO scan laat in enkele seconden zien welke pagina's meedoen en welke stil blijven. In de gids schrijfmodellen vergeleken zie je hoe dit model zich tot de andere verhoudt.