Skill · Workflow

search-social-ad-copy-variants

Reads your landing page and competitors' pages, writes headlines and descriptions from five angles in parallel, removes claims the page doesn't support, checks every line against Google responsive search ad limits and Meta's recommended lengths, and returns a Google Ads Editor CSV plus a Meta table. Use when asked to run the "Search and social ad copy with limit checks" workflow.

The skill itself. Agents read the name and description first and load the rest only when a task matches.

search-social-ad-copy-variants/SKILL.md
---
name: search-social-ad-copy-variants
description: Reads your landing page and competitors' pages, writes headlines and descriptions from five angles in parallel, removes claims the page doesn't support, checks every line against Google responsive search ad limits and Meta's recommended lengths, and returns a Google Ads Editor CSV plus a Meta table. Use when asked to run the "Search and social ad copy with limit checks" workflow.
---

# Search and social ad copy with limit checks

Reads your landing page and competitors' pages, writes headlines and descriptions from five angles in parallel, removes claims the page doesn't support, checks every line against Google responsive search ad limits and Meta's recommended lengths, and returns a Google Ads Editor CSV plus a Meta table.

## Inputs

Ask for any of these that the user hasn't given:

- `product` (e.g. "Ledgerly, an invoicing app for freelancers that sends invoices and chases late payments automatically")
- `audience` (e.g. "Freelance designers and developers in the US with 1–10 clients")
- `landing_page` (e.g. "https://ledgerly.example/freelancers (or paste the page text)")
- `keywords` (e.g. "invoice app for freelancers, freelance invoicing software, automatic payment reminders")
- `competitors` (e.g. "FreshBooks, Wave, Bonsai")
- `past_performance` (e.g. "Winner: 'Get Paid Without Chasing' CTR 6.1%, conv 4.2%. Loser: 'All-in-One Finance Hub' CTR 1.2%. Or 'none'.")
- `brand_rules` (e.g. "No 'best' or '#1'. Say 'invoices', not 'bills'. Free plan exists; 14-day Pro trial. No exclamation marks.")
- `campaign` (e.g. "Search – Freelancer invoicing – US")
- `ad_group` (e.g. "Invoice app – exact")

## Steps

Run the steps in order. Refer to saved results by name. Don't skip a step that says STOP.

1. **Describe the product** — Start: Start with {{product}}, {{audience}}, {{landing_page}}, {{keywords}}, {{competitors}}, {{past_performance}} and {{brand_rules}}. The CSV uses {{campaign}} and {{ad_group}}. Nothing is uploaded: you get a file to import.
2. **Research the page and competitors** — 1. Landing page: if {{landing_page}} is a URL, fetch it; if it is pasted text, use that. If the fetch fails, say so and continue with what you have. Extract the main promise, every factual claim (numbers, guarantees, ratings, integrations, pricing, free plan or trial) copied word for word, the offer and the call to action. Only these on-page claims may appear in ads.
2. Competitors: for each name in {{competitors}}, read their homepage and the landing page that ranks for the closest phrase in {{keywords}}. Record the headline wording, offers and proof points you can actually see. Live search ads and Meta Ad Library entries usually can't be read with web tools: try once, say if they were unreadable, and never guess what an ad says.
3. Name 3 angles the competitors leave open for {{product}}.
Cite a URL for every competitor observation. Return: Claims table (claim | exact wording | URL), Competitor angles table (competitor | angle | example wording | URL), Openings. Save the result as `market_notes`.
3. **Learn from past results** — From {{past_performance}}, list the winning and losing patterns: wording, angle, length, call to action, each with its metric. Turn them into 3–5 do/don't rules, each citing the ad it came from. If no history is given, write 'No history: all angles weighted equally' and nothing else. Save the result as `lessons`.
4. **Write five angles in parallel** — Launch these as parallel subagents in one message, then wait for all of them. Write ad copy for {{product}} aimed at {{audience}}, using only the on-page claims in {{market_notes}} and following {{lessons}} and {{brand_rules}}. For your angle write: 6 Google headlines (30 characters max, spaces included), 2 Google descriptions (90 characters max), 2 Meta primary texts (125 characters or fewer, so nothing is cut before 'See more') and 2 Meta headlines (40 characters or fewer, so they aren't truncated on most placements). Put the character count in brackets after every line, e.g. 'Invoices That Chase Late Pay (28)'. At least 2 of the 6 headlines must contain a phrase from {{keywords}}. Save the result as `variants`.
   - **Pain**: Lead with the problem the audience feels (late payments, admin time), using their words where the page or the lessons give them.
   - **Outcome**: Lead with the result after using the product (paid sooner, less admin), only as specific as the page allows.
   - **Proof**: Lead with on-page proof: numbers, user counts, ratings, named integrations. If the page has none, say so and write credibility lines from concrete features instead.
   - **Offer**: Lead with the offer on the page: free plan, trial, price. If the page has no offer, the copy has no offer.
   - **Objection**: Answer the most likely reason not to click (setup time, switching, price, trust) using facts from the page.
5. **Brand and policy review** — Review {{variants}} against {{brand_rules}} and the Claims table in {{market_notes}}. Remove or rewrite: any claim not on the page; superlatives and rankings ('best', '#1', 'fastest') unless the page states them with a source; competitor brand names (trademark disapprovals); exclamation marks in headlines; ALL-CAPS words other than acronyms; repeated punctuation; phone numbers; 'click here'.
Then choose the final set:
- exactly 15 Google headlines: at least 3 contain a keyword, at least 3 state a benefit, at least 2 give proof, at least 2 are calls to action; no two say the same thing
- exactly 4 Google descriptions, each ending with a call to action
- Path 1 and Path 2 (15 characters max each, no spaces)
- 5 Meta variants (primary text + headline), one per angle
Keep the character count after every line. End with a 'Removed' list: line, reason. Save the result as `adset`.
6. **Validate character limits** — Review loop (max 4 passes): Count the characters of every line yourself, including spaces and punctuation. Ignore the number printed in brackets.
1. Exactly 15 Google headlines, each 30 characters or fewer.
2. Exactly 4 Google descriptions, each 90 characters or fewer.
3. Path 1 and Path 2 each 15 characters or fewer, with no spaces.
4. Each Meta headline 40 characters or fewer; each Meta primary text 125 characters or fewer.
5. No exclamation marks in Google headlines; no duplicate or near-duplicate headlines.
6. Every printed count matches the real count.
Feedback must name each failing line with its real count. A fix shortens the line without changing or adding a claim. Save the result as `adset`.
7. **Build the upload CSV** — Turn {{adset}} into:
1. A Google Ads Editor CSV: one header row and one data row with columns Campaign, Ad group, Ad type, Final URL, Path 1, Path 2, Headline 1 … Headline 15, Description 1 … Description 4. Campaign = {{campaign}}, Ad group = {{ad_group}}, Ad type = Responsive search ad, Final URL = the URL in {{landing_page}} (blank if page text was pasted). Copy every line exactly and drop the bracketed counts. Wrap any field with a comma in double quotes and double any quote marks inside it.
2. A Meta table: Variant | Angle | Primary text | Headline | Characters (primary / headline).
3. Three test notes: which angles to watch first and why, based on {{lessons}}. Save the result as `csv`.
8. **Approve the ads** — STOP and ask the user to approve before continuing: Check {{csv}} and the 'Removed' list in {{adset}}. Confirm every claim is true today. After importing, check Google Ads Editor's warnings: it flags any line over the limit, which is the final check on the counts. Approve, edit or reject.
9. **Save the CSV** — Finish: Return {{csv}} and {{adset}}.

## Done when

Every step has run, each approval was given, and you've reported what was produced and where it was saved.