The SCQA Communication Coach skill for Claude
You paste a message into Claude that needs to land with a reader who has little time or plenty of resistance, and you get the text back structured with Barbara Minto's SCQA method: situation, complication, question, answer. Not as advice to try it yourself, but as a fully written piece, with the four parts listed separately first so you can see whether your message is actually finished. Because that is the core of this skill: SCQA is not a template you lay over a text, it is a test. If you cannot fill in the four parts, writing will not help.
the lines above come from the zip on this page · SKILL.md is 14,920 bytes
Message in, SCQA out
reg. S.001This is the worked example from the SKILL.md itself, shown here in a shortened form: a team leader has to tell fourteen people that there will be two fixed office days. Notice what the skill does before a single sentence of running text appears: first the reader, then the four parts separately, then the test. Only once the structure is in place does the writing start.
What the SCQA Communication Coach is
The SCQA Communication Coach is a free skill from the library of 100 skills we make available from TheSEO. A skill is an instruction file, SKILL.md, that gives an AI assistant a fixed way of working for one task. No software, no subscription, no integration: a single text file of 2,489 words that tells Claude how to structure a message using the SCQA method, which tests apply to each part, and what it must never make up on its own. What a skill actually is and how that file format works is explained in full at what are Claude skills NL.
The problem this skill solves is spelled out in its own activation rules. It kicks in for requests like structure my message and build a pitch, but also for frustrations: I get straight to the point and nobody understands why, my email never gets a reply, my presentation starts too slowly, they don't get the problem, I can't get sign-off on my proposal. Say something like that to Claude while the skill is loaded and it activates automatically. Those aren't made-up complaints, they're the moments where a message without structure falls apart.
It's written for anyone who has to convey something that a decision or a change in behaviour needs to follow: an email with bad news, a briefing note for management, an investor pitch, a policy document, the announcement of a change. It always delivers the written-out text rather than advice to try it yourself, and it never invents a reason, a figure or an event to make the complication more dramatic. It belongs to the AI and automation service and, like the rest of the skill library, can be downloaded without an account and without a sales email.
There's one thing you should know beforehand, and the file states this principle clearly: SCQA is not a template to lay over a text, it's a test. If you can't fill in the four parts, the message itself isn't finished yet, and writing won't help. And it will simply tell you that.
Why most messages fall flat
Anyone who gets no reply to their email usually looks for the cause in the wording. Almost always it's in the structure, and the four parts of SCQA read like a diagnosis of what's going wrong.
The opening is about the sender. According to the file, the situation is a factual description of how things stand now, one the reader agrees with immediately. No introduction about yourself, no list of context: the shared starting point. If the reader thinks that's not right at the very first sentence, you've lost them before you've begun. That's why the skill tests every situation for agreement before it goes any further.
There's no complication. The complication is what changes, clashes or goes wrong, and the file calls it the engine of the whole piece. Without a complication there's no reason to keep reading, because then nothing is actually going on. Many texts that don't land have this flaw: they repeat the situation in other words and call that urgency.
The question never gets formulated. The question is what the complication logically raises in the reader's mind. It usually doesn't appear literally in the text, but it does steer everything else: any paragraph that doesn't serve the answer to that question can go. That's why the skill always writes the question out in full, even if it doesn't make it into the final text, and uses it as a filter.
The answer arrives too late or stays vague. The answer is your conclusion or recommendation in one sentence, and immediately the top of your pyramid: everything after that is supporting evidence. An answer without a verb and without a date isn't an answer, it's a direction, and nobody can say yes to that.
The proportions are off. One writing rule from the file that pricks straight through a lot of texts: the situation is never longer than the complication. If you need three paragraphs of context, you've picked the wrong situation.
In diff form, with the plus lines taken literally from the example in the skill: what comes out and what replaces it.
Four letters, each with a test
reg. S.002The four parts as the file defines them, with the test the skill runs on each one before it's allowed to move on. Below that, the pyramid that comes after the answer: because SCQA brings the reader to your conclusion, and the pyramid carries it from there.
What's actually in the SKILL.md
A skill is only as good as its instructions, so we simply describe them here. That file opens with a frontmatter that determines when Claude picks up the skill: for theory questions like SCQA and Minto, for practical questions like delivering bad news, building support, a proposal to management and getting urgency across, and for the frustrations from DOC.01. It also states explicitly what it's not for: SEO blog articles built on search intent, ad copy where the hook matters more than the lead-in, and narrative texts where the tension needs to build instead.
Then comes the theory: the four parts with their definitions, the link to the Pyramid Principle with the MECE rule, the four order variants that Minto herself describes, and the shortened SCR form for short messages.
Then the method: seven steps the skill always takes. It first establishes who the reader is, what they already know and what they need to do after reading. It fills in the four parts separately and shows them on their own, before any running text appears. It tests the situation for agreement and the complication for authenticity. It spells out the question literally and uses it as a filter for everything that follows. It builds two to four arguments under the answer following the pyramid and tests them for MECE. And it writes the whole thing out in the requested format, with an alternative order included if the situation calls for it.
Before anything is written, the skill runs through a mandatory seven-point checklist: your message or raw notes, the reader and what they already know, what you want from the reader, what has changed or gone wrong, the format and the length, the relationship between you and the reader, and what argues against your proposal. It only asks about what's missing, in a single round, and then continues with a marked assumption. So you don't get a form, at most a few targeted questions.
The output always has the same seven blocks, in the same order: reader and goal, SCQA at a glance, the test on the four parts, the pyramid under the answer, the written-out piece, an alternative order, and a closing block with what isn't backed up and which objection is still open. That last block is typical of the file: the skill names the weak spots in its own piece before your reader does. In the example from FIG.01, that's the missing argument for two days instead of one, and the unanswered objection that pitches have also been won online.
A striking number of rules are about language: clear, direct British English, no dashes in running text, short sentences alternated with long ones, concrete over abstract, figures over adjectives, and a ban list of hollow phrasing. There is also a separate six-step review mode for existing work, more on that in the FAQ. At the bottom are three source references, all traceable to Barbara Minto and the consulting practice at McKinsey. If you want to learn to write an instruction file like this yourself: the structure is exactly what we explain in writing SKILL.md files NL.
Same letters, different reader
reg. S.003SCQA isn't a fixed sequence, more a set of parts, and the file describes four variants from Minto herself plus the shortened SCR form. It picks one based on your reader, explains why in the closing block, and by default also delivers a second opening in a different order so you can choose the tone. The highlighted block is the part that comes first in that variant.
The theory the skill rests on
SCQA is the introduction structure from the work of Barbara Minto, developed during her time at McKinsey and described in The Minto Pyramid Principle. All three sources are named: the book itself, the SCQA structure with its order variants that are generally attributed to Minto, and the MECE rule from the same consulting practice. That's deliberate: so you can look it up yourself and decide whether you agree with it.
The introduction and the pyramid belong together. SCQA takes the reader from a shared starting point to your conclusion, and that conclusion is immediately the top of the pyramid: below it hang two to four arguments of the same kind, and below each argument the facts. The arguments have to be MECE: they don't overlap and together they cover the question. This skill builds both, but if you mainly want to train the supporting-evidence side, there's the separate Pyramid Principle Writer skill.
The structure is a test, not a trick. That's the most practical lesson from the file. If you can't formulate the situation as something the reader says yes to, you don't know your reader well enough. If you can't point to a complication, you have no message. If you can't get the answer into one sentence, you haven't made a decision yet. The structure exposes that before you start writing, and that saves you exactly the hours you'd otherwise lose shuffling paragraphs around.
Where SCQA stops, other structures begin. The file is open about this: SCQA is far from a fit everywhere. For ad copy where the hook matters more than the lead-in there's the AIDA Copywriter skill, for a brand story where the customer plays the lead role the StoryBrand Writer skill, and if you want a message to stick rather than just be understood, look at the Made to Stick skill. Each of those structures solves a different problem; SCQA is the structure for the message that a decision has to follow.
Even without installing the skill, you can use these principles to improve your next email: start with a sentence your reader says yes to, name what's changing, and put your answer in one sentence with a verb and a date.
What the skill refuses
reg. S.004The SKILL.md contains a list of seven things the skill never does, and that list matters at least as much as what it does do. A message with an inflated complication wins the first paragraph and then loses the reader for good. Each line 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 contains one folder 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're not downloading a Claude file but a working instruction that 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 a message, email or pitch.
- Start Claude Code with claude, then enter
/ai-scqa-communication-coachin that 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.
- Unzip it into
.agents/skills/in your project, or into~/.agents/skills/for all your projects. - Codex has read SKILL.md there directly since the open standard of December 2025.
- The old route still works too: paste the contents into
AGENTS.mdor refer to it from that file. That's no longer necessary though.
After that, using it is simple: paste your message or your raw notes and say what it needs to become. In a single round it asks what's still missing, and then it gets to work. If you get stuck anywhere, the full explanation per environment, including screenshots and common mistakes, is in installing Claude skills NL. And if you'd rather read the wider story about working with AI first, start in the knowledge base.
When to use it, and when not to
It's at its strongest for messages that need a decision or a change in behaviour to follow: the briefing note, the policy document, the investor pitch, the announcement of a change, the email you've been putting off for three days. There are also application rules per situation. For bad news, you keep the standard order, but with a short situation and complication: delaying feels like avoidance, and that costs more trust than the message itself. For a presentation, you put SCQA on the first two slides and the arguments from the pyramid become the headings of the following slides. And for a chat message or short update, SCR is enough, without an explicit question.
There are also texts you're better off leaving it for, and the file names them itself. SEO blog articles are built on search intent and follow the searcher's question, not the logic of an argument; how that does work you can read at improving your SEO. Ad copy lives on the hook in the first second, and SCQA's lead-in is too patient for that. And narrative texts want to build tension rather than lay it on the table straight away. For those cases other structures exist, and some of them are available as a separate skill in the library.
The most honest limit is already in this page's hero, but it deserves repeating: the skill makes your message understandable, not automatically welcome. A reorganisation doesn't get more fun from a good structure, and a weak proposal doesn't get strong from a tight pyramid. What the structure does do: make sure the reader understands exactly what you're saying and what you're asking, so the conversation afterwards is about the content and not the confusion. If you're not sure beforehand whether your proposal survives the test itself, run the Pre-Mortem Analyst skill over it first: it looks for the ways your plan could fail before you announce it.
Run it yourself or have it run for you
reg. S.005This skill is the free do-it-yourself version of work we also deliver as a service. The skill stays complete and with no catches, but realise what a skill is: it teaches your AI how to do something, while every new session starts empty. The skill is not the engine and not the memory. You prompt, you supply the context again every time, you check the result. If you want it differently, there are two follow-on steps: hand over the engine, or sort out the memory.
where you are now The skill: you are the engine You run the SCQA Communication Coach 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 prompt.
have it prepared for you The Quote employee: the draft answers are already there The sharpest SCQA is the one from a person who really understands the complication, so the thinking stays yours. What can be a service is the pile around it: every incoming enquiry sorted, with a draft answer that already names that client's situation and complication instead of opening with a standard line. That's the Quote employee from Mansotti, the company behind the TheSEO trading name, which also builds the other two roles and sets up the surrounding work to fit. You stay in control, because output stays a draft until a person approves it. 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. Want all your AIs working from the same company knowledge? That's Jarvis, the organisation's brain. It connects ChatGPT, Claude, Codex and your people to the same projects, core knowledge and decisions, so your next AI session doesn't start from scratch. This skill benefits too: who your readers are, what tone your organisation uses and which decisions are already in place no longer need to be supplied per conversation. What that delivers in practice, from the plans to your first week, you can read at Jarvis itself.
What Jarvis delivers in practice
reg. S.006Step 3 deserves more than a paragraph, because this is the difference between a smart chat and a system you can build on. Jarvis is the organisation's brain: it remembers what your AIs need to know, divides up the work and keeps track of what happened. For a communication skill that's not a detail: the skill's first step is working out who your reader is, every single time, and that's exactly what a brain already knows.
We've been running on this system ourselves for months. Every agent session, every task and every decision is logged in it and can be read back. A new session therefore doesn't start blank: it first retrieves the recorded decisions, the projects under way and the latest changes, and carries on where the previous one stopped. So you don't have to type in who your reader is and what they already know every single time. We're not describing a promise here but the way we work ourselves, every day.
See all four plans at jarvis/pricing NL. Through the waiting list NL you simply let us know your preferred plan, with no obligation. That doesn't create an account, an order or a payment obligation. We discuss bespoke business set-ups first.
The skills around it
reg. S.007A message that calls for a decision has SCQA as its structure, but not every text calls for a decision. These skills from the same library of 100 each tackle a different piece of the writing work.
The same school of writing
the structureMinto and the structures aimed at the same problem: a message that's understood straight away.
Pyramid Principle WriterThe structure beneath your answer: conclusion at the top, arguments below it, facts at the bottom.SKILL Made to StickFor when understanding isn't enough and the message also needs to stick.SKILLFor attention
the hookExactly the territory SCQA's own file says it's not suited to.
AIDA CopywriterFor ad copy where the hook matters more than the lead-in.SKILL StoryBrand WriterFor the brand story where the customer plays the lead role instead of your conclusion.SKILLFor tension and testing
the pushbackFinding the complication and having the argument reviewed before your reader does.
Pre-Mortem AnalystLooks for how your plan fails before you announce it: the most honest source of a real complication.SKILL Persuasiveness AnalystReviews the structure of an existing argument, the same lens as the review mode here.SKILLLooking further
the contextWhere this skill comes from and what else is out there.
The whole skill libraryAll 100 free skills in one place, sorted by topic.HUB AI and automationThe service behind it: from individual skills to working automation in your business.SRV AI trainingIf your team wants to learn to set this kind of work up themselves.SRV Knowledge baseArticles on SEO, AI and online visibility, searchable.DOCFrequently asked questions
What does the SCQA Communication Coach skill cost?
Nothing. The skill is free, falls under the MIT licence, and you don't need to create an account or leave an email address. You download a 5.9 KB zip containing a folder and a single file, SKILL.md, and that's the complete skill. There's 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. You can still put the contents of SKILL.md into your AGENTS.md too. The instructions are plain readable text, so any AI assistant that accepts instruction files can work with it.
What's the difference between SCQA and the Pyramid Principle?
SCQA is the introduction, the pyramid is the supporting evidence. With situation, complication and question you bring the reader to your answer, and that answer is immediately the top of the pyramid: below it hang two to four arguments and below each argument the facts. This skill does both, because after the SCQA rules it also builds the pyramid under the answer and tests the arguments for MECE. If you only want to train the pyramid side, there's a separate Pyramid Principle Writer skill.
Does the skill invent a complication if nothing is actually going on?
No. The file is explicit about this: if nothing has changed, there is no message, and the skill will say so. It also never makes up figures, client names, events or research results to make the complication more dramatic. The engine of your piece has to come from your own situation, otherwise writing isn't the problem.
Can the skill review an existing email or presentation?
Yes, the file has a separate review mode for that, with six fixed steps. Every paragraph gets a label S, C, Q or A, and paragraphs that are none of the four get the label REMOVE. Then comes a diagnosis per part, an agreement test on your opening sentence, a question filter that flags every passage that doesn't serve the core question, a heading check for longer pieces, and a rewritten version in the same length or shorter.
What information does the skill need from me?
The file contains a mandatory seven-point checklist: your message or raw notes, who the reader is and what they already know, what you want from the reader, what has changed or gone wrong, the format and the length, the relationship between you and the reader, and what argues against your proposal. If something is missing, the skill asks about it in a single round and then continues with a marked assumption.
For which texts is SCQA not suitable?
The file names three limits: SEO blog articles built on search intent, ad copy where the hook matters more than the lead-in, and narrative texts where the tension needs to build. For the first two cases, a structure like AIDA fits better, and there's a dedicated skill for that. SCQA is made for business messages where the reader has to make a decision or understand something.
The right structure for the right audience
A good structure only helps if your message reaches the right people. For an email or a briefing note, you choose those people yourself, and then the skill is enough. For a page on your site, the search engine has a say too, and then what counts first is whether you show up at all. The free SEO scan shows where you stand in a few seconds, and the SEO improvement service takes it from there if there's more to do than you want to handle yourself. In the guide writing models compared you can see how this model relates to the others.