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 zoekwoorden als cialdini, overtuigingsprincipes, sociale bewijskracht en schaarste, maar ook bij verzuchtingen: mijn aanbod is goed maar ze kiezen de ander, ik krijg geen antwoord op mijn mails, mensen twijfelen te lang, de pagina krijgt bezoek maar geen aanvragen, ik klink als iedereen. Wie zoiets tegen Claude zegt terwijl de skill geladen is, krijgt hem automatisch. De frontmatter noemt ook expliciet wanneer hij niet moet aanslaan: bij teksten waar overtuiging ongepast is, en om schaarste of bewijs te verzinnen dat er niet is.
Daarna volgt de theoriesectie, en die is voor een skill ongewoon uitgebreid. Alle zeven principes staan er met een eigen definitie in, plus de uitleg uit Pre-Suasion dat het moment voor de boodschap meebepaalt hoe de boodschap landt. Daarom beoordeelt de skill niet alleen of een principe aanwezig is, maar ook waar het staat. Daarnaast staan er vier varianten in die hij mag gebruiken als de context daarom vraagt: de klassieke zes zonder unity, Cialdini gecombineerd met een bezwarenanalyse, Cialdini gecombineerd met AIDA of PAS waarbij AIDA de volgorde bepaalt en Cialdini de inhoud per fase levert, en een gewogen scoring waarbij principes die niet horen buiten de score blijven in plaats van een nul te krijgen.
De kern is een lijst van zeven vaste handelingen. Hij bepaalt eerst het teksttype, de doelgroep en de gewenste actie, en stelt op basis daarvan vast welke principes zwaar wegen en welke niet van toepassing zijn. Hij geeft per principe een score van 0 tot 5 met een korte reden en met de zin die de score veroorzaakt. Hij citeert per principe letterlijk de zwakste zin, of noteert dat het principe volledig ontbreekt. Hij levert per principe een herschreven alternatief dat alleen gebruikmaakt van informatie die jij hebt aangeleverd.
Hij rangschikt de verbeteringen op verwachte impact, zodat je weet wat je eerst aanpakt. Hij levert een complete herschreven tekst. En hij voert een eerlijkheidscheck uit, waarbij elk principe dat op onwaarheid zou rusten wordt gemarkeerd en niet toegepast.
Voordat er iets gescoord wordt, loopt de skill een verplichte inputchecklist na: de tekst zelf en volledig, het teksttype en het kanaal, de doelgroep en hoeveel die al van je weet, de gewenste actie, welk bewijs er echt bestaat, of er een echte beperking is in tijd, plaats of capaciteit, en wat je gemeen hebt met de lezer. Hij vraagt alleen na wat ontbreekt en stopt daarna met vragen, dus je krijgt geen vragenlijst maar hooguit twee gerichte vragen.
De output heeft een vaste structuur van zes blokken, altijd in dezelfde volgorde: een contextsamenvatting waarin ook staat welke principes buiten beschouwing blijven en waarom, een scoretabel met score en gewicht per principe, een analyse per principe in de drieslag aanwezig, probleem, alternatief, een prioriteitenlijst op verwachte impact, de volledige herschreven tekst met notities waar een principe is toegevoegd, en de eerlijkheidscheck.
Opvallend veel regels gaan over taal. Verder schrijft het bestand je-vorm voor, verbiedt streepjes in lopende tekst, verbiedt rule of three-opsommingen waarin elk rijtje precies drie items heeft, en houdt een lijst bij van AI-woorden die niet gebruikt mogen worden: in de wereld van, ontdek, ontgrendel, naadloos, moeiteloos, naar een hoger niveau tillen, duik in, in een notendop. Ook holle superlatieven staan op de verbodslijst. En er is een harde citeerregel: wijst de skill een zin aan, dan citeert hij die letterlijk, hij parafraseert nooit.
Tot slot kent het bestand een aparte beoordelingsmodus, die het zelfs de standaardmodus noemt. Geef je een bestaande tekst mee ter beoordeling, dan komen er twee onderdelen bij: een markeringsversie waarin achter elke zin het principe staat dat die zin bedient en waarin niets staat achter zinnen die niets doen, en een overdaadcheck die aanwijst waar de tekst doorslaat. Wil je zelf zo'n instructiebestand leren opzetten, dan legt een SKILL.md schrijven uit hoe die opbouw werkt.