1---2name: messaging-house3description: >-4 Builds a B2B SaaS company's messaging house: one core message, 3 or 4 pillars that each answer a different buyer5 doubt, and the proof under each, worded from phrases mined line by line from interviews, calls and reviews, so6 every page, ad and email says the same thing. Stands on the profile's positioning and buying moments, checks7 itself with voice-check and claim-check, and writes the profile's Messaging house section. Returns READY, DRAFT8 or BLOCKED. Use it after positioning, before a homepage, landing page or ad themes. Not for deciding positioning9 (use positioning), for testing copy on buyers (use message-test) or for writing the page itself.10license: MIT11compatibility: >-12 Works in Claude, ChatGPT, Codex, Cursor and any agent that reads SKILL.md. Uses a connected call recorder, CRM13 notes or review exports if the agent has them, otherwise pasted text. Python 3 is optional, for mining phrases14 and checking the house.15metadata:16 author: SHAKEUP17 version: "1.0.0"18 stage: make19 plugin: strategy-messaging20 homepage: https://www.shakeuphq.com/skills/messaging-house21---22 23# Messaging house24 25Puts one core message on top, the pillars that hold it up and the proof under each, in the words buyers already use.26 27## Purpose28 29- One job: build the messaging house for one company and write it to `## Messaging house` in `company-profile.md`.30- Stage: make. It ends with its own check (this skill's house checks, then `voice-check` and `claim-check`), at most 2 rounds.31- The house is a source for copy, not copy. It holds the claims every channel draws from; headlines and ads are written later from it.32- It never invents proof, a quote or a customer. A pillar with nothing under it is marked `proof needed` and stays visible.33 34## Use when / not35 36| Situation | Use |37| --- | --- |38| Positioning is set and no messaging house exists | this skill |39| Pages and ads say different things about the company | this skill, then rewrite from the house |40| Positioning changed (a `positioning` run returned `REVISE`) | this skill, to rebuild |41| No positioning yet | `positioning` first |42| A page or ad exists and you want to know if buyers get it | `message-test` |43| Turning the house into ad angles per channel | `ad-themes`, after this skill |44 45## Inputs46 47| Input | Required | Ways to provide, in order | If missing |48| --- | --- | --- | --- |49| Positioning: alternatives, unique attributes, value, best fit, category | yes | `## Positioning` in the profile; the `positioning` handoff; the reader gives the 5 fields now | `BLOCKED`, routed to `positioning` |50| Buyer words: interview and call transcripts, reviews (own and competitors'), sales emails from buyers, survey free text | no, but the house is weaker without it | a connected call recorder or CRM notes; review exports; uploaded files; pasted text | the house is in our words only: `DRAFT`, and `message-test` before use |51| Buying group and moments | no | `## Buyers` and `## Buying moments` in the profile | pillar order by role is skipped; coverage `partial` |52| Approved claims | no | `## Claims and proof` in the profile | pillars can rest only on product facts the positioning names; every other pillar is `proof needed` until the reader gives a source |53 54## Profile read55 56From `company-profile.md`: `## Company` (name, category), `## Product`, `## Buyers` (with `### Buying group`), `## Buying moments`, `## Positioning`, `## Messaging house` (the current one, if any), `## Voice`, `## Claims and proof` (with `### Never say`), `## Competitors` (mention policy), and every `## Learnings` entry for `messaging-house` with status `noted`, `fact` or `accepted`.57 58No profile: ask in one message for the 5 positioning fields, the claims the company can prove with their sources, and any interview or review text. Say that `company-profile` and `positioning` save this next time.59 60## Steps61 621. **Apply learnings.** Accepted learnings for this skill override the defaults. Name each one that fires.63 642. **Check the foundation.** Read `## Positioning`. All 5 fields must be filled. If any is missing or `not available`, stop at `BLOCKED` and route to `positioning`, unless the reader gives the missing fields now (then mark coverage `partial: positioning from the reader, not from evidence`). A homepage alone is not positioning: it is the copy the house is meant to fix.65 663. **Mine the buyer's words.** Read every source line by line. Copy phrases verbatim, 2 to 12 words; never summarise. Tag each phrase:67 68 | Tag | Means | Made-up example |69 | --- | --- | --- |70 | `before` | The situation or pain before buying | "every contract waits a week for a lawyer" |71 | `after` | The outcome they wanted or got | "first draft back the same day" |72 | `worry` | An objection, risk or fear about switching | "lawyers won't change how they redline" |73 | `trigger` | What made them start looking | "the deal desk doubled its volume" |74 | `alternative` | What they used or compared | "the review portal nobody opens" |75 | `value words` | How they describe the benefit | "redline in Word" |76 77 Record the source id and the role where known. Source order, best first, and what to take from each: `references/mining-guide.md`. Then count which phrases repeat across sources:78 79 ```80 python3 scripts/phrase_bank.py --sources i1.txt i2.txt r1.txt r2.txt --min-sources 2 > bank.json81 ```82 83 Without Python, list each phrase with the ids of the sources it appears in and keep the ones in 2 or more. Say which way you ran it. A phrase is buyer language when 2 or more distinct sources use it: 1 source is one person's style.84 854. **Lay the foundation.** Write the positioning statement from the profile fields: "For <best fit> who <problem>, <company> is the <category> that <value>. Unlike <main alternative>, it <lead attribute>." Use the `positioning` handoff's `statement` if it exists. The statement is the test every line above it must pass; it is not copy.86 875. **Write the core message.** Write 3 candidates, then score each on 5 rules:88 89 | Rule | Passes when | Why |90 | --- | --- | --- |91 | Short | 15 words or fewer | It has to fit in one breath and in a headline slot |92 | Result and who | It names the result and who gets it | Buyers buy the result, not the mechanism |93 | Buyer words | The result is said with a mined phrase (or its exact key terms) | Buyers recognise their own words faster than ours |94 | Only us | It rests on the lead attribute or the value theme, so the main alternative couldn't say it | A line any competitor could use does no work |95 | Clean | No empty word and no claim missing from `## Claims and proof` | It must survive both checks unchanged |96 97 Pick the candidate that passes the most rules; on a tie, the shorter one. If a candidate needs a comma and a second idea, the second idea is a pillar.98 996. **Raise the pillars (3 or 4).** Start from the doubts buyers raise: the `worry` phrases and the buying group's objections. Most B2B houses answer these:100 101 | Doubt | Pillar answers |102 | --- | --- |103 | Will it work? | The outcome, with a measured result |104 | Will it fit how we work? | Effort, risk, the stack, the team's habits |105 | Is it worth it? | Cost against the return or the cost of staying put |106 | Why this, over what we use now? | The lead attribute against the main alternative |107 108 Rules:109 - Each pillar answers one doubt; no 2 pillars answer the same one.110 - Use a 4th pillar only when a 4th doubt shows up in 2 or more sources. 3 is the default: every pillar needs its own proof, and each extra one splits a page's or an ad's space further.111 - Each pillar traces to a positioning field (a unique attribute or a value theme). A pillar that traces to nothing is a feature list in disguise: cut it.112 - Each pillar has a name (2 to 4 words), a claim (1 sentence, 20 words or fewer), proof from `## Claims and proof` or a product fact with its source, the doubt it answers, the role it matters most to, and the mined phrases it uses.113 - No proof: write `proof needed`, with the kind of proof that would fill it. Never fill it with an adjective.114 - Never use a table-stakes attribute as a pillar. `positioning` lists them.115 1167. **Map roles and moments.** For each buying group role, the pillar to lead with and why (from their objection). For each high-priority buying moment, the pillar to open with and the phrase to open on. Skip with `not available` when the profile lacks the sections.117 1188. **Check.** Run the house checks, then `voice-check` and `claim-check` (see Loop).119 1209. **Write the section.** Replace `## Messaging house` in the template's format:121 122 ```123 Core message: <one sentence>124 125 - Pillar: <name> | <the claim> | Proof: <proof, with source>126 ```127 128 If a house already exists and the reader confirmed it, show old and new side by side first (named stop). If the agent can't edit the profile file, give the section in one code block ready to paste and set `profile_section_written: false (ready to paste)`.129 130## Check and verdict131 132| Verdict | Condition (first match wins) |133| --- | --- |134| `BLOCKED` | No positioning in the profile and the reader can't give the 5 fields; or no product facts |135| `DRAFT` | Any pillar is `proof needed`; or no buyer sources were mined; or a check still fails after 2 rounds |136| `READY` | Every house check passes, `voice-check` has no critical finding and `claim-check` has no critical finding |137 138Named stops:139 140- `BLOCKED`: stop and route to `positioning`, or ask for the 5 fields in one message.141- Replacing a messaging house the reader confirmed: show old and new with what changed and why; write after the reader says yes.142 143`DRAFT` writes the section with `proof needed` visible on each pillar that lacks proof. `READY` writes without a stop.144 145## Loop146 1471. **House checks**, with `python3 scripts/phrase_bank.py --house house.md --bank bank.json`, or by hand:148 149 | Check | Fails when |150 | --- | --- |151 | Core length | Over 15 words |152 | Pillar count | Fewer than 3 or more than 4 |153 | Proof | A pillar's proof is empty, `not available` or `proof needed` |154 | Empty words | Any word from the list in `references/mining-guide.md` |155 | Buyer words | The core message or a pillar uses no mined phrase (skip when nothing was mined, and say so) |156 | Distinct doubts | 2 pillars answer the same doubt |157 | Traces to positioning | A pillar rests on no unique attribute or value theme |158 | Names the alternative | The statement doesn't name the main alternative and the difference |159 1602. **`voice-check`** on the core message and pillar claims. If it isn't installed, check inline: no dashes, every phrase under the profile's words to avoid, sentences over 30 words, and the 3 copy tests (can I picture it, can it be proved wrong, could no one else say it). Fragments are fine in pillar names.161 1623. **`claim-check`** on every claim and proof. If it isn't installed, check inline: every number and comparison matches a line in `## Claims and proof` (same number, same thing, same period); anything in `### Never say` is cut; a claim with no source is cut or turned into the mechanism ("reads your CRM stages, never rewrites them" instead of "3x faster").163 164Fix what failed and check again. At most 2 rounds. Then hand over with what is still open, labelled.165 166## Learn167 168Append to `## Learnings`:169 170- the reader rewrites the core message or a pillar: a `proposal` with their reason; if the reason is a word the buyers use ("buyers say redline, not review"), also suggest adding it to `### Words to use`;171- results come back for a pillar, such as `message-test` scores, a buyer panel, or ad and page results by pillar from `ad-themes` or `landing-page-critic`: a `fact` with its source;172- a proof is added or expires: a `fact`, and update the pillar.173 174Example: `- 2026-10-24 | messaging-house | fact | The "fit" pillar scored lowest on value in 2 panel tests | Why: buyer panel results, 2026-10 | Status: noted`175 176## Output177 178```179Verdict: <READY | DRAFT | BLOCKED> · Coverage: <complete | partial (what's missing) | blocked> · Mining: <script | by hand | not run: no sources>180Sources mined: <n> (<ids>) · Phrases kept: <n> in 2 or more sources181 182Phrase bank (top 10)183| Phrase | Tag | Sources | Role |184 185Foundation: For <best fit> who <problem>, <company> is the <category> that <value>. Unlike <main alternative>, it <lead attribute>.186 187Core message candidates188| Candidate | Short | Result and who | Buyer words | Only us | Clean | Pick |189 190The house191Core message: <line>192| Pillar | Claim | Proof (source) | Doubt it answers | Positioning field | Role | Buyer phrases |193 194Lead pillar by role: <role: pillar, why>195Opening pillar by moment: <moment: pillar, opening phrase>196 197Checks: house <n>/8 · voice-check <verdict> · claim-check <verdict> · round <1 or 2>198Open: <pillars with proof needed, failed checks>199 200## Messaging house (the section as written, or "not written: <stop>")201Learnings applied: <list, or none>202```203 204Then the handoff block.205 206## Hand off207 208```handoff209skill: messaging-house210version: 1.0.0211verdict: DRAFT212coverage: partial (4 sources mined; no competitor reviews)213for: <company>214outputs:215 core_message: Redline in Word, with your clause library beside you.216 pillars: ["Works inside Word", "Your clauses, every time", "Faster first drafts"]217 proof_needed: ["Faster first drafts"]218 lead_pillar_by_role: {General counsel: Faster first drafts, Contract manager: Works inside Word}219 profile_section_written: true220next: [message-test, ad-themes, landing-page-critic]221open: [review times before and after, from 2 or more customers]222```223 224Made-up values for illustration. `message-test` scores pages and ads against the core message and pillars; `ad-themes` turns each pillar and its proof into angles per channel.225 226## Failure modes227 228| Problem | Do this |229| --- | --- |230| The reader wants a pillar for every feature | A pillar answers a doubt. Group features under the doubt they answer; list the rest as supporting points |231| The best phrase comes from a competitor's review | Use the buyer's words about the problem; never use a competitor's name or product terms |232| Buyers' words are crude or off-voice | Keep the meaning and the key terms; `voice-check` decides the final wording |233| A customer quote is the only proof | Use it only if `## Claims and proof` lists it as cleared, or the reader confirms it |234| The house contradicts `### Never say` | Cut the line; `claim-check` marks it forbidden |235| Every pillar is `proof needed` | The positioning has no proof under it. Verdict `DRAFT`; suggest rerunning `positioning` with deal evidence |236 237## Influenced by238 239- Joanna Wiebe's message mining (Copyhackers): reading reviews, calls and comments line by line, highlighting the phrases buyers repeat, and tagging them before choosing what to say: https://wistia.com/blog/joanna-wiebe-conversion-copywriting240- SHAKEUP's messaging house, the same structure as the free messaging house builder on our site: positioning as the foundation, one core message, pillars with proof.241- What we changed: phrases count as buyer language only when 2 or more sources use them, pillars are chosen by the buyer doubt they answer and must trace to a positioning field, the core message is picked by 5 scored rules, and the house is checked by `voice-check` and `claim-check` before it reaches the profile.