meta-ads
Skill331 starsChanged 7 months agoMITView on GitHub
Meta Ads management and reporting — daily checks, campaign performance, creative fatigue, bleeders, winners. Uses a local adapter over Meta Ads CLI in mock/read-only/live-approved modes.
- Reads credentials
27 other projects use a version of this.
Adopted by
Most recently taken up by
- jaydubya818/ClaudeClaw-Mission-Controltheir own version, first seen Nov 8, 2026
- webrenew/skillstheir own version, first seen Nov 1, 2026
- brainbytes-dev/everything-claude-marketingtheir own version, first seen Nov 1, 2026
- astDeniss/business-skillstheir own version, first seen Nov 1, 2026
- hoodini/ai-agents-skillstheir own version, first seen Oct 25, 2026
- F0rger123/claude-meta-ads-god-modetheir own version, first seen Oct 25, 2026
Used with
Projects with it also use google-ads, tiktok-ads and 5 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
webrenewSkillgoogle-ads
Plan, build, audit or run Google Ads search campaigns for a local service business (plumber, dentist, roofer, cleaner, lawyer, clinic) on a small budget, with the agent drafting and the owner approving every change that spends money. Use this skill for a new Google Ads account or campaign, keyword research from customer questions, match types, negative keywords, location targeting, responsive search ads and assets, landing page message match, conversion tracking from GA4 or the Google Ads tag, budgets and bidding, Local Services Ads, a weekly check, and when the user says "PPC", "Google Ads is not working", "too expensive per lead", "wasted ad spend", "search terms" or "should we run Google ads".
Also in 12 projects that use this
hyperfx-aiSkilltiktok-ads
Plan and create TikTok advertising campaigns end-to-end via the Hyper MCP, with strict parameter validation for objective-specific requirements. Use when the user wants to launch TikTok ads, set up TikTok traffic or reach campaigns, configure conversions or app-promotion campaigns, upload TikTok video creatives, or analyze TikTok ad performance. Also triggers on tiktok marketing, tiktok campaign, tiktok ppc, or tiktok ads manager.
Also in 4 projects that use this
brainbytes-devSkilllinkedin-ads
LinkedIn advertising strategy for B2B lead generation, brand awareness, and recruitment. Use when running LinkedIn ad campaigns.
Also in 4 projects that use this
refly-aiSkillgoogle-analytics
Integrate with Google Analytics for web metrics. Use when you need to: (1) retrieve website analytics reports, (2) track traffic and user metrics, or (3) analyze web performance data.
Also in 3 projects that use this
huiferSkilllocal-seo
本地 SEO 分析和优化专家。自动检测项目是否需要本地 SEO,分析 NAP(Name, Address, Phone)一致性、本地关键词优化、Google Business Profile (GBP) 优化和本地结构化数据生成。提供本地商家搜索引擎排名优化建议,包括 NAP 标准化、本地关键词策略、GBP 完整性检查、评论策略、地图嵌入和本地 SEO 审计。
Also in 3 projects that use this
indranilbanerjeeSkillkeyword-research
Research keywords via the connected data source: intent, gaps. Grouping → keyword-cluster. \"what keywords should we target\"
Also in 3 projects that use this
Other versions27 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 27
- nowork-studio/toprank★ 4.1ksame name
- nowork-studio/notfair-plugin★ 4.1ksame name
- bighadj22/codflow★ 360same name
- hoodini/ai-agents-skills★ 295same name
- ivangfalco/ads-skills★ 267same name
- hyperfx-ai/marketing-skills★ 112same name
- boringmarketer/kimi-first★ 47same name
- boringmarketer/meta-ads-skill★ 37same name
- sepivip/meta-ads-skill★ 14same name
- brainbytes-dev/everything-claude-marketing★ 9same name
17 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository6 other files it gives its agents.
- AGENTS.mdAGENTS.md
- ad-copy-generatorSkill
- ad-creative-monitorSkill
- ad-uploadSkill
- budget-optimizerSkill
- pixel-capiSkill
The file
We split this skill into the rules it gives an agent
12 rules. 0 are common, 5 are distinctive, and 7 are very specific to this project.
0
Common
Most of the 21 edited versions we read keep these.
5
Distinctive
This author's own choices. Worth a look.
7
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 15
Stop clicking through Ads Manager.
- Very specific: line 21
Read workspace/brand/ per the _vibe-system protocol
- Distinctive: line 23
Follow all output formatting rules from the _vibe-system output format
- Very specific: line 58
Use official Ads CLI variables: ACCESS_TOKEN, AD_ACCOUNT_ID, and optionally BUSINESS_ID.
- Distinctive: line 176
Safety: All mutating actions are high-risk and require confirmation.
- Distinctive: line 193
Ask follow-up questions if needed
- Distinctive: line 205
When the user asks about Meta ads, Facebook ads, Instagram ads, or campaign performance:
- Very specific: line 207
Check workspace/brand/stack.md for stored ad account ID
- Very specific: line 208
Check AD_ACCOUNT_ID / META_AD_ACCOUNT env vars
- Very specific: line 209
If neither, run ./scripts/meta-kit.sh doctor.
- Very specific: line 210
Run the appropriate ./run.sh report
- Distinctive: line 218
When running daily-check, frame the output around these questions:
“Common” is measured: kept by at least 6 in 10 of the 21 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Meta Ads — Your AI Ad Manager
Stop clicking through Ads Manager. This skill uses ./run.sh + ./scripts/meta-kit.sh to give you the five things that actually matter about your Meta campaigns — in plain text, every day.
The thesis: 90% of ad management is pattern recognition. Spend trending up or down. CTR declining (creative fatigue). CPA spiking (audience exhaustion). Winners emerging. Losers bleeding.
This skill spots the patterns. You make the calls.
Read workspace/brand/ per the _vibe-system protocol
Follow all output formatting rules from the _vibe-system output format
Brand Memory Integration
Reads: stack.md, creative-kit.md, audience.md, learnings.md (all optional)
| File | What it provides | How it shapes output |
workspace/brand/stack.md | Stored ad account ID, target CPA/ROAS | Auto-fills account, benchmarks performance against targets |
workspace/brand/creative-kit.md | Brand creative guidelines, assets | Context for creative recommendations |
workspace/brand/audience.md | Target audience profiles | Interprets audience performance data |
workspace/brand/learnings.md | Past performance patterns | Spots recurring issues — "this happened last month too" |
Writes
| File | What it contains |
workspace/brand/stack.md | Stores ad account ID on first use |
workspace/brand/learnings.md | Appends performance findings, fatigue patterns, winning creative traits |
Setup (One Time)
1. Configure local adapter mode
cp .env.example .env
META_KIT_MODE=mock ./scripts/meta-kit.sh doctor2. Set account/token in .env for non-mock runs
Use official Ads CLI variables: ACCESS_TOKEN, AD_ACCOUNT_ID, and optionally BUSINESS_ID. The kit still accepts META_AD_ACCOUNT / META_SYSTEM_USER_ACCESS_TOKEN aliases for backwards compatibility. Keep secrets out of git.
Reports
The 5 Daily Questions ← Start Here
The core of the system. Five questions that replace 20 minutes of Ads Manager clicking:
- Am I on track? — Today's spend vs expectations
- What's running? — Active campaigns at a glance
- How's performance? — 7-day metrics by campaign
- Who's winning/losing? — Ad-level performance sorted
- Any fatigue? — CTR trends, frequency, CPC movement
Tell me: "Daily ads check"
Or: "Run the 5 questions on my ads"
Or: "How are my Meta ads doing?"Script: ./run.sh daily-check
Overview
Account-level summary with campaign breakdown.
Tell me: "Meta ads overview for last 30 days"Script: ./run.sh overview --preset last_30d
Campaigns
List campaigns, optionally filtered by status.
Tell me: "Show me active campaigns"Script: ./run.sh campaigns --status ACTIVE
Top Creatives
Ad-level performance ranked by results.
Tell me: "What are my best performing ads?"Script: ./run.sh winners --preset last_7d
Bleeders 🩸
Ads with high spend but poor performance — candidates for pause. Flags ads with CTR < 1% or frequency > 3.5.
Tell me: "Any ads bleeding money?"
Or: "Find underperforming ads"Script: ./run.sh bleeders --preset last_7d
Winners 🏆
Top performing ads by CTR and efficiency. These are your scale candidates.
Tell me: "Which ads should I scale?"
Or: "Show me the winners"Script: ./run.sh winners --preset last_7d
Fatigue Check 😴
Daily breakdown to spot creative fatigue — CTR declining day-over-day, frequency climbing, CPC rising.
Tell me: "Any creative fatigue?"
Or: "Check for ad fatigue"Script: ./run.sh fatigue
Custom
Full control. Specify level, fields, breakdowns.
Tell me: "Show me ad performance broken down by age and gender"Script: meta --output json --no-input ads insights get --breakdown age --breakdown gender --fields spend,impressions,ctr,cpc once read-only CLI auth is configured.
Date Presets
today— Today onlyyesterday— Yesterday onlylast_7d— Last 7 days (default for most reports)last_30d— Last 30 dayslast_90d— Last 90 days
Actions (Use With Care)
Beyond reporting, official Ads CLI can create/update/delete resources. In this kit, mutating actions are blocked unless they go through dry-run + explicit approval.
Prepare an ad create dry run
META_KIT_MODE=mock ./scripts/meta-kit.sh create-ad --payload examples/create-ad.json --dry-runSafety: All mutating actions are high-risk and require confirmation. The skill should ALWAYS present findings and recommendations first, write a dry-run artifact for proposed changes, then ask for explicit approval before any live action.
The AI Ad Manager Workflow
This is the system from the newsletter. Here's how it works in practice:
Morning (automated via cron):
- Run daily-check
- Flag bleeders (CTR < 1%, frequency > 3.5, CPA > threshold)
- Flag winners (top CTR, low CPC, scaling headroom)
- Send summary to Telegram/Slack
You (2 minutes over coffee):
- Read the summary
- Approve/reject recommendations
- Ask follow-up questions if needed
The AI (on approval):
- Generates exact dry-run artifacts for confirmed changes
- Requires
META_KIT_MODE=live-approved+META_KIT_APPROVAL_IDbefore live mutation - Keeps new creates PAUSED-only
- Logs decisions to learnings.md
Invocation
When the user asks about Meta ads, Facebook ads, Instagram ads, or campaign performance:
- Check
workspace/brand/stack.mdfor stored ad account ID - Check
AD_ACCOUNT_ID/META_AD_ACCOUNTenv vars - If neither, run
./scripts/meta-kit.sh doctor; after auth,meta ads adaccount listcan list accounts - Run the appropriate
./run.shreport - Interpret results in context of brand goals (from stack.md/learnings.md)
- For bleeders/winners, present clear recommendations with reasoning
- Never take action without explicit user approval
- Log findings to
workspace/brand/learnings.md
The 5 Daily Questions (Detailed)
When running daily-check, frame the output around these questions:
- "Am I on track?" — Compare today's spend rate to daily budget. If pacing high or low, flag it.
- "What's running?" — List active campaigns with status. Flag any that should be off.
- "How's the last 7 days?" — Campaign-level metrics. Compare to previous 7 if available.
- "Who's winning and who's losing?" — Ad-level sort. Top 3 winners, bottom 3 losers with specific metrics.
- "Any fatigue signals?" — Frequency trends, CTR day-over-day, CPC movement. Concrete numbers, not vibes.
Next Up
/ga4-report— See what Meta traffic actually does on your site. Pair with ads data to find true ROAS./gsc-report— Cross-reference paid vs organic. Are you paying for traffic you'd get free?/creative— Generate new ad creatives when fatigue hits. Feed winning patterns into new concepts./direct-response-copy— Write ad copy based on what's actually converting.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

