PluginBench
Skill
Review
Audit score 70

ads-meta

agricidaniel/claude-ads

How to install ads-meta

npx skills add https://github.com/agricidaniel/claude-ads --skill ads-meta
Claude Code
Cursor
Windsurf
Cline
Full instructions (SKILL.md)

Source of truth, from agricidaniel/claude-ads.


name: ads-meta description: "Meta Ads deep analysis covering Facebook, Instagram, and Threads advertising in the Andromeda + GEM + Lattice era. Evaluates 50 checks across Pixel/CAPI health, creative diversity and Entity-ID clustering risk, account structure, ASC/AAC defaults for Sales/Leads/App, and audience targeting. Includes Advantage+ assessment and creative-as-targeting scoring. Use when user says Meta Ads, Facebook Ads, Instagram Ads, Threads ads, Advantage+, ASC, AAC, Andromeda, GEM, Lattice, Entity-ID clustering, creative diversity, Sales optimization, Leads optimization, App optimization, or Meta campaign." user-invokable: false tested_date: 2026-05-17 tested_with: claude-code v2.x

Meta Ads Deep Analysis

Andromeda + GEM + Lattice (2026)

Meta's delivery stack was rebuilt across three releases:

  • Andromeda (Oct 2025) — ad-retrieval ranking model with 10,000× more model capacity than the previous funnel (Meta Engineering, Dec 2024). Filters the candidate creative set before the auction layer ever sees it.
  • GEM (Generative Embedding Model, late 2025) — replaces the feature pipeline. Creative content embeds directly into the targeting space, which is why "creative is the new targeting" is now mechanical truth not slogan.
  • Lattice (rolled out late 2025 / early 2026) — sequence-aware optimizer on top of GEM that uses user-action sequences to rank candidate ads.

Net effect: creative diversity is now the #1 performance lever. Ads with Similarity Score >60% (per Confect's measured threshold) get retrieval suppression — the algorithm clusters near-identical creatives and silently limits their delivery. 100 minor variations perform no better than 10 genuinely distinct ones. Prioritize concept / angle / format diversity over variant volume.

Creative-as-targeting scoring rubric

When auditing a creative library against Andromeda's retrieval logic, score across these 5 axes (each 0-2, total 0-10):

Axis0 (Risk)1 (OK)2 (Strong)
Concept diversitySingle core message / value prop across all assets2 distinct messages3+ distinct angles (problem-led, social proof, comparison, …)
Format diversityOne format (e.g. all static image)2 formats3+ (image, video, carousel, collection)
Visual diversityOne palette / one model / one composition2 distinct visual treatments3+ visually distinct treatments
Hook diversity (video)All hooks ≤3s look alike2 hook patterns3+ hook patterns (UGC POV, question, claim, demo, …)
Headline diversityAll headlines paraphrase the same line2 headline structures3+ structures (number-led, question, claim, comparison)

Score 8-10 = LOW Entity-ID clustering risk. Score 4-7 = MEDIUM risk (some suppression likely). Score 0-3 = HIGH risk (significant retrieval ticket loss).

Entity-ID Clustering Predictor (pre-launch)

Before launch, predict which creatives Meta will cluster. Cluster-mates share retrieval tickets — only one wins per impression opportunity.

Predictor heuristics (apply to every pair of creatives in the launch set):

  1. Visual fingerprint — same product hero, same model, same backdrop, same lighting → likely cluster. Different products or different visual identities → likely not a cluster.
  2. Headline fingerprint — same first 4 tokens → likely cluster (e.g. "Save 30% on" + "Save 30% off" + "Save 30% — limited time").
  3. Body copy fingerprint — same opening sentence, same CTA verb → likely cluster regardless of middle-body differences.
  4. Video hook fingerprint — same 0-3s shot, same voiceover pattern → likely cluster even if the rest of the video diverges.
  5. Format mismatch wins — if pair is (static + video) AND visual fingerprint differs, they are not clustered. Crossing format AND visual is a strong diversity signal.

Output: produce a creative-cluster-risk.md deliverable that groups the launch set into predicted clusters, recommends which creative in each cluster should ship and which should be cut or rebuilt, and reports the final pre- launch diversity score (target ≥8/10).

MAPI v25 ASC/AAC Deprecation Detector

Meta Marketing API v25 deprecates the explicit Advantage Shopping Campaigns (ASC) and Advantage App Campaigns (AAC) creation paths — those campaign types are folded into standard Sales / Leads / App objectives where ASC behavior becomes the default configuration. Detection:

  • If the account uses MAPI v23 or earlier: ASC/AAC API endpoints will return deprecation warnings before the v25 cutover. Capture and flag them.
  • If the account uses MAPI v25+: confirm that previously-ASC campaigns have been migrated to the new objective-default model with the equivalent catalog + budget + existing-customer cap settings preserved.
  • If creating new campaigns: use the Sales / Leads / App objective + ASC defaults rather than the legacy ASC/AAC endpoints.

ASC defaults for Sales / Leads / App (2026 behavior)

When Sales / Leads / App objectives are selected, ASC behaviors are now the default. Audit confirms:

  • Catalog connection (Sales): product catalog linked and feed health green
  • Existing customer cap (Sales): set to 10-25% (default may be too high for high-LTV brands)
  • Advantage+ Audience (all three objectives): on by default; only override with manual interest stacks for highly restricted categories
  • Advantage+ Creative (all three): text / brightness / music enhancements on by default; if your brand-safety policy requires off, document the exception per ad set

Process

  1. Collect Meta Ads data (Ads Manager export, Events Manager screenshot, EMQ scores)
  2. Read ads/references/meta-audit.md for full 50-check audit
  3. Read ads/references/benchmarks.md for Meta-specific benchmarks
  4. Read ads/references/scoring-system.md for weighted scoring
  5. Evaluate all applicable checks as PASS, WARNING, or FAIL
  6. Calculate Meta Ads Health Score (0-100)
  7. Generate findings report with action plan

What to Analyze

Pixel / CAPI Health (30% weight)

  • Meta Pixel installed and firing on all pages
  • Conversions API (CAPI) active (30-40% data loss without it post-iOS 14.5)
  • Event deduplication configured (event_id matching, ≥90% dedup rate)
  • Event Match Quality (EMQ) ≥8.0 for Purchase event
  • All standard events configured (ViewContent, AddToCart, Purchase, Lead)
  • Custom conversions created for non-standard events
  • Aggregated Event Measurement (AEM) configured for iOS
  • Domain verification completed
  • Server-side events include customer_information parameters
  • Pixel fires with correct currency and value parameters

Creative (30% weight)

  • ≥3 creative formats active (image, video, carousel, collection)
  • ≥5 creatives per ad set (Meta recommendation)
  • Creative fatigue detection: CTR drop >20% over 14 days = FAIL
  • Video creative: 15s max for Stories/Reels, 30s max for Feed
  • UGC/testimonial creative tested
  • Dynamic Creative Optimization (DCO) tested
  • Ad copy: headline under 40 chars, primary text under 125 chars
  • Creative refresh cadence: every 2-4 weeks for high-spend

Account Structure (20% weight)

  • Campaign Budget Optimization (CBO) vs Ad Set Budget (ABO) intentional
  • Campaign consolidation: 1-3 campaigns total recommended
  • Learning phase health: <30% ad sets in "Learning Limited" (FAIL >50%)
  • Budget per ad set: ≥5x target CPA (minimum for learning phase exit)
  • Ad set audience overlap <30% (Audience Overlap tool)
  • Campaign naming conventions consistent and descriptive
  • Advantage+ Sales Campaigns active for e-commerce
  • Simplified campaign structure: 1-3 campaigns total (fewer, larger ad sets preferred)

Audience & Targeting (20% weight)

  • Prospecting frequency (7-day): <3.0 (WARNING 3-5, FAIL >5)
  • Retargeting frequency (7-day): <8.0 (WARNING 8-12, FAIL >12)
  • Custom Audiences: website visitors, customer lists, engagement
  • Lookalike Audiences: multiple seed sizes tested (1%, 3%, 5%)
  • Advantage+ Audience tested vs manual targeting
  • Interest targeting: broad enough for algorithm optimization
  • Exclusions: purchasers excluded from prospecting, overlap managed
  • Location targeting reviewed for relevance

Advantage+ Assessment

If Advantage+ features are in use:

  • Advantage+ Sales Campaigns: catalog connected, existing customer cap set
  • Advantage+ Audience: performance vs manual audience compared
  • Advantage+ Creative: enhancements enabled (text, brightness, music)
  • Advantage+ Placements: enabled (let Meta optimize placement mix)
  • Budget allocation: Advantage+ campaigns getting fair test budget

Special Ad Categories

If ads are in restricted categories:

  • Special Ad Category declared before campaign creation
  • Targeting restrictions verified (no ZIP, age 18-65+ only, no Lookalike)
  • Creative compliance with category-specific policies
  • Read ads/references/compliance.md for full requirements

EMQ Optimization Guide

EMQ ScoreStatusAction
8.0-10.0ExcellentMaintain current setup
6.0-7.9GoodAdd more customer_information parameters
4.0-5.9FairImplement CAPI, improve data quality
<4.0PoorCritical: CAPI + Enhanced Matching required

Key parameters to maximize EMQ:

  • em (email): highest match rate signal
  • ph (phone): second highest match signal
  • fn, ln (first/last name): improves match accuracy
  • ct, st, zp (city, state, zip): geographic matching
  • external_id: CRM/user ID for cross-device matching

Key Thresholds

MetricPassWarningFail
EMQ (Purchase)≥8.06.0-7.9<6.0
Dedup rate≥90%70-90%<70%
CTR≥1.0%0.5-1.0%<0.5%
Creative formats≥321
Creatives per ad set≥53-4<3
Learning Limited<30%30-50%>50%
Budget per ad set≥5x CPA2-5x CPA<2x CPA

Output

Meta Ads Health Score

Meta Ads Health Score: XX/100 (Grade: X)

Pixel / CAPI Health: XX/100  ████████░░  (30%)
Creative:            XX/100  ██████████  (30%)
Account Structure:   XX/100  ███████░░░  (20%)
Audience:            XX/100  █████░░░░░  (20%)

Deliverables

  • META-ADS-REPORT.md: Full 50-check findings with pass/warning/fail
  • EMQ improvement roadmap
  • Creative fatigue alerts (any creative with CTR declining >20%)
  • Quick Wins sorted by impact
  • Advantage+ adoption recommendations

Threads Placement

Threads placement GA Jan 2026, 400M+ MAU. Lower CPMs than Feed/Stories. Currently ~0.04% of total spend. Emerging channel. Evaluate:

  • Is Threads placement enabled in Advantage+ Placements?
  • Monitor CPM and engagement vs other placements
  • Early-mover advantage for brands with active Threads presence

Related skills

More from agricidaniel/claude-ads and the wider catalog.

AD

ads

agricidaniel/claude-ads

Multi-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, Apple, and Amazon Ads. 250+ checks with scoring, parallel agents, industry templates, AI creative generation, attribution and server-side tracking deep dives.

1.4k installs
AD

ads-google

agricidaniel/claude-ads

Google Ads deep analysis covering Search, Performance Max, AI Max, Display, YouTube, and Demand Gen campaigns. Evaluates 80 checks across conversion tracking, wasted spend, account structure, keywords, ads, and settings. Includes AI Max (search-term-matching, AI Brief, text customization, FUE, brand exclusions) and Smart Bidding signals. Use when user says Google Ads, Google PPC, search ads, PMax, Performance Max, AI Max, AI Brief, broad match audit, Quality Score check, search terms audit, Smart Bidding, or Google campaign.

1.2k installs
AD

ads-tiktok

agricidaniel/claude-ads

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop under the TikTok USDS Joint Venture (post Jan 2026 divestiture). Evaluates 28 checks with emphasis on creative-first strategy, safe zone compliance, creative diversity for retrieval, and Smart+ campaigns. Use when user says TikTok Ads, TikTok marketing, TikTok Shop, Spark Ads, Smart+, USDS, creative diversity for retrieval, or TikTok campaign.

1.2k installs
AD

ads-creative

agricidaniel/claude-ads

Cross-platform creative quality audit covering ad copy, video, image, and format diversity across all platforms. Detects creative fatigue, evaluates platform-native compliance, scores creative diversity for Andromeda Entity-ID retrieval, and provides production priorities. Use when user says creative audit, ad creative, creative fatigue, creative diversity score, ad variation audit, ad copy, ad design, or creative review.

1.2k installs
AD

ads-competitor

agricidaniel/claude-ads

Competitor ad intelligence analysis across Google, Meta, LinkedIn, TikTok, Microsoft, and Apple Ads. Analyzes competitor ad copy, creative strategy, keyword targeting, estimated spend via Meta Ad Library / Google Ads Transparency Center / TikTok Top Ads, and identifies competitive gaps and opportunities. Use when user says competitor ads, ad spy, competitive analysis, competitor PPC, ad intelligence, Meta Ad Library, Facebook Ad Library, Google Ads Transparency, competitor creative, or competitor research.

1.2k installs
AD

ads-landing

agricidaniel/claude-ads

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says landing page, post-click experience, landing page audit, LP audit, conversion rate, landing page CRO, post-click CRO, or landing page optimization.

1.1k installs