1---2name: ad-themes3description: >-4 Turns a B2B SaaS company's messaging house and buying moments into ad themes and angles for each active channel,5 each tied to one pillar, one buying moment, one role and the proof that backs it, with the offer that fits the6 buyer's stage. Optionally reads competitor ads to mark themes crowded, contested or open. Checks every line with7 voice-check and claim-check and returns READY, READY WITH GAPS or BLOCKED. Use it before writing ads for a launch,8 a new channel or a quarter. Not for writing the ad copy inside platform limits (use ad-variants) or for building9 the messaging house itself (use messaging-house).10license: MIT11compatibility: >-12 Works in Claude, ChatGPT, Codex, Cursor and any agent that reads SKILL.md. Reads public ad libraries if the agent13 can browse; otherwise works from ads the reader pastes. No scripts.14metadata:15 author: SHAKEUP16 version: "1.0.0"17 stage: make18 plugin: paid-media19 homepage: https://www.shakeuphq.com/skills/ad-themes20---21 22# Ad themes23 24Decides what every ad says before anyone writes one, so each channel carries the same pillars with proof.25 26## Purpose27 28- One job: produce the theme grid for the company's active channels: theme, pillar, moment, role, angle, proof, offer and a first line.29- Stage: make. It ends with its own check, at most 2 fix rounds.30- It never invents a pillar, a proof, a customer or a competitor ad. A theme without proof is marked `needs proof` and never stated as a claim.31- It writes first lines to brief from, not finished ads. `ad-variants` writes the ads.32 33## Use when / not34 35| Situation | Use |36| --- | --- |37| Planning ads for a launch, a quarter or a new channel | this skill |38| Checking whether your ads all say the same thing as competitors | this skill, with competitor ads |39| Writing ads inside each platform's character limits | `ad-variants`, after this skill |40| No pillars or proof yet | `messaging-house` first |41| No buying moments yet | `buying-moments` first |42| Testing whether buyers understand a message | `message-test` |43 44## Inputs45 46| Input | Required | Ways to provide, in order | If missing |47| --- | --- | --- | --- |48| Messaging house: core message, pillars, proof per pillar | yes | `## Messaging house`; the reader's pillars | ask once for 3 pillars with proof; then `BLOCKED` with `messaging-house` as next |49| Buying moments with priority | yes | `## Buying moments`; the reader | ask once for 3 moments; then `BLOCKED` with `buying-moments` as next |50| Buying group roles and objections | no | `### Buying group` | themes aren't split by role; coverage `partial` |51| Approved claims | no | `## Claims and proof` | every proof is `unsourced` until the reader gives a source |52| Active channels | no | `## Channels`; `linkedin-plan` or `reddit-plan` handoffs; the reader | plan for search and LinkedIn and say so |53| Competitor ads | no | public ad libraries if the agent can browse; ads the reader pastes | crowding marked `not checked` |54| Landing pages per theme | no | the reader | the offer column names the page needed; open item |55 56## Profile read57 58From `company-profile.md`: `## Positioning` (alternatives, unique attributes, best-fit customers), `## Messaging house`, `## Buying moments`, `## Buyers` and `### Buying group`, `## Voice`, `## Claims and proof` and `### Never say`, `## Competitors` (mention policy), `## Channels`, and every `## Learnings` entry for `ad-themes`, `voice-check` and `claim-check` with status `noted`, `fact` or `accepted`.59 60No profile: ask in one message for the pillars with their proof, the 3 situations that make a buyer start looking, and the channels in use. Say that `company-profile` saves this next time.61 62## Steps63 641. **Apply learnings.** A theme that drove opportunities, or one that drew clicks and no pipeline, changes the scores in step 5. Name each one that fires.65 662. **List the parts.** Pillars (with each proof and its status from `## Claims and proof`: verified and in date, expired, or unsourced), moments (with priority), roles (with what each cares about and the objection), alternatives from `## Positioning`, and the never-say list.67 683. **Read competitor ads (optional).** Follow "Crowded and open themes" in `references/angles-and-channels.md`: quote each ad's main promise, group into themes, count advertisers, mark crowded (half or more of the advertisers read), contested (at least 1, under half) or open (none). Quote; never paraphrase into a line that didn't run.69 704. **Build the grid.** One candidate theme per pillar x moment pair. For each, name the role who owns that moment and pick the angle from the angle table in the reference whose "needs" the inputs meet. A pair with no role who cares, or no angle whose needs are met, is dropped with the reason.71 725. **Score each theme.**73 74 | Factor | Points | Why |75 | --- | --- | --- |76 | Moment priority | high 3, medium 2, low 1 | Ads should meet the moments that start most searches |77 | Proof | verified and in date 2, product fact without a figure 1, none 0 | A theme that can't be proved can't be said |78 | Crowding | open 2, contested 1, not checked 1, crowded 0 | An open theme is the one only you are saying |79 | Role fit | the pillar answers the role's care or objection 1, else 0 | A theme nobody in the buying group owns gets no reply |80 81 A theme with proof 0 is marked `needs proof`: it may run only on a how-it-works or moment angle with no claim, or wait for a source.82 836. **Fit themes to channels.** For each active channel, take the top themes by score, 3 to 5 per channel, using the channel table in the reference to set the stage, the offer and the angle that fits there. Each channel's set covers at least 2 pillars (one pillar repeated is one message, not a set) and keeps at least 1 open theme where one exists. Contrast angles only where the mention policy allows.84 857. **Write each theme.** Plain theme name; pillar; moment; role; angle; the first line (one sentence a writer could brief from, in the profile's voice); the proof with its source; the offer and the page it needs; what not to say (never-say items and claims that failed).86 878. **Check** with `voice-check` then `claim-check` on every first line and proof (see Check and verdict).88 89## Check and verdict90 91| Check | Fails when |92| --- | --- |93| Every theme has a pillar, a moment, a role, an angle and an offer | any is missing |94| Proof | a first line states a number or result not in `## Claims and proof`, expired, or on the never-say list (`claim-check`) |95| Voice | a first line fails `voice-check` (inline without the skill: no em or en dashes, no words from "Words to avoid", sentences under 30 words, the profile's point of view) |96| Spread | a channel's set covers only 1 pillar |97| Stage | the offer doesn't fit the stage the channel meets (a demo offer on a problem-aware placement) |98| Competitors | a contrast angle names a competitor the mention policy forbids |99| Quotes | a competitor line is paraphrased or unseen |100 101| Verdict | Condition (first match wins) |102| --- | --- |103| `BLOCKED` | No pillars with proof and no buying moments after one question |104| `READY WITH GAPS` | Themes are written but checks are still open after 2 rounds, or themes are marked `needs proof`, or crowding wasn't checked (each named) |105| `READY` | Every check passes |106 107Named stop: `BLOCKED` names the skill that fills the gap (`messaging-house`, `buying-moments`). No other stops.108 109## Loop110 1111. Run the checks.1122. Fix: rewrite the first line, swap the angle for one whose proof exists, move a theme to a channel whose stage fits, drop a contrast angle the policy forbids.1133. Check again. At most 2 rounds, then hand over with what is still open, labelled `open`.114 115## Learn116 117Append to `## Learnings` when:118 119- a theme's ads report pipeline after the judgment window (cost per opportunity by theme): a `fact`;120- a theme draws clicks and no qualified leads for a full cycle: a `fact`, and a `proposal` to lower its score;121- the reader rejects a theme as off-brand or off-strategy: a `proposal` with their reason;122- the reader supplies a source for a `needs proof` theme: route it to `claim-check`, which records it in `## Claims and proof`.123 124Example: `- 2026-10-24 | ad-themes | fact | "Board asks for pipeline by channel" ads produced 4 opportunities at $1,200 each on LinkedIn | Why: HubSpot campaign report, Q3 2026 | Status: noted`125 126## Output127 128```129Verdict: <READY | READY WITH GAPS | BLOCKED> · Coverage: <complete | partial (what's missing)> · Competitor ads: <n advertisers read | not checked>130 131Competitor themes (if read)132| Theme | Advertisers | Quoted line | Mark |133 134Theme grid135| Theme | Pillar | Moment | Role | Angle | Score | First line | Proof (source) | Offer and page |136 137By channel138<Channel>: <themes, stage, offer>139 140Needs proof: <themes and the source each needs>141Check: <each check, pass or fail> · Rounds: <n>142Open: <labelled items>143Learnings applied: <list, or none>144```145 146Then the handoff block.147 148## Hand off149 150```handoff151skill: ad-themes152version: 1.0.0153verdict: READY154coverage: partial (competitor ads not checked)155for: <company> Q4 themes156outputs:157 themes:158 - name: board asks for pipeline by channel159 pillar: trusted numbers160 channels: [google-ads, linkedin-ads]161 proof: lifecycle stages are read, never rewritten (product)162 open_themes: [board asks for pipeline by channel]163 needs_proof: []164next: [ad-variants]165open: []166```167 168`ad-variants` reads `themes` (name, pillar, channels, proof) and writes the ads.169 170## Failure modes171 172| Problem | Do this |173| --- | --- |174| Every pillar sits in a crowded theme | Lead each with its proof, not its promise; say that positioning may need `positioning` |175| The proof is a customer quote not cleared for ads | Mark `needs proof`; ask for clearance through `claim-check` |176| The reader wants one theme on every channel | Allowed for a launch; still adapt the angle and offer to each channel's stage |177| Competitor ads can't be read (blocked library, login) | Mark crowding `not checked`; list what was tried |178| Buying moments exist but have no priority | Ask once; otherwise score them all medium and say so |179 180## Influenced by181 182- SHAKEUP's messaging house: one core message, pillars that each carry a claim, and proof under every claim, so every channel says the same thing.183- SHAKEUP's B2B Google Ads playbook, for matching the offer to the buyer's awareness stage and reading an ad as the next sentence after the query.184- SHAKEUP's earlier ad themes agent, which read competitor ads, counted advertisers rather than ads and marked themes crowded, contested or open.