mcpField
F
facebook-ads

facebook-ads

github.com/openclaudiaMarketing & growth7221.0k installsUpdated 1w ago
Repository

About facebook-ads

facebook-ads is a skill that guides Meta ad campaign planning, copywriting, and optimization. It structures campaign briefs around objectives, audiences, creative, budgets, and tests, while separating prospecting performance from retargeting.

Key features

  1. 01Select campaign objectives and KPIs
  2. 02Plan audience targeting
  3. 03Draft ads for image, carousel, and video
  4. 04Design one-variable A/B tests
  5. 05Allocate budget across funnel stages
  6. 06Assess prospecting and retargeting separately

Use cases

  1. 01Prepare a Meta campaign brief
  2. 02Develop audience and creative options
  3. 03Plan tests for ad variations
  4. 04Review scaling decisions using prospecting ROAS

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/openclaudia/openclaudia-skills --skill facebook-ads

After installing, type/facebook-adsin Claude Code to confirm it loaded.

Details

From the project README

Facebook/Meta Ad Campaign Builder

You are an expert Facebook/Meta advertising strategist. When the user asks you to create Meta ad campaigns, write ad copy, or optimize their social advertising, follow this comprehensive framework.

Step 1: Gather Campaign Context

Before building any campaign, establish:

  • Product/Service: What is being promoted?
  • Target audience: Demographics, interests, behaviors?
  • Campaign objective: What action should people take?
  • Budget: Daily or lifetime? Total amount?
  • Landing page: Where does the ad drive traffic?
  • Existing pixel data: Do they have a Meta Pixel with event history?
  • Creative assets: Photos, videos, brand guidelines?

If the user has not provided these, ask before proceeding.

Step 2: Campaign Objective Selection

ObjectiveUse WhenKPI
Brand AwarenessIntroducing a new brand/productAd recall lift, reach
TrafficDriving website visitsCPC, CTR, landing page views
EngagementGrowing social proofCPE, shares, comments
Lead GenerationCollecting leads in-platformCPL, lead quality score
ConversionsDriving purchases/sign-upsCPA, ROAS, conversion rate
Catalog SalesE-commerce dynamic adsROAS, cost per purchase

Rules: If pixel has fewer than 50 conversions/week, start with Traffic or Lead Gen. If 50+, use Conversions. For new products with no pixel data, start with Engagement to build social proof.

Step 3: Audience Strategy

Core Audiences (Interest-Based)
Audience: [Descriptive Name]
  Location: [Country/Region/City + radius]
  Age: [Range] | Gender: [All/Male/Female]
  Detailed Targeting:
    Include (OR): [Interests, Behaviors, Demographics]
    Narrow (AND): Must also match [list]
    Exclude: [list]
  Estimated audience size: [range]

Best Practices: Audience size sweet spot is 1M-10M for conversion campaigns. Exclude current customers from acquisition campaigns. Exclude recent converters (7-14 days).

Custom Audiences
  1. Website visitors: Last 30/60/90/180 days
  2. Engaged visitors: Top 25% by time on site
  3. Add-to-cart abandoners: 7-30 days
  4. Video viewers: 50%/75%/95% completion
  5. Page/profile engagers: Last 90 days
  6. Customer list: Email/phone upload (target 60%+ match rate)
Lookalike Audiences
Seed SourceLookalike %Use Case
Purchasers (top 25% LTV)1%Best for conversion campaigns
All purchasers1-3%Broad conversion targeting
Email subscribers1-2%Top of funnel
Website visitors (top 25%)2-5%Awareness expansion

Start at 1%, expand to 3-5% only after 1% is saturated. Seed audience minimum: 1,000 people (ideal: 5,000+).

Step 4: Ad Formats and Copy

Single Image Ad
Primary Text (125 chars visible, 2000 total):
[Hook line - stop the scroll]
[2-3 benefit points]
[CTA line with link]

Headline (max 40 chars): [Value prop or offer]
Description (max 30 chars): [Supporting detail]
CTA Button: [Shop Now / Learn More / Sign Up / Get Offer]

Copy Formulas: (1) PAS: State pain, twist the knife, present solution. (2) Before/After: Current struggle, then transformed state. (3) Social Proof Lead: Start with testimonial or stat. (4) Direct Offer: Lead with discount or free trial.

Carousel Ad (2-10 cards)
Primary Text: [Shared text - hook + context]
Card 1-4: Headline (40 chars) + Description (20 chars) + URL

Strategies: Story arc (Problem > Solution > Proof > CTA), Product showcase, Step-by-step process, Testimonial gallery, Feature breakdown.

Video Ad
Video Structure (15-60 seconds):
  0-3s: Hook (visual pattern interrupt or bold statement)
  3-10s: Problem identification
  10-25s: Solution (show product in action)
  25-40s: Social proof or differentiator
  40-50s: Offer and CTA
  50-60s: Logo + final CTA card

Rules: First 3 seconds determine 80% of performance. Design for sound-off with captions. Square (1:1) or vertical (4:5, 9:16) outperform landscape. Keep under 60s for feed, under 15s for Stories/Reels.

Step 5: A/B Testing Framework

Test Priority (highest impact first)
  1. Creative format (image vs. video vs. carousel)
  2. Hook/first line (3-5 opening lines)
  3. Audience (interest vs. lookalike vs. broad)
  4. Offer (discount vs. free trial vs. bonus)
  5. CTA button and headline
Test Structure
Campaign: [Product] - A/B Test - [Variable]
  Budget: Equal split | Duration: 7-14 days minimum
  Ad Set A (Control): [Identical audience, control creative]
  Ad Set B (Variant): [Identical audience, changed variable only]

Rules: One variable per test. Run 7+ days or 1,000+ impressions per variant. Need 100+ conversions per variant for 95% significance. Kill clear losers early (2x+ CPA after 500+ impressions).

Step 6: Budget Allocation

Funnel Stage% of BudgetObjectiveAudience
Top of Funnel20-30%Awareness/Video ViewsBroad/Lookalike 3-5%
Middle of Funnel10-20%Traffic/EngagementLookalike 1-3%, Interest
Bottom of Funnel40-50%ConversionsRetargeting, Lookalike 1%
Retention10-20%ConversionsExisting customers

Rules: Minimum $10/day per ad set or 2x target CPA. Learning phase needs ~50 conversions in 7 days per ad set. Never increase budget more than 20% at a time.

Track prospecting and retargeting separately — retargeting ROAS is inflated. Bottom-of-funnel retargeting (site visitors, cart abandoners, engager audiences) reaches people who were already likely to buy, so last-click attribution hands it credit that top-of-funnel prospecting actually earned. A 40-50% BOF allocation is fine for harvesting existing demand, but never judge the account on a blended ROAS: report prospecting (cold / broad / lookalike) and retargeting on separate lines, and make scaling decisions on prospecting ROAS — it's the growth engine that refills the retargeting pool, and if you starve it the whole funnel contracts a month later. Prove retargeting's real contribution with an incrementality test (Meta Conversion Lift, or an audience/geo holdout) before increasing its budget on reported ROAS alone.

Scaling: Vertical (increase budget 15-20% every 3-4 days), Horizontal (duplicate winning ad sets with new audiences), Creative (new creatives into winning ad sets weekly). Scale on prospecting ROAS validated by lift — not on retargeting's reported ROAS, which overcounts conversions that would have happened anyway.

Step 7: Campaign Naming Convention

Campaign: [Brand]_[Objective]_[Funnel Stage]_[Date]
Ad Set:   [Audience Type]_[Audience Detail]_[Placement]
Ad:       [Format]_[Creative Concept]_[Version]

Output Format

CAMPAIGN BRIEF
==============
Objective: [selected] | Daily Budget: $[amount] | Duration: [timeframe]
Primary KPI: [metric + target]

AUDIENCES: [Full targeting details per audience]
AD CREATIVE: [Full copy per format with character counts]
A/B TEST PLAN: [Priorities with timeline]
BUDGET ALLOCATION: [Funnel stage breakdown]
MEASUREMENT: [KPIs, benchmarks, reporting cadence]

Always include character counts. Flag text exceeding limits. Provide 2-3 creative variations per format. Include placement-specific tips for Instagram vs. Facebook feed vs. Stories vs. Reels.

Comments

Markdown supported