The Cialdini Persuasion skill for Claude
You paste an email, a landing page or a quote into Claude and you get back a scan against Robert Cialdini's seven persuasion principles. For each principle a score from 0 to 5, the weight that principle carries in your context, the weakest sentence quoted word for word, and a rewritten alternative. And an honesty check at the bottom: everything the skill deliberately did not apply because the evidence is missing. Invented scarcity is not persuasion, it is deception, and the file says so in those words.
the lines above come from the zip on this page · SKILL.md is 16,366 bytes
Seven principles, seven verdicts
reg. C.001This is the worked example that appears in the SKILL.md itself, shown here in shortened form: a cold email to practice owners of physiotherapy practices. Note the right-hand column of the scan. For each principle there is not just a score, but also whether the principle can be applied honestly. Everything the user has genuinely supplied is green. Anything the skill would have to invent to make the principle work, it refuses.
What the Cialdini Persuasion skill is
The Cialdini Persuasion skill is a free skill from our skill library. A skill is an instruction file, SKILL.md, that gives an AI assistant a fixed working method for a task. Not software you install, no subscription, no link to your email program: a 2,541-word text file that tells Claude how to test a text against Robert Cialdini's seven persuasion principles, in what order the analysis is built up, and what it must never invent under any circumstances.
You download the zip at the top of this page, put it in your Claude environment, and from that moment Claude scores texts according to this logic. What a SKILL.md exactly is, and why a text file steers the behaviour of an AI, is explained in what are Claude skills NL.
The problem the skill solves is the vagueness of the advice you normally get. Ask an AI to make your email more persuasive and you get: add social proof, make it more personal, create urgency. That sounds like advice and is not, because it does not say which sentence causes the problem, how heavily that principle weighs in your situation, or whether you even have the evidence it rests on. This file turns that around. It scores per principle, it quotes the sentence that causes the score word for word, it delivers a rewritten alternative that uses only information you have supplied, and it ends with a list of what it deliberately did not apply.
It is written for anyone who writes a text with a decision behind it: business owners sending cold emails, marketers building landing pages, consultants giving pitches, service providers sending out quotes. It is part of the skill library we make freely available from the AI and automation service, with no account and no sales email afterwards.
There is one thing you should know beforehand: this skill makes your text more persuasive, not your offer better. It adds no evidence you do not have. If you have no clients, no references, no figures and no real capacity limit, the analysis stays empty on exactly those points, and that is the outcome. The file says so itself: an invented deadline or an invented number of clients is not persuasion but deception.
Why your text is correct but does not persuade
Someone who gets no reply to their emails usually looks for the cause in the wording. They write a new version, a little slicker, a little shorter, with a punchier opening line. And then still nothing happens, because the problem was never the style. It was that the text gave the reader no reason to reply.
You ask before you have given anything. The file checks whether reciprocity is absent here; it does not establish its prevalence across all cold messages. A no-obligation call sounds like a gift but is not: it is a request for time, wrapped up as reassurance. A gift is something the reader keeps, even if they do nothing further with you. In the repaired example, the agency offers to prepare the supplied free analysis; no completed work, ranking or page count is assumed.
The text could have been sent to anyone. Liking and unity are two different things that often get lumped together. Liking is about similarity, a genuine compliment and working together towards the same goal. Unity goes a step further: not resembling, but belonging together. Region, profession, generation, shared history. A supplied connection may be relevant, but the file does not prove that no competitor can share it or that it is almost always unused.
The authority is self-declared. Specialised, expert, market leader and leading are words nobody can check. Cialdini describes authority as something that works only as long as it is visible and demonstrable: titles, publications, measurable experience, published work. An adjective is therefore best replaced with a hard number, and if the number is not there, the skill drops the claim rather than dressing it up.
The scarcity is invented. This is the most dangerous of the seven, because it is also the easiest. Typing a deadline takes a second. The instruction is strict about this: scarcity only works if it is real and the reason is stated alongside it. A real capacity limit of three places this quarter is allowed, a date you make up is not. And once a reader spots that your deadline was fake, they will doubt your numbers too, next time.
All seven at once. More principles is not more persuasion. Cramming all seven into a short text is explicitly forbidden in the instruction itself, because two or three well-executed principles beat seven half-done ones. During an assessment the skill therefore also runs an excess check: more than one scarcity element, or social proof in four sentences in a row, lowers credibility instead of raising it.
In diff form, using the elements from the skill's own example: what the skill refuses, and what it puts in its place.
Every principle has a tipping point
reg. C.002The seven principles as the SKILL.md describes them, in the order given in the file. The mono line under each principle is the tipping point: the moment the same principle stops being persuasion and becomes deception. That distinction is why the skill has a separate honesty check. Scarcity is flagged, because it is the principle that topples fastest.
What is really in the SKILL.md
A skill is only as good as its instructions, so we simply set them out here. The file opens with a frontmatter that says when Claude should pick up the skill. Not only for the obvious keywords such as cialdini, persuasion principles, social proof and scarcity, but also for frustrations: my offer is good but they choose the other one, I get no reply to my emails, people take too long to decide, the page gets visitors but no enquiries, I sound like everyone else. Anyone who says something like that to Claude while the skill is loaded gets it automatically. The frontmatter also explicitly states when it must not fire: for texts where persuasion is inappropriate, and to invent scarcity or evidence that does not exist.
Then comes the theory section, and for a skill it is unusually extensive. All seven principles are given their own definition, plus the explanation from Pre-Suasion that the moment before the message helps determine how the message lands. That is why the skill assesses not only whether a principle is present, but also where it sits. Alongside that, four variants are listed that it may use when the context calls for them: the classic six without unity, Cialdini combined with an objection analysis, Cialdini combined with AIDA or PAS where AIDA sets the order and Cialdini supplies the content per stage, and a weighted scoring where principles that do not belong stay outside the score instead of getting a zero.
The core is a list of seven fixed actions. It first determines the text type, the target audience and the desired action, and on that basis decides which principles carry weight and which do not apply. It gives each applicable principle a provisional 0-to-5 score with a verbatim sentence or explicit absence. Excluded principles receive N/A, not zero; the score is not a conversion forecast. It quotes the weakest sentence for each principle word for word, or notes that the principle is entirely absent. It delivers a rewritten alternative per principle that uses only information you have supplied.
It ranks the improvements by hypothesised impact to test, so you know what to tackle first. It delivers a complete rewritten text. And it runs an honesty check, in which every principle that would rest on an untruth is flagged and not applied.
Before anything gets scored, the skill runs through a mandatory input checklist: the text itself, in full, the text type and the channel, the target audience and how much they already know about you, the desired action, what evidence genuinely exists, whether there is a real constraint on time, place or capacity, and what you have in common with the reader. It only asks about what is missing and then stops asking, so you get no questionnaire but targeted questions about genuinely missing input.
The output has a fixed structure of six blocks, in the normal order, except that the vulnerable-audience variant puts the honesty check first: a context summary that also states which principles are left out of consideration and why, a score table with score and weight per principle, an analysis per principle in the three-part form of present, problem, alternative, a priority list by expected impact, the full rewritten text with notes where a principle has been added, and the honesty check.
A striking number of rules are about language. The file further requires the you-form, forbids dashes in running text, forbids rule-of-three lists in which every set has exactly three items, and keeps a list of AI words that may not be used: in the world of, discover, unlock, seamless, effortless, take to the next level, dive into, in a nutshell. Hollow superlatives are also on the banned list. And there is a strict quoting rule: when the skill points to a sentence, it quotes it word for word, it never paraphrases.
Finally, the file has a separate assessment mode, which it even calls the default mode. Hand it an existing text for assessment, and two extra parts are added: a marked-up version in which the principle each sentence serves is noted after it, and nothing is noted after sentences that do nothing, which are your candidates for cutting, and an excess check that points out where the text overdoes it. If you want to learn to set up an instruction file like this yourself, writing a SKILL.md NL explains how that structure works.
Score and weight, never a single mark
reg. C.003The score table from the same example, block 2 of the output. Two columns do the work. The score from 0 to 5 says how well the principle is currently executed. The weight says how heavily that principle counts in this context. A zero on a principle weighted low is not a problem, a zero on a principle weighted high is the first line of your priority list. That is why no overall score comes out of it: that would erase the difference between those two zeros.
The theory the skill rests on
This skill leans on one of the best-documented models in social psychology, and the SKILL.md names its sources. That is deliberate: it means you can look them up yourself and decide whether you agree.
The six principles come from Influence, 1984. Robert Cialdini described six principles there that can influence whether people say yes: reciprocity, commitment and consistency, social proof, authority, liking and scarcity. The book is not a collection of sales tricks but a report of field research, partly carried out by apprenticing himself to salespeople, fundraisers and advertisers to see what actually worked in practice.
Unity was added later. In later work, including Pre-Suasion from 2016 and the expanded edition of Influence from 2021, Cialdini added unity as a seventh principle. The difference from liking is subtle but important: liking is about resembling, unity is about belonging together. That is why it appears weighted high in the scan in FIG.01 for cold contact, while it can be left out of the score entirely for a short transactional text.
The moment before the message matters too. Pre-Suasion is about exactly that: what the reader's attention is focused on before your offer arrives colours their judgement of that offer. In practice this means the skill assesses not only whether a principle is in the text, but also where. An evidence block below the button works differently from the same evidence block above it.
The applications come from Yes!, 2008. Cialdini wrote that book together with Steve Martin and Noah Goldstein, with fifty worked applications of the principles in real situations. That is the material the skill draws on when it formulates an alternative itself instead of only naming a problem.
The underlying psychology comes from Kahneman. Thinking, Fast and Slow from 2011 describes the fast judgement systems these principles work on. That also explains why the principles are so easily abused: they act on the fast system, which does not check whether the deadline really existed. That is precisely why the honesty check is a fixed output block and not an optional warning.
Fogg is included for when persuasion is not the problem. The file cites B.J. Fogg and his combination of motivation, ability and prompt as a useful addition when a text does persuade but the action still costs too much effort. Then more social proof helps nobody: the threshold needs to come down instead. Anyone who wants to take that further can turn to the Hook Model Builder skill, and anyone who wants to apply the same thinking to behaviour change inside an organisation can turn to the EAST Framework Behaviour Coach skill.
Even without installing the skill you can improve your own text with these principles: give something before you ask, replace an adjective with a number, and leave out scarcity if it is not real.
What the skill refuses
reg. C.004The SKILL.md contains a list of seven things the skill never does, and for a skill about persuasion that list is the most important part of the file. Cialdini's principles work just as well when you build them on a single lie. In conversation those rules play out like this: each row is a request you might make, with the response the skill gives according to its own instructions.
Installing in Claude Code, Claude.ai or Codex
The zip is 6.4 KB and contains a folder, ai-cialdini-persuasion, 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 any modern AI assistant can read.
- Unzip it into
~/.claude/skills/(or.claude/skills/in your project). - Claude then recognises the skill automatically as soon as you start talking about persuasion, a sales email or a landing page.
- Start Claude Code with claude, then enter
/ai-cialdini-persuasioninside the session.
- 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 repo. - Paste the contents of SKILL.md into it, or put SKILL.md next to it as a separate file and refer to it from
AGENTS.md. - Codex reads that along at every session.
After that, using it is simple: paste your text and name the channel, the target audience and the desired action. Also say what evidence you genuinely have, because that is the material the alternatives are built from. If anything is missing, the skill asks about it once and then carries on. If you get stuck during installation itself, the extended route is in installing Claude skills NL. If you want to learn to set up this kind of work with your team, that is the subject of our AI training.
When you do and do not use it
This analysis is at its strongest on longer texts with a real decision behind them: a landing page, a quote, a sales letter, a pitch deck. There all seven principles come into their own and the weighted scoring has something to weigh. On short transactional texts where group identity plays no role, such as a confirmation email with an upsell in it, it switches back to the classic six without unity.
The instruction also states where the emphasis should sit in each situation. Heavy on reciprocity and unity in cold contact, with social proof as evidence rather than an opener. Heavy on commitment and consistency for warm leads and multi-step journeys, since there the reader has already taken a small step to build on. Heavy on authority and social proof for high amounts, long contracts and risk-averse buyers. And it leaves out scarcity entirely if there is no real constraint, because an empty score is better, according to the file, than an invented deadline.
There are also situations where you are better off leaving it alone. Texts where persuasion is inappropriate are one of them: a medical package leaflet and a legal notice are explicitly excluded in the file. Those should contain information, not influence, and a leaflet that persuades instead of informs is a fault, not an improvement. For vulnerable audiences and for topics with health or financial consequences it does work, but then the honesty check moves upward, so you read what you may not claim before you read how to say it more persuasively.
The most important limit is a different one, and it is not technical. This skill makes a good offer more visible. It does not make a bad offer good. If your offer does not match what the reader needs, or the price does not match what you deliver, a stronger wording changes nothing about that: you have an offer problem disguised as a text problem. And if you write a text that persuades but the desired action costs too much effort, the problem sits in the threshold, not in the persuasion.
Two practical limits to finish. It only assesses the text you supply yourself, it pulls nothing from your site and measures no conversion. And it predicts no result: no expected response rate comes out of it, because that would be a number it cannot know. What it delivers is a judgement on the text, with a priority list by hypothesised impact to test and the reasoning attached, so that you make the call.
Run it yourself, or have it run for you
reg. C.005This skill is the free do-it-yourself version of work we also deliver as a service. It stays complete and with no catches whatsoever, but be clear about what a skill is: it teaches your AI how to do something, while every new session starts empty. So it is neither the engine nor the memory. You prompt, you supply your evidence and your tone again every time, you check the result. Anyone who 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 Cialdini Persuasion skill yourself in Claude, Codex or Cursor. Costs nothing, works today, and you keep it entirely in your own hands: no trial period, no locked-off parts. The limit is your own time: it only happens when you paste a text and ask for it.
have it prepared for you The AI employee: it is ready without you having to prompt Exactly this work, but as a service: the Sales Assistant prepares prospect research and commercial texts without you having to sit behind Claude for it. Control stays with you, because the output stays a draft until a human gives approval. We deliver this through Mansotti, the company that TheSEO trades under, which alongside the Sales Assistant also builds a Quote Assistant (enquiries and quotes) and a Reporting Assistant (weekly and monthly reports). Read what an AI employee is and does.
everything from one source Jarvis: all your AIs work from the same company knowledge The skill teaches the AI, the brain is where the memory lives. If you want all your AIs to work 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 from zero. Jarvis selects context, delegates work and keeps only what has been approved: client knowledge stays isolated and every step leaves a verifiable trail. This particular skill benefits directly, because you no longer have to supply your real evidence again every time. What that delivers in practice, from the plans to your first week, is set out at Jarvis itself.
What Jarvis delivers in practice
reg. C.006Step 3 deserves more than a paragraph, because this is the difference between a clever chat and a system you can build on. Jarvis is the organisation brain: it remembers what your AIs need to know, divides up the work and keeps track of what happened. For a skill like this it is especially concrete, because the evidence the whole analysis rests on is exactly the kind of knowledge you currently type in again every session: how many clients you serve, which capacity limit is real, what you may and may not claim.
We have been running on this system ourselves for months. Every agent session, every task and every decision gets logged in it and can be read back. So a new session does not start blank: it first retrieves the logged decisions, the running projects and the latest changes, and carries on from where the previous one stopped. So we are not describing a promise but the way of working we ourselves work in every day.
See the four plans at jarvis/pricing 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 bespoke business solutions with you first.
The skills around it
reg. C.007Persuasion is not a stand-alone piece: a conversation comes before it, a document comes out of it and a negotiation follows it. These skills from the same library each cover a different part of that chain.
Before the text
the conversationThe principles work on material. The analysis gets that material onto the table.
SPIN Sales ConversationThe questioning technique that surfaces the cost of the problem before you start talking about the solution.SKILL NLAfter the text
the sales chainThe related skills from the sales cluster, each for a different moment in the deal.
AI Quote WriterTurns the conversation into a proposal, with the same rule: do not invent evidence you do not have.SKILL AI NegotiatorFor the conversation after the quote, with BATNA and ZOPA instead of persuasive force.SKILLAround the message
structure and behaviourCialdini supplies the content per stage. These two determine the order and the threshold.
AI AIDA CopywriterAIDA sets the order of your text, Cialdini fills in what each stage needs to say.SKILL Hook Model BuilderFor when the text does persuade but the action costs too much effort: then the threshold is the problem.SKILL EAST Framework Behaviour CoachThe same psychology, but aimed at behaviour inside an organisation instead of at text.SKILLLooking 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 AI and automationThe service behind it: from stand-alone skills to working automation in your business.SRV What are Claude skillsThe basics: what a SKILL.md is and why a text file steers the behaviour of an AI.DOC NL Knowledge baseArticles on SEO, AI and online visibility, searchable.DOCFrequently asked questions
What does the Cialdini Persuasion skill cost?
Nothing. The skill is free, falls under the MIT licence, and you do not have to create an account or leave an email address. You download a 6.4 KB zip containing a folder and a single file, SKILL.md, 2,541 words, and that is the complete skill. There is no paid version and no sales email that follows.
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 themselves are plain readable text, so any assistant that accepts instruction files can handle it.
Are there six or seven Cialdini principles?
Both, and the skill knows the difference. Influence from 1984 described six principles: reciprocity, commitment and consistency, social proof, authority, liking and scarcity. In later work, including Pre-Suasion from 2016 and the expanded edition of Influence from 2021, unity was added as a seventh. The skill works with all seven by default, but switches back to the classic six for short transactional texts where group identity plays no role.
Does the skill invent scarcity or client numbers if I do not supply them?
No. That is the strictest rule in the file, and there is a separate output block for it: the honesty check. If you invent a deadline that does not exist, the skill treats that as deception, not persuasion. If the evidence is missing, the principle is not applied but placed on the list of what you still need to gather before you may use it. An empty score is better, according to the file, than an invented deadline.
Can the skill assess an existing text instead of rewriting it?
Yes, and that is actually the default mode. With an assessment you get two extra parts. First a marked-up version of your own text, in which the principle each sentence serves is noted after it, and nothing is noted after sentences that do nothing: those are your candidates for cutting. Then an excess check, which points out where the text overdoes it, for example with more than one scarcity element or with social proof in four sentences in a row.
Why do I not get an overall score from 0 to 100?
Because the principles do not carry equal weight, and that differs by text. The skill gives each principle a score from 0 to 5 plus a weight of low, medium or high for your context, and leaves principles that do not belong in this text outside the score instead of giving them a zero. In cold contact, reciprocity and unity weigh heavily, with high amounts and risk-averse buyers it is authority and social proof instead. A single overall mark would erase that difference.
For which texts is it better not to use it?
For texts where persuasion is misplaced. The file explicitly names a medical package leaflet and a legal notice: those should contain information, not influence. For vulnerable audiences and for topics with health or financial consequences the skill does use it, but it moves the honesty check to the top instead of the bottom, so you read first what you may not claim.
Persuasion starts with attention
Applying seven principles to your text can substantially raise the odds of a yes, but it counts on a reader who is already there. If your traffic does not change, you are raising a percentage of a small number. Want to know how big that number is right now? The free SEO scan answers in a few seconds. In the guide writing models compared you see how this model relates to the others. And if you want to talk through what else AI can do for your business, from stand-alone skills to work that gets prepared every day, we simply do that in a conversation.