How to install ads-meta
npx skills add https://github.com/agricidaniel/claude-ads --skill ads-metaFull 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):
| Axis | 0 (Risk) | 1 (OK) | 2 (Strong) |
|---|---|---|---|
| Concept diversity | Single core message / value prop across all assets | 2 distinct messages | 3+ distinct angles (problem-led, social proof, comparison, …) |
| Format diversity | One format (e.g. all static image) | 2 formats | 3+ (image, video, carousel, collection) |
| Visual diversity | One palette / one model / one composition | 2 distinct visual treatments | 3+ visually distinct treatments |
| Hook diversity (video) | All hooks ≤3s look alike | 2 hook patterns | 3+ hook patterns (UGC POV, question, claim, demo, …) |
| Headline diversity | All headlines paraphrase the same line | 2 headline structures | 3+ 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):
- Visual fingerprint — same product hero, same model, same backdrop, same lighting → likely cluster. Different products or different visual identities → likely not a cluster.
- Headline fingerprint — same first 4 tokens → likely cluster (e.g. "Save 30% on" + "Save 30% off" + "Save 30% — limited time").
- Body copy fingerprint — same opening sentence, same CTA verb → likely cluster regardless of middle-body differences.
- Video hook fingerprint — same 0-3s shot, same voiceover pattern → likely cluster even if the rest of the video diverges.
- 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
- Collect Meta Ads data (Ads Manager export, Events Manager screenshot, EMQ scores)
- Read
ads/references/meta-audit.mdfor full 50-check audit - Read
ads/references/benchmarks.mdfor Meta-specific benchmarks - Read
ads/references/scoring-system.mdfor weighted scoring - Evaluate all applicable checks as PASS, WARNING, or FAIL
- Calculate Meta Ads Health Score (0-100)
- 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.mdfor full requirements
EMQ Optimization Guide
| EMQ Score | Status | Action |
|---|---|---|
| 8.0-10.0 | Excellent | Maintain current setup |
| 6.0-7.9 | Good | Add more customer_information parameters |
| 4.0-5.9 | Fair | Implement CAPI, improve data quality |
| <4.0 | Poor | Critical: CAPI + Enhanced Matching required |
Key parameters to maximize EMQ:
em(email): highest match rate signalph(phone): second highest match signalfn,ln(first/last name): improves match accuracyct,st,zp(city, state, zip): geographic matchingexternal_id: CRM/user ID for cross-device matching
Key Thresholds
| Metric | Pass | Warning | Fail |
|---|---|---|---|
| EMQ (Purchase) | ≥8.0 | 6.0-7.9 | <6.0 |
| Dedup rate | ≥90% | 70-90% | <70% |
| CTR | ≥1.0% | 0.5-1.0% | <0.5% |
| Creative formats | ≥3 | 2 | 1 |
| Creatives per ad set | ≥5 | 3-4 | <3 |
| Learning Limited | <30% | 30-50% | >50% |
| Budget per ad set | ≥5x CPA | 2-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.
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.
ads-google
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.
ads-tiktok
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.
ads-creative
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.
ads-competitor
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.
ads-landing
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.