1---2name: ad-variants3description: >-4 Writes ad variants for each theme inside each platform's own text limits (Google and Microsoft responsive search5 ads, LinkedIn, Meta, ChatGPT Ads, Reddit), gives every variant one job and one variable, then checks the set for6 length, message match with the landing page, repeated angles, competitor trademarks and claims without proof.7 Uses voice-check and claim-check as its check and returns READY, READY WITH GAPS, NEEDS PROOF or BLOCKED. Use it8 after ad-themes, or when a new ad group needs ads. Not for choosing what the ads say (use ad-themes) or for judging9 the creative and visuals (use ad-creative-critic).10license: MIT11compatibility: >-12 Works in Claude, ChatGPT, Codex, Cursor and any agent that reads SKILL.md. Reads the landing page if the agent can13 browse; otherwise the reader pastes its headline. Python 3 is optional, for the length and overlap checks.14metadata:15 author: SHAKEUP16 version: "1.0.0"17 stage: make18 plugin: paid-media19 homepage: https://www.shakeuphq.com/skills/ad-variants20---21 22# Ad variants23 24Writes the ads for each theme so they fit the platform, match the page and test one thing at a time.25 26## Purpose27 28- One job: turn themes into ad variants per platform, and check them.29- Stage: make. It ends with its own check, at most 2 fix rounds.30- It never writes a claim that isn't in `## Claims and proof`, never puts a competitor's trademark in ad text, and never uploads or launches an ad.31 32## Use when / not33 34| Situation | Use |35| --- | --- |36| Themes are set and need ads | this skill |37| A new ad group from `search-terms-triage` needs its ads | this skill |38| Refreshing ads rated Low for 30 days | this skill, with the old assets as input |39| Deciding what the ads should say | `ad-themes` first |40| Reviewing images, video or the whole ad creative | `ad-creative-critic` |41| Reviewing the landing page itself | `landing-page-critic` |42 43## Inputs44 45| Input | Required | Ways to provide, in order | If missing |46| --- | --- | --- | --- |47| Themes: name, pillar, proof, offer, channel | yes | `ad-themes` handoff; the reader | ask for one theme's parts (who it's for, the problem, the result, the proof, the call to action); then `BLOCKED` |48| Platforms to write for | yes | the themes' channels; `## Channels`; the reader | ask once |49| Landing page per theme (its headline, its offer) | no | browse it; the reader pastes the headline | message match `not checked`; open item |50| Keyword theme per search ad group (the words the queries share) | no | `search-terms-triage` handoff; the ad group's keywords; the reader | the keyword check is skipped for that ad group |51| Old assets and their ratings | no | an asset report export | write fresh; nothing is carried over |52| Voice rules and words to avoid | no | `## Voice` | voice checked on the generic rules only, coverage `partial` |53| Approved claims, never-say list, competitor names | no | `## Claims and proof`; `### Never say`; `## Competitors` | every number is `unsourced`; competitor check runs on names the reader gives |54 55## Profile read56 57From `company-profile.md`: `## Company` (brand terms), `## Buyers` and `### Buying group` (who each ad speaks to), `## Messaging house`, `## Voice` (point of view, tone, words to use and avoid, lines that sound right), `## Claims and proof` and `### Never say`, `## Competitors` (names and mention policy), and every `## Learnings` entry for `ad-variants`, `voice-check` and `claim-check` with status `noted`, `fact` or `accepted`.58 59No profile: ask in one message for who the ad is for, the problem, the result, one proof with its source, the call to action and the words the company never uses. Say that `company-profile` saves this next time.60 61## Steps62 631. **Apply learnings.** Asset patterns that won or lost before (a proof headline that beat a feature headline) change the mix in step 4. Name each one that fires.64 652. **Load the limits** from `references/platform-limits.md`. If a limit was checked more than 6 months ago, open its source again and say what changed.66 673. **Collect the parts per theme:** who it's for (in their words), the moment or problem, the result as a verb phrase ("see pipeline by channel"), one proof with its source, the offer, the landing page headline, the keyword theme for search.68 694. **Write per platform.**70 71 | Platform | What to write | Roles each asset plays |72 | --- | --- | --- |73 | Google or Microsoft responsive search ad | 8 to 12 headlines, 3 to 4 descriptions per ad group (under 8 limits combinations; over 12 and assets never gather impressions) | at least 3 carry the keyword theme (pin 1 of them to position 1, nothing else pinned); at least 2 proof; at least 2 for whom or a qualifier that turns the wrong searcher away; at least 2 the action or offer. Descriptions: the moment and the mechanism; the proof and the action; the objection answered. Every headline must read next to any other |74 | LinkedIn single image | 3 variants per theme | the first line of the intro text carries the whole message; the headline names the offer; a call to action from LinkedIn's list |75 | Meta feed image | 3 variants per theme | the problem in the first line; proof next; the headline names the offer |76 | ChatGPT chat card | 2 or 3 cards per theme, plus context hints | the title follows on from the buyer's question; the body gives the next step, not the answer again; hints describe the use cases and needs, not keywords |77 | Reddit | 2 promoted posts per theme | a plain headline a member would write; a useful offer that works without a demo; no ad words |78 795. **Vary one thing.** Within a test, each variant changes one variable from the theme's control: the angle, the proof, the offer or the opening. Label each variant with the variable it changes. Search assets are a pool, not variants: their variety comes from the roles in step 4.80 816. **Match the page.** Search: headline 1 carries the keyword theme's words, and the headlines share at least half of the landing page headline's words (fewer and the visitor lands on a different promise). Social and ChatGPT: the offer the ad names is the first thing the page delivers, in the same words.82 837. **Run the checks.** `python3 scripts/check_ads.py --ads ads.json` (input format in its docstring): lengths against the limits, counts, near duplicates (60% shared words), repeated openers, the keyword theme, message match, competitor names, dynamic keyword insertion in competitor campaigns, dashes, words to avoid, empty words, superlatives and generic calls to action. Without Python, count characters for every asset (double-width characters count 2 on search), compare each pair of assets in a field for shared words, and say you checked by hand. Then run `voice-check` and `claim-check` on the set (inline without them: no em or en dashes, no profile words to avoid, every number and result in `## Claims and proof` and in date, nothing from `### Never say`).84 85## Check and verdict86 87| Check | Fails when |88| --- | --- |89| Length | any field over a hard limit; past a recommendation is a warning |90| Count | outside the platform's allowed range; outside 8 to 12 headlines or 3 to 4 descriptions is a warning |91| Variety | in a search asset pool, or in the field a social test varies, 2 assets share 60% or more of their words, or 3 open with the same 2 words (fields a test holds constant as its control are meant to repeat) |92| Message match | headline 1 lacks the keyword theme; under half the landing headline's words appear |93| Proof | a number, result, quote or superlative without a verified claim (`claim-check`) |94| Voice | a line fails `voice-check` |95| Competitors | a competitor name in ad text; keyword insertion in a competitor campaign |96| One call to action | an ad asks for 2 things |97 98| Verdict | Condition (first match wins) |99| --- | --- |100| `BLOCKED` | No theme and no message parts after one question |101| `NEEDS PROOF` | The reader requires a claim that `claim-check` marks unsupported, unsourced, expired or forbidden, or a competitor trademark in ad text: those variants are not written, and the reader is asked for the source or a change |102| `READY WITH GAPS` | Variants written, but checks still open after 2 rounds, message match not checked (no page), or a platform's limits unconfirmed (each named) |103| `READY` | Every check passes |104 105Named stops: `BLOCKED` asks for the parts. `NEEDS PROOF` stops on the claim, shows what `claim-check` found, and offers variants built on the approved proof instead. No other stops.106 107## Loop108 1091. Run the checks.1102. Fix only what failed: shorten, replace a duplicate with an asset that plays a missing role, swap a claim for an approved one, rewrite in the profile's voice.1113. Check again. At most 2 rounds, then hand over with what is still open, labelled `open`.112 113## Learn114 115Append to `## Learnings` when:116 117- an asset report after 30 days shows which assets rated Best or Low: a `fact` naming the role each played (proof, qualifier, action);118- a test between variants reads on qualified leads or opportunities (not clicks): a `fact` with the variable that won;119- an ad is disapproved: a `fact` with the platform's reason, so later runs avoid it;120- the reader rejects a variant's tone: a `proposal` for `voice-check`'s rules.121 122Example: `- 2026-10-24 | ad-variants | fact | Headlines with the 14-day setup proof rated Best in 3 of 4 ad groups; feature headlines rated Low | Why: Google Ads asset report, Sep 2026 | Status: noted`123 124## Output125 126```127Verdict: <READY | READY WITH GAPS | NEEDS PROOF | BLOCKED> · Coverage: <complete | partial (what's missing)> · Checks: <script | by hand>128 129For each theme and platform:130<Theme> · <Platform> · landing page: <headline> · keyword theme: <words>131| Field | Text | Length / limit | Role or variable | Pin |132Message match: <share or not checked> · Variety: <pass or findings>133 134Not written: <claims or names refused, and why>135Check: <each check, pass or fail> · Rounds: <n>136Open: <labelled items>137Learnings applied: <list, or none>138```139 140Then the handoff block.141 142## Hand off143 144```handoff145skill: ad-variants146version: 1.0.0147verdict: READY148coverage: complete149for: <themes and platforms>150outputs:151 sets: 3152 platforms: [google_rsa, linkedin_single_image]153 headlines: 10154 descriptions: 4155 not_written: []156next: [ad-creative-critic, landing-page-critic]157open: []158```159 160## Failure modes161 162| Problem | Do this |163| --- | --- |164| The brand name is long and eats the headline | Keep the brand out of most headlines; the display URL already carries it on search |165| The proof needs a sentence of context | It doesn't fit an ad: pick a proof a buyer can check in one line, or move it to the page |166| The landing page says something different from the theme | Flag it as the largest fix; message match beats any wording change |167| The reader wants 15 headlines | Allowed by the platform; warn that past 12, assets rarely gather enough impressions to be rated |168| Microsoft autogenerated assets are on | Say they're on by default and may write claims you haven't approved; recommend turning them off or reviewing them |169| A limit can't be confirmed (Reddit) | Write the copy, mark its length `unchecked`, ask for the current limit |170 171## Influenced by172 173- Each platform's own ad specifications, listed with their dates in `references/platform-limits.md`, for example Google's responsive search ad limits: https://support.google.com/google-ads/answer/7684791?hl=en174- SHAKEUP's B2B Google Ads playbook, for the asset roles (keyword theme first, proof or qualifier next, one action), pinning position 1 only, and testing one variable at a time.175- SHAKEUP's ad copy checks: fit, who it's for, the result, proof, the next step, you before we, and no words any company could say.