The AI Persuasiveness Analyst skill for Claude
You paste a landing page, sales email or pitch into Claude and you get a psychological report back: a score from 0 to 100, a quote from your own text as proof for each principle, and three to five sentences rewritten next to the original. Not on gut feeling, but against three proven frameworks: Cialdini's seven principles, the Heath brothers' SUCCESs model and Kahneman's layers of thinking. If a principle is missing, the skill simply says so. That is not bluntness, that is the whole point.
the lines above come from the zip on this page · SKILL.md is 6,228 bytes
Text in, report out
reg. P.001This is the example that appears in the SKILL.md itself, shown here in shortened form: a sales email that reads fine at first glance, until you hold it up against the three frameworks. The numbers in the report come from that example, not from measuring a real client text. Note the shape of every observation: no opinion without a quote.
What the AI Persuasiveness Analyst is
The AI Persuasiveness Analyst is a free skill from our library of 100 skills. A skill is an instruction file, SKILL.md, that gives an AI assistant a fixed way of working for one task; what that format actually is you can read in what are Claude skills NL. This one is compact, 882 words of instruction, and does exactly one thing: it takes commercial copy apart psychologically. Not on gut feeling, the file says itself, but with three proven frameworks: Cialdini, Heath and Kahneman. The output is a report with a score, concrete weaknesses and rewritten sentences that actually land with the reader.
You recognise the problem the skill solves by the question you ask yourself after hitting send: why is nobody replying? The text was neat, the spelling was correct, the offer was good. But neat is not persuasive. Most commercial copy fails not on language but on psychology: there is no proof in it that others already trust you, there is no reason to reply now rather than next month, and the core message is buried in paragraph three. Those are not style errors, they are missing principles, and you can only find them by looking systematically.
That systematic approach is the core of the file. It runs through Cialdini's seven principles, the six pillars of Made to Stick and Kahneman's layers of thinking, and ticks off per principle whether it is demonstrably in the text. Demonstrably means here, literally: with a direct quote from your text as proof, or a short explanation of why it is missing. By its own description it works for landing pages, cold emails, sales emails and nurture flows, adverts on Meta, Google and LinkedIn, pitches and one pagers, whitepaper introductions, social posts with a commercial goal, and quotes.
It belongs in the skill library NL that we make freely available from the AI and automation service, with no account and no sales email afterwards. For marketers, copywriters and business owners who do not want to guess why a text does or does not work.
Why tidy copy doesn't persuade
The sales email in the example above is not a bad text. It is friendly, error free and professional. And it scores 58 out of 100, because friendly and error free are not persuasion principles. What goes wrong can be pointed to framework by framework.
There is proof, but of the wrong kind. The email leans entirely on authority: ten years of experience, ISO certified. That is one of the seven principles, and it is the principle that is about you. Social proof, the principle that is about people like the reader, is completely missing. When in doubt, people look at what similar people did, not at what you say about yourself.
Nothing sticks. Held up against the six pillars of Made to Stick, the email falls flat: the core message only appears in paragraph three, the opening is predictable, the promise of more results is not concrete, and there is no emotion and no story in it. The Heath brothers keep asking the same question: does this stick or not. With this email, not.
There is no reason to reply now. The Kahneman layer looks at what the text does to fast, intuitive thinking. Here: not much. No anchor value that colours the rest of the numbers, no loss framing. The email only promises gain, and according to Prospect Theory people react more strongly to what they stand to lose than to what they might gain. A text that only promises gain misses the urgency that loss framing provides.
The rewrite in the example shows how small the change can be. Note: the new sentence is an example sentence from the file that shows how you add principles, not a measurement from us or from a real client. The numbers in it are the kind of proof you have to pull from your own records.
Five blocks, fixed order
reg. P.002Every analysis the skill produces consists of the same five blocks, in the same order: first the verdict, then the evidence per framework, and only after that the fix. The mono lines below explain why each block sits where it does.
What is actually inside the SKILL.md
A skill is only as good as its instructions, so we just describe them here. The file opens with a frontmatter stating when Claude should pick the skill up: for requests like make this text stronger, why is this not working, check my landing page copy, is this persuasive, analyse my mailing, my copy is not working, what psychology is in this, or more conversions from this text. And also every time copy, an advert, a sales email, a landing page or a pitch is put in front of it. Whoever says something like that to Claude while the skill is loaded gets it automatically.
After that comes the process, seven steps in fixed order. Read the text in full. Classify the goal: inform, sell, recruit or persuade a decision. Determine the audience and the use case if they are supplied, and ask if they are not. Run through the three frameworks in order: Cialdini, Heath, Kahneman. Calculate the persuasiveness score based on how many principles are present, weighted for relevance to the goal. Write the rewrites with the weakest part first. And close with a final conclusion in two sentences.
The strictest part of the file is the rules for the analysis. Always quote the original text with every observation. Never invent principles that are not there: if social proof is missing, just say so. Do not give style tips such as shorter sentences or an active voice, unless they directly touch a psychological principle. When in doubt, refer back to the source. Deliver a rewrite even if the score is already high, because there is always room to improve. Write the analysis in Dutch unless the original text is English. And always write AI in capital letters.
The file closes with a worked example of a full analysis, the report you saw shortened in FIG.01, and a source list of four titles: Cialdini, the Heath brothers, Kahneman, and the original Prospect Theory paper by Tversky and Kahneman. If you want to learn to build an instruction file like this yourself, the full method is in writing SKILL.md NL.
Three frameworks, one score
reg. P.003The score is a sum of what is demonstrably in the text, weighted for the goal. The yardstick as the file defines it, and the three checks filled in with the example from the SKILL.md: this shows you where the 58 comes from and where the room to grow sits.
# scale and score taken literally from the SKILL.md · the 58 belongs to the example email, not to a real measurement
The theory the skill rests on
Four sources are named, and the rule in the file is that the analysis refers back to those sources whenever there is doubt. That is deliberate: it lets you read them yourself and decide whether you agree.
The influence comes from Robert Cialdini. The expanded 2021 edition of Influence is used, with seven principles: reciprocity, consistency, social proof, liking, authority, scarcity and unity. Each principle describes a fixed route by which people arrive at yes, and the check is simple: is that route demonstrably in your text or not. Note what the skill does not do: it does not teach you to apply the principles in a conversation or campaign, it tests whether they are in a text.
The stickiness comes from Chip and Dan Heath. Made to Stick from 2007 answers a different question than Cialdini: not why people say yes, but why some messages stick and others evaporate. The six pillars, from Simple to Stories, form the second block of every report.
The thinking comes from Daniel Kahneman. Thinking, Fast and Slow from 2011 describes the two layers in which people think: the fast, intuitive System 1 and the slow, rational System 2. A text that only speaks to System 2 asks effort from the reader, and effort is the enemy of conversion. That is why it checks for the shortcuts that do speak to System 1: anchoring, framing, availability and familiar words.
The loss framing comes from Tversky and Kahneman together. Prospect Theory from 1979 showed that people react more strongly to loss than to gain. Hence the separate test: is there loss aversion in the text, or is only gain promised? It is the most commonly missed lever in commercial copy, and at the same time the lever you have to handle most carefully, because manufactured urgency falls apart under scrutiny.
If you want to work on the structure of the argument after the analysis, you can continue with two neighbours from the library: the Pyramid Principle Writer skill for the order of the argument, and the SCQA Communication Coach skill NL for the tension arc of your opening. This analyst tells you what is missing; those two help you fill the gap.
What the skill refuses
reg. P.004The SKILL.md contains seven rules for the analysis, and they matter at least as much as the frameworks themselves. An analysis that just tells you what you want to hear is worthless, and an analysis without proof is an opinion. In conversation the rules play out like this: every rule below is a request you could make, with the response the skill gives according to its own instructions.
Installing it in Claude Code, Claude.ai or Codex
The zip contains one folder, persuasiveness-analyst, with the SKILL.md inside it. Installing is a matter of putting the file in the right place, and that place differs per environment. SKILL.md has been an open standard since December 2025, so the same skill also works in Codex, Cursor and Gemini CLI. So you are not downloading a Claude file but a working instruction that any modern AI assistant can read. The extended guide per environment is in installing Claude skills NL.
- Unzip it into
~/.claude/skills/(or.claude/skills/in your project). - Claude then recognises the skill by itself as soon as you paste a text and ask whether it persuades.
- Calling it directly also works, with
/overtuigingskracht-analist.
- Go to Customize and then Skills.
- Upload the zip there as a skill.
- Or paste the contents of SKILL.md into the project instructions of a Project.
- Open
AGENTS.mdin your repository. - Paste the contents of SKILL.md into it, or keep SKILL.md as a separate file next to it and point to it from
AGENTS.md. - Codex reads that along at every session.
After that, using it is simple: paste the text and ask why it does or does not work. Add the goal and the audience if you know them, because the weighting of the score depends on it; if they are missing, the skill asks for them. If you are new to files like this, the knowledge base has the wider explanation of working with AI.
When to use it and when not to
It is at its strongest on texts that ask something of the reader: a click, a reply, a signature. The list from the file itself: landing pages, cold emails, sales emails and nurture flows, adverts on Meta, Google and LinkedIn, pitches and one pagers, whitepaper introductions and social posts with a commercial goal. Quotes can go through it too, and the file gives the advice right there: combine it with the AI Quote Writer skill, which builds the structure of the document while this analyst tests the psychological charge.
There are also limits. You will not get style advice here: spelling, rhythm and tone are editing work, and that is not what you come to a psychological analyst for. It does not predict conversion: the score measures how many principles are demonstrably in the text, not how many people will click tomorrow, because that also depends on your offer, your price and your audience. And it does not turn a bad offer into a good one. If nobody wants your service, that is not down to a lack of loss framing.
The most honest limit sits in how you use the outcome. What gets exposed here are persuasion levers, and you can pull those the wrong way too: inventing scarcity that is not there, claiming proof you do not have. Do not do that, and the skill will not help you with it: it points out where a principle is missing, but the real proof has to come from your own records. The texts before and after in the chain have their own skills: the SPIN Sales Conversation NL for the conversation where you gather the arguments, and the Negotiator for the conversation that follows your persuasive proposal.
Run it yourself, or have it run
reg. P.005This skill is the free do it yourself version of work we also deliver as a service. It stays complete, with no catches, but be aware of what a skill is: it teaches your AI how to do something, while every new session starts empty. It is not the engine and not the memory. You prompt, you paste every text again, you check it. Whoever wants that differently has two next steps: hand over the engine, or sort out the memory.
where you are now The skill: you are the engine You run the AI Persuasiveness Analyst yourself in Claude, Codex or Cursor. Costs nothing, works today, and you keep it entirely in your own hands: no trial period, no locked parts. The limit is your own time: it only happens when you prompt.
have it prepared The AI employee: it is ready without you prompting If your bottleneck is not one text but the whole of your commercial groundwork, there is the AI employee as a service. For sales work Mansotti, the company of which TheSEO is the trading name, builds the Sales employee, which does prospect research; alongside that there is also the Quote employee (preparing enquiries and quotes) and the Reporting employee (weekly and monthly reports). Control stays with you, because output stays a draft until a person approves.
everything from one source Jarvis: all your AI tools work from the same company knowledge The skill teaches the AI, the brain is where the memory lives. If you want all your AI tools working from the same company knowledge: that is Jarvis, the organisation brain. It connects ChatGPT, Claude, Codex and your people to the same projects, core knowledge and decisions, so your next AI session does not start over. For this skill that means: you do not have to supply your tone of voice, your audience and your real proof again for every analysis. What that delivers in practice, from the plans to your first week, you can read at Jarvis itself.
What Jarvis actually delivers
reg. P.006Rung 3 deserves more than a paragraph, because with copy in particular memory is the difference. The analyst points out every time that you are missing social proof; the brain remembers what proof you have, which tone has been agreed and which rewrite was approved last time. Jarvis is the organisation brain: it remembers what your AI tools need to know, splits up the work and keeps track of what happened. You notice it first with the very next text you write.
We have been running on this system ourselves for months, and that is the only reason it is on this page. Every agent session, every task and every decision is logged in it and can be read back. A new session therefore does not start blank: it first fetches the recorded decisions, the running projects and the latest changes, and carries on where the previous one stopped. So this is not a promise we are describing but the way we work every day.
See all four plans at jarvis/prijzen NL. Through the waiting list NL you only pass on your preferred plan, without obligation. That does not create an account, an order or a duty to pay. We discuss business bespoke work first.
The skills around it
reg. P.007A persuasive text never stands alone: a conversation comes before it, an argument structure sits underneath it and a negotiation follows after it. These skills from the same library of 100 each take a different piece of that chain.
The sales chain
before and after the textThe text is one link. These three take the conversation before and after it.
AI Quote WriterBuilds the document your persuasive text has to land in; the file recommends the combination itself.SKILL SPIN Sales ConversationThe conversation where you gather the arguments and quotes that make your copy credible.SKILL NL NegotiatorFor the conversation that follows your persuasive proposal, when the client wants to talk price.SKILLThe structure
the structure under the textThe analyst points out the gap. These two help you fill it.
Pyramid Principle WriterThe order of the argument: conclusion first, evidence after.SKILL SCQA Communication CoachThe tension arc of your opening: situation, complication, question, answer.SKILL NLThe foundations
understand firstNew to skills? These three articles explain the format.
What are Claude skillsWhat a SKILL.md is, why the format works and what you can do with it.DOC NL Installing Claude skillsThe full installation guide per environment, step by step.DOC NL Writing SKILL.mdBuild a skill yourself following the open standard.DOC NLLooking further
the contextWhere this skill comes from and what else there is.
The whole skill libraryAll 100 free skills in one place, sorted by topic.HUB NL AI and automationThe service behind it: from single skills to working automation in your business.SRV AI trainingIf your team wants to learn to set up this kind of work by themselves.SRV NL Knowledge baseArticles on SEO, AI and online visibility, searchable.DOCFrequently asked questions
What does the AI Persuasiveness Analyst skill cost?
Nothing. The skill is free, falls under the MIT licence and you do not need to create an account or leave an email address. You download a 3.1 KB zip containing a folder and a single file, SKILL.md, and that is the complete skill. There is no paid version and no sales email follows afterwards.
Does this skill also work in Codex, Cursor or Gemini CLI?
Yes. SKILL.md has been an open standard since December 2025, so the same file also works in Codex, Cursor, Gemini CLI and other tools that follow the standard. In Codex you unzip it into .agents/skills/ in your project, or into ~/.agents/skills/ for all your projects; Codex has supported SKILL.md directly since the open standard of December 2025. Putting the contents of SKILL.md into your AGENTS.md still works too. The instructions are just readable text, so any AI assistant that accepts instruction files can work with it.
How is the persuasiveness score calculated?
The score from 0 to 100 is, according to the file, not a feeling but a sum of how many principles from the three frameworks are demonstrably present, weighted for relevance to the goal of the text. Below 50 is weak, 50 to 70 average, 70 to 85 strong, and above 85 exceptional. Every present principle comes with a direct quote from your text as proof, so you can check every point of the score yourself.
Does the skill also give style advice, such as shorter sentences?
No, and that is a deliberate rule in the file: no style tips such as shorter sentences or an active voice, unless they directly touch a psychological principle. The skill looks purely at psychological effect. For spelling, rhythm and tone you need other tools; this skill answers only one question, namely why the reader does or does not act.
Does the skill also work for English texts?
Yes. The rule in the file is: write the analysis in Dutch, unless the original text is English. So an English landing page or email gets an English analysis, with the same three frameworks and the same structure of the report.
Does the skill invent principles that are not there?
No. The file is explicit about it: never invent principles that are not there, and if social proof is missing, just say so. Every observation must also carry a quote from the original text as proof. A missing principle is worth just as much in this report as a present one, because that is where your room to improve sits.
Do I also get a rewrite if my text already scores well?
Yes. The rule in the file states: deliver a rewrite even if the score is already high, because there is always room to improve. You get three to five sentences from your original text next to a stronger rewritten version, with an explanation for each rewrite of which principle was added and why it works better.
Readers first, then persuasion
A more persuasive text raises the odds that a reader acts, but there have to be readers in the first place. If too little traffic reaches your pages, the real work ahead of this analysis is: being found by the people you are looking for. The free SEO scan shows in a few seconds where your site stands. In the guide writing models compared you can see how this model relates to the others. And if you want to talk through what else AI can do for your business, from single skills to full automation, we simply do that in a conversation.