Meta Campaign Optimizer

Meta ads optimization

by gmmh1 · MIT license

Meta ads optimization cover

Improve a live, underperforming Meta Ads campaign. Triggers on 'optimize my Meta Ads', 'why is my Facebook CPA/ROAS bad', 'my Meta campaign is stuck in learning', 'CPM is rising', or 'my Meta ads are fatigued'.

---
name: meta-ads-optimization
description: "Improve a live, underperforming Meta Ads campaign. Triggers on 'optimize my Meta Ads', 'why is my Facebook CPA/ROAS bad', 'my Meta campaign is stuck in learning', 'CPM is rising', or 'my Meta ads are fatigued'. Works on existing campaigns with performance data — for a new campaign use meta-ads-campaign-builder, for a full health check use meta-ads-audit."
---

# Meta Ads Optimization

> **Currency & scope note (last reviewed 2026-07-19):** Platform mechanics referenced here (character limits, campaign-type names, feature availability, thresholds, benchmark figures, policy specifics) reflect general practice as of the review date above and are **not guaranteed current** — ad platforms change quickly. Verify anything mechanical against the platform's live documentation before relying on it for a real launch, real spend, or a compliance-sensitive decision. This is an independent, unofficial resource, not affiliated with or endorsed by any platform named in it, and nothing here is legal, tax, or financial advice.

## Purpose
Diagnose and fix underperformance in a live Meta campaign using its actual performance data — CPM, CTR, CPA/ROAS, frequency, and the Learning Phase status that governs whether the algorithm even has stable footing yet.

## Trigger Conditions
- "Optimize my Meta/Facebook Ads campaign"
- "Why is my CPA/ROAS bad"
- "My campaign is stuck in Learning Phase"
- "CPM is rising / my ads are fatigued"

Overview

Improve a live, underperforming Meta Ads campaign. Triggers on 'optimize my Meta Ads', 'why is my Facebook CPA/ROAS bad', 'my Meta campaign is stuck in learning', 'CPM is rising', or 'my Meta ads are fatigued'. Works on existing campaigns with performance data — for a new campaign use meta-ads-campaign-builder, for a full health check use meta-ads-audit.

What you get

  • Root cause diagnosis with supporting data
  • Learning Phase status and whether recent edits are a contributing factor
  • Prioritized fix list
  • Placement/demographic breakdown findings
  • Expected evaluation timeframe before re-judging results
Manual install (npx, ZIP)
Claude Codenpx skills add gmmh1/claude-paid-media-skills --skill meta-ads-optimization -g -a claude-code
Claude Code (degit)npx degit gmmh1/claude-paid-media-skills/skills/meta-ads-optimization#main ~/.claude/skills/meta-ads-optimization
Claude.ai / desktopZip the folder and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md6.1 KB
Read SKILL.md here
gmmh1/main1 file shown
SKILL.md
Show the full text73 lines

Meta Ads Optimization

Currency & scope note (last reviewed 2026-07-19): Platform mechanics referenced here (character limits, campaign-type names, feature availability, thresholds, benchmark figures, policy specifics) reflect general practice as of the review date above and are not guaranteed current — ad platforms change quickly. Verify anything mechanical against the platform's live documentation before relying on it for a real launch, real spend, or a compliance-sensitive decision. This is an independent, unofficial resource, not affiliated with or endorsed by any platform named in it, and nothing here is legal, tax, or financial advice.

Purpose

Diagnose and fix underperformance in a live Meta campaign using its actual performance data — CPM, CTR, CPA/ROAS, frequency, and the Learning Phase status that governs whether the algorithm even has stable footing yet.

Trigger Conditions

  • "Optimize my Meta/Facebook Ads campaign"
  • "Why is my CPA/ROAS bad"
  • "My campaign is stuck in Learning Phase"
  • "CPM is rising / my ads are fatigued"

Required Inputs

  • Campaign performance data (CPM, CTR, CPA/ROAS, frequency, Learning Phase status) for the relevant window
  • Recent account changes (new creative, audience/budget edits, objective changes) — frequent ad set edits reset the Learning Phase, a common self-inflicted cause of instability
  • The specific symptom driving the request

Core Capabilities

Learning Phase Diagnosis
  • Ad sets need roughly 50 optimization events within a 7-day window to exit Learning Phase efficiently — thin-budget or thin-conversion accounts get stuck here, with unstable, expensive delivery as the visible symptom
  • Significant edits (budget, audience, creative) reset Learning Phase — diagnosing "my campaign got worse" often traces back to an edit that reset learning rather than a genuine performance decline
  • Fix options: consolidate ad sets to concentrate conversion volume, extend the evaluation window before judging results, or accept a broader Advantage+ audience to reach the volume threshold faster
Frequency & Creative Fatigue
  • Rising frequency with declining CTR/rising CPM on a stable audience signals creative fatigue — the fix is new creative variants, not more budget or bid adjustments
  • Distinguishing fatigue (was working, now declining) from a fundamentally weak angle (never worked) — the former needs refresh, the latter needs a new angle from meta-ads-creative-strategy
Cost Metric Diagnosis
  • Rising CPM: broader market/seasonal auction pressure (less controllable) vs. narrow/overlapping audience competing against itself (fixable via meta-ads-audience-targeting)
  • Low CTR: creative/hook weakness, or audience-creative mismatch
  • High CPA despite decent CTR: landing page/offer/checkout friction, or a conversion event mismatched to actual purchase intent (e.g., optimizing toward AddToCart when Purchase is the real goal)
Budget & Bid Strategy
  • Diagnosing budget-limited vs. delivery-limited campaigns
  • Advantage Campaign Budget reallocation behavior — understanding that Meta will naturally shift spend toward the best-performing ad set, which can starve a legitimately promising but newer ad set before it gets a fair evaluation window
Audience & Placement Breakdown
  • Performance breakdowns by placement (Feed vs. Reels vs. Stories vs. Audience Network) and demographic to localize where spend is/isn't working
  • Excluding consistently poor placements rather than letting Advantage+ placements continue serving them uniformly, when a clear pattern exists

Workflow

  1. Get the specific symptom and pull performance data plus Learning Phase status.
  2. Check for recent account edits that may have reset learning before assuming a genuine performance decline.
  3. Diagnose root cause: Learning Phase instability, creative fatigue, audience overlap/saturation, or landing page/offer friction.
  4. Segment performance by placement/demographic to localize the issue.
  5. Recommend the specific fix, routing to meta-ads-creative-strategy (fatigue/weak angle), meta-ads-audience-targeting (overlap/saturation), or landing page work as appropriate.
  6. Set a realistic evaluation window before judging the fix — Learning Phase and algorithm re-stabilization both take time.

Outputs

  • Root cause diagnosis with supporting data
  • Learning Phase status and whether recent edits are a contributing factor
  • Prioritized fix list
  • Placement/demographic breakdown findings
  • Expected evaluation timeframe before re-judging results

Rules

  • Never diagnose "the campaign got worse" without first checking for a recent edit that reset Learning Phase.

  • Distinguish creative fatigue from a fundamentally weak angle before recommending a fix — they need different responses.

  • Don't recommend frequent ad set edits as a troubleshooting tactic; each edit risks resetting learning and compounding instability.

  • Always check conversion event alignment (optimizing toward the actual purchase-intent event, not a proxy) before concluding the audience/creative is the problem.

  • Verification gate: before this skill's output is used to spend real money, submit a compliance-sensitive claim, or go to a client as final, verify the mechanical specifics (limits, thresholds, policy rules) against current platform documentation and get explicit human sign-off — do not treat this skill's output as launch-ready without that check.

meta-ads-audit (broader health check when there's no specific symptom yet), meta-ads-creative-strategy and meta-ads-video-reels (fatigue/weak-angle fixes), meta-ads-audience-targeting (overlap/saturation fixes), meta-ads-pixel-capi (if tracking itself is suspect), meta-ads-creative-analytics (deeper creative performance data).

1---
2name: meta-ads-optimization
3description: "Improve a live, underperforming Meta Ads campaign. Triggers on 'optimize my Meta Ads', 'why is my Facebook CPA/ROAS bad', 'my Meta campaign is stuck in learning', 'CPM is rising', or 'my Meta ads are fatigued'. Works on existing campaigns with performance data — for a new campaign use meta-ads-campaign-builder, for a full health check use meta-ads-audit."
4---
5 
6# Meta Ads Optimization
7 
8> **Currency & scope note (last reviewed 2026-07-19):** Platform mechanics referenced here (character limits, campaign-type names, feature availability, thresholds, benchmark figures, policy specifics) reflect general practice as of the review date above and are **not guaranteed current** — ad platforms change quickly. Verify anything mechanical against the platform's live documentation before relying on it for a real launch, real spend, or a compliance-sensitive decision. This is an independent, unofficial resource, not affiliated with or endorsed by any platform named in it, and nothing here is legal, tax, or financial advice.
9 
10## Purpose
11Diagnose and fix underperformance in a live Meta campaign using its actual performance data — CPM, CTR, CPA/ROAS, frequency, and the Learning Phase status that governs whether the algorithm even has stable footing yet.
12 
13## Trigger Conditions
14- "Optimize my Meta/Facebook Ads campaign"
15- "Why is my CPA/ROAS bad"
16- "My campaign is stuck in Learning Phase"
17- "CPM is rising / my ads are fatigued"
18 
19## Required Inputs
20- Campaign performance data (CPM, CTR, CPA/ROAS, frequency, Learning Phase status) for the relevant window
21- Recent account changes (new creative, audience/budget edits, objective changes) — frequent ad set edits reset the Learning Phase, a common self-inflicted cause of instability
22- The specific symptom driving the request
23 
24## Core Capabilities
25 
26### Learning Phase Diagnosis
27- Ad sets need roughly 50 optimization events within a 7-day window to exit Learning Phase efficiently — thin-budget or thin-conversion accounts get stuck here, with unstable, expensive delivery as the visible symptom
28- Significant edits (budget, audience, creative) reset Learning Phase — diagnosing "my campaign got worse" often traces back to an edit that reset learning rather than a genuine performance decline
29- Fix options: consolidate ad sets to concentrate conversion volume, extend the evaluation window before judging results, or accept a broader Advantage+ audience to reach the volume threshold faster
30 
31### Frequency & Creative Fatigue
32- Rising frequency with declining CTR/rising CPM on a stable audience signals creative fatigue — the fix is new creative variants, not more budget or bid adjustments
33- Distinguishing fatigue (was working, now declining) from a fundamentally weak angle (never worked) — the former needs refresh, the latter needs a new angle from `meta-ads-creative-strategy`
34 
35### Cost Metric Diagnosis
36- Rising CPM: broader market/seasonal auction pressure (less controllable) vs. narrow/overlapping audience competing against itself (fixable via `meta-ads-audience-targeting`)
37- Low CTR: creative/hook weakness, or audience-creative mismatch
38- High CPA despite decent CTR: landing page/offer/checkout friction, or a conversion event mismatched to actual purchase intent (e.g., optimizing toward AddToCart when Purchase is the real goal)
39 
40### Budget & Bid Strategy
41- Diagnosing budget-limited vs. delivery-limited campaigns
42- Advantage Campaign Budget reallocation behavior — understanding that Meta will naturally shift spend toward the best-performing ad set, which can starve a legitimately promising but newer ad set before it gets a fair evaluation window
43 
44### Audience & Placement Breakdown
45- Performance breakdowns by placement (Feed vs. Reels vs. Stories vs. Audience Network) and demographic to localize where spend is/isn't working
46- Excluding consistently poor placements rather than letting Advantage+ placements continue serving them uniformly, when a clear pattern exists
47 
48## Workflow
491. Get the specific symptom and pull performance data plus Learning Phase status.
502. Check for recent account edits that may have reset learning before assuming a genuine performance decline.
513. Diagnose root cause: Learning Phase instability, creative fatigue, audience overlap/saturation, or landing page/offer friction.
524. Segment performance by placement/demographic to localize the issue.
535. Recommend the specific fix, routing to `meta-ads-creative-strategy` (fatigue/weak angle), `meta-ads-audience-targeting` (overlap/saturation), or landing page work as appropriate.
546. Set a realistic evaluation window before judging the fix — Learning Phase and algorithm re-stabilization both take time.
55 
56## Outputs
57- Root cause diagnosis with supporting data
58- Learning Phase status and whether recent edits are a contributing factor
59- Prioritized fix list
60- Placement/demographic breakdown findings
61- Expected evaluation timeframe before re-judging results
62 
63## Rules
64- Never diagnose "the campaign got worse" without first checking for a recent edit that reset Learning Phase.
65- Distinguish creative fatigue from a fundamentally weak angle before recommending a fix — they need different responses.
66- Don't recommend frequent ad set edits as a troubleshooting tactic; each edit risks resetting learning and compounding instability.
67- Always check conversion event alignment (optimizing toward the actual purchase-intent event, not a proxy) before concluding the audience/creative is the problem.
68 
69- **Verification gate:** before this skill's output is used to spend real money, submit a compliance-sensitive claim, or go to a client as final, verify the mechanical specifics (limits, thresholds, policy rules) against current platform documentation and get explicit human sign-off — do not treat this skill's output as launch-ready without that check.
70 
71## Related Skills
72`meta-ads-audit` (broader health check when there's no specific symptom yet), `meta-ads-creative-strategy` and `meta-ads-video-reels` (fatigue/weak-angle fixes), `meta-ads-audience-targeting` (overlap/saturation fixes), `meta-ads-pixel-capi` (if tracking itself is suspect), `meta-ads-creative-analytics` (deeper creative performance data).
73 
View all files on GitHub →

Details

License
MIT
Stars on the repo
★ 0
Checked
Source
gmmh1/claude-paid-media-skills ↗
Creator
gmmh1 · 39 listings
View creator

Similar skills

See all →
SkillAd Creative Generatorcoreyhaines31/marketingskills · by coreyhaines31When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform. Also use when the user mentions 'ad copy variations,' 'ad creative,' 'generate headlines,' 'RSA headlines,' 'bulk ad copy,' 'ad iterations,' 'creative testing,' 'write me some ads,' 'Facebook ad copy,' 'Google ad headlines,' 'LinkedIn ad text,' 'static ads,' 'ad templates,' 'iMessage ad,' 'chat reveal ad,' 'ChatGPT ad,' 'Apple Notes ad,' 'AirDrop ad,' 'creative strategy,' 'creative roadmap,' 'creative retro,' 'hook writing,' 'creative review page,' 'present ad creative for approval,' 'motion video ad,' 'faceless video ad,' 'UGC ad,' 'greenscreen ad,' 'TikTok/Reels ad format,' 'which ad format to make,' 'Meta ad format tier list,' or 'creative format taxonomy.' Use this whenever someone needs to produce ad copy at scale or iterate on existing ads. For campaign strategy and targeting, see ads. For landing page copy, see copywriting.★ 51.1k GitHub starsSkillAmazon Ads AuditorAgriciDaniel/claude-ads · by AgriciDanielYou share your Amazon advertising numbers and goals; you get back a plain-language review of what's draining your budget and what to change first.★ 9.5k GitHub starsSkillApple Search Ads AuditorAgriciDaniel/claude-ads · by AgriciDanielPaste what you're spending on Apple Search Ads and your recent numbers; get back a plain review of what's wasting money and what to fix first.★ 9.5k GitHub starsSkillAmazon Ads Optimizernowork-studio/notfair-plugin · by nowork-studioPlan and review Amazon Ads with margin-aware ACoS, product, and search-term guardrails. Use for Amazon advertising, Sponsored Products, Sponsored Brands, Sponsored Display, ASIN targeting, Amazon ACoS, or Amazon Ads performance exports.★ 3.9k GitHub starsSkillAd Campaign Generatorzubair-trabzada/ai-marketing-claude · by zubair-trabzadaYou are the advertising engine for /market ads <url>. You generate complete ad campaigns across platforms with full copy variations,…★ 2.7k GitHub starsSkillLinkedIn Ads Managerivangfalco/ads-skills · by ivangfalcoLinkedIn Ads management skill for B2B SaaS campaigns. Routes to specialized sub-skills for campaign planning, performance analysis, account audits, and account management. MANDATORY TRIGGERS: LinkedIn Ads, LinkedIn campaign, LinkedIn advertising, B2B ads, paid social, LinkedIn paid, ad account, campaign manager, LinkedIn lead gen, LinkedIn retargeting, ad audit, ad performance, ad optimization, campaign plan, media plan, LinkedIn budget★ 275 GitHub stars

More from gmmh1

SkillCross-Platform Voice Adaptergmmh1/claude-paid-media-skills · by gmmh1Adapt one core brand voice coherently across every ad platform's native register — professional on LinkedIn, native/casual on TikTok, conversational on Meta, direct on Google Search. Triggers on 'does this still sound like us', 'adapt our brand voice for TikTok', 'keep our voice consistent across ad platforms', or 'this ad doesn't sound on-brand'. Cross-platform consistency layer feeding every platform's copywriting skill.New listingSkillAd Creative Refresh Plannergmmh1/claude-paid-media-skills · by gmmh1Detect creative fatigue signals and plan refresh cadence across any advertising platform. Triggers on 'my ad performance is declining', 'creative fatigue', 'when should I refresh my ads', or 'frequency is rising and results are dropping'. Platform-agnostic fatigue detection — platform-specific optimization skills apply this with their own metrics and typical fatigue timelines.New listingSkillAd Performance Analyzergmmh1/claude-paid-media-skills · by gmmh1Diagnose why a specific ad creative is winning or losing using the generalized hook-hold-click-convert funnel, applicable across any platform. Triggers on 'why is this ad underperforming', 'diagnose my creative', or 'where in the funnel is this ad failing'. Platform-agnostic diagnostic framework — platform-specific versions (meta-ads-creative-analytics) apply this with platform-native metrics.New listingSkillProduct Ad Creative Systemgmmh1/claude-paid-media-skills · by gmmh1Build product-forward creative patterns reusable across ad platforms — product hero shots, lifestyle imagery, comparison/demo formats, and catalog-scale creative systems. Triggers on 'ecommerce ad creative', 'product photography for ads', 'creative system for my catalog', or 'how should I show this product across platforms'. Cross-platform ecommerce creative patterns feeding platform-specific execution.New listingSkillAI Max Search Configgmmh1/claude-paid-media-skills · by gmmh1Configure AI Max for Search — Google's AI-powered enhancement layer on Search campaigns adding broader query matching, AI-generated text customization, and final URL expansion. Triggers on 'set up AI Max for Search', 'should I turn on AI Max', 'AI Max text customization', or 'AI Max brand controls'. Sits on top of an existing Search campaign built via google-ads-campaign-builder — it's a feature layer, not a standalone campaign type.New listingSkillApp Campaign Buildergmmh1/claude-paid-media-skills · by gmmh1Build App campaigns for install and in-app action goals across Search, Display, YouTube, Discover, and Google Play. Triggers on 'set up an App campaign', 'get more app installs', 'app engagement campaign', or 'App campaigns for engagement'. Fully automated app-promotion format — distinct from web-focused campaign types.New listing