Agent skill

Meta Ads

Pull, analyze, manage, and CREATE Meta ads (Facebook, Instagram, Messenger, Threads, Click-to-WhatsApp) via the Marketing API.

No licenceAuto-check: notesMarketing & SEO

Install Meta Ads

skills CLI

$ npx skills add hoodini/ai-agents-skills --skill meta-ads -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install hoodini/ai-agents-skills meta-ads --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/hoodini/ai-agents-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/meta-ads .claude/skills/meta-ads && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "meta-ads" agent skill from https://github.com/hoodini/ai-agents-skills/tree/master/skills/meta-ads into .claude/skills/meta-ads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meta-ads", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/hoodini/ai-agents-skills/tree/master/skills/meta-ads

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add hoodini/ai-agents-skills --skill meta-ads -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install hoodini/ai-agents-skills meta-ads --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hoodini/ai-agents-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/meta-ads .agents/skills/meta-ads && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "meta-ads" agent skill from https://github.com/hoodini/ai-agents-skills/tree/master/skills/meta-ads into .agents/skills/meta-ads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meta-ads", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add hoodini/ai-agents-skills --skill meta-ads -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install hoodini/ai-agents-skills meta-ads --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hoodini/ai-agents-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/meta-ads .cursor/skills/meta-ads && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "meta-ads" agent skill from https://github.com/hoodini/ai-agents-skills/tree/master/skills/meta-ads into .cursor/skills/meta-ads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meta-ads", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/hoodini/ai-agents-skills.git --path skills/meta-ads

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add hoodini/ai-agents-skills --skill meta-ads -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install hoodini/ai-agents-skills meta-ads --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hoodini/ai-agents-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/meta-ads .gemini/skills/meta-ads && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "meta-ads" agent skill from https://github.com/hoodini/ai-agents-skills/tree/master/skills/meta-ads into .gemini/skills/meta-ads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meta-ads", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install hoodini/ai-agents-skills meta-ads

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add hoodini/ai-agents-skills --skill meta-ads -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/hoodini/ai-agents-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/meta-ads .github/skills/meta-ads && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "meta-ads" agent skill from https://github.com/hoodini/ai-agents-skills/tree/master/skills/meta-ads into .github/skills/meta-ads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meta-ads", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add hoodini/ai-agents-skills --skill meta-ads -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install hoodini/ai-agents-skills meta-ads --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/hoodini/ai-agents-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/meta-ads .opencode/skills/meta-ads && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "meta-ads" agent skill from https://github.com/hoodini/ai-agents-skills/tree/master/skills/meta-ads into .opencode/skills/meta-ads/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "meta-ads", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: meta-ads
GitHub stars: 282
Token cost: ~4.2k tokens
SKILL.md length: 2,275 words
Files: 22 (incl. scripts, references, assets)
Skills in repo: 32
Repo updated: Jul 11, 2026
First seen: Oct 7, 2026
Licence: None found

At a glance

Pull, analyze, manage, and CREATE Meta ads (Facebook, Instagram, Messenger, Threads, Click-to-WhatsApp) via the Marketing API.

Works in 3 steps: python scripts/auth_check.py — is the… → python scripts/list_accounts.py… → python scripts/list_campaigns.py — once…
The user mentions Meta/FB/IG ads
SKILL.md covers When to consult this skill, Three things to internalize…, The 37-month data wall and Before anything else: check…, plus 8 more sections
Runs Python scripts from its folder; calls python and python3; needs META_ACCESS_TOKEN

What it does

Meta Ads is an agent skill from hoodini/ai-agents-skills. Pull, analyze, manage, and CREATE Meta ads (Facebook, Instagram, Messenger, Threads, Click-to-WhatsApp) via the Marketing API. Use when the user mentions Meta/FB/IG ads, Ads Manager, ROAS, CPA, CPM, CTR, ad spend, campaign or ad set performance, creative fatigue, frequency, CTWA, audience/placement breakdowns, A/B ad tests, or wants to pause an ad, change a budget, duplicate a winner, or launch a new campaign from scratch. Trigger on Hebrew terms like פרסום בפייסבוק/באינסטגרם, פרסומות מטא, ביצועי קמפיין, פרסומות…

Its SKILL.md is about 4.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 24 other files, including scripts, reference files and assets (for example `references/analysis-playbooks.md`, `references/campaign-creation.md` and `references/insights-fields.md`).

It sits in Marketing & SEO, covering Paid advertising. It works with Meta Ads, Instagram, WhatsApp and Python. The repository describes itself as: 🧠 AI Agent Skills Repository - A curated collection of specialized skills for AI coding agents (Claude Code, GitHub Copilot, Cursor, Windsurf). Created by Yuval Avidani using…

When your agent uses it

The user mentions Meta/FB/IG ads
Ad set performance
Creative fatigue
Audience/placement breakdowns

Example prompts

“/meta-ads”

Requirements

Python 3
A credential in META_ACCESS_TOKEN

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

python scripts/auth_check.py — is the token alive, what identity does it resolve to, how many ad accounts does it see?
python scripts/list_accounts.py --with-recent-spend — which accounts are actually running ads right now? (Sorted by last-30-day spend…
python scripts/list_campaigns.py — once you have the right account, what campaigns are on it?

What it can do on your machine

Read from SKILL.md and the folder at commit f7a43d8. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 9 files in scripts/ (Python, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
- python
- python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- META_ACCESS_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Meta Ads loads about 4.2k tokens when it runs, and up to ~22k if it reads all its reference files. Until then it costs about 248 tokens; SKILL.md has 2,275 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~248
When it runs · the whole SKILL.md, loaded when a task matches: ~4.2k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~22k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:48

before moving on.** After they fill in `.env`, run `auth_check.py` immediately. Don't let them run analysis commands un

NoteMentions a .env fileSKILL.md:56

The user puts these in a `.env` file at the working directory or exports them in the shell. Scripts auto-load `.env` if

NoteMentions a .env fileSKILL.md:169

al storage (not everyone's tokens in one .env).

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 2,275 words (~4,247 tokens).

“Pull ad performance data from Meta (Facebook, Instagram, Messenger, Click-to-WhatsApp, Threads), run analyses, and — with explicit confirmation — write changes back (pause, budget change, duplicate, full campaign creation with images and copy).”

— opening of SKILL.md by hoodini

name: meta-ads

Outline of SKILL.md

Meta Ads (Marketing API)
When to consult this skill
Three things to internalize before touching any script
The 37-month data wall
Before anything else: check setup + discover accounts
How to guide a user through setup (first-timers)
Path A vs Path B: which token type?
Workflow: read operations
Workflow: write operations (pause, budget, duplicate)
Workflow: creating a campaign from scratch
When NOT to use create_campaign.py
Gotchas the scripts already handle for you
What the bundled scripts don't handle
Reference files
Scaling beyond personal use

Read the full SKILL.md on GitHub

Files

SKILL.md and 21 other files (scripts, references, assets) in skills/meta-ads of hoodini/ai-agents-skills.

SKILL.md
assets/env.template
references/analysis-playbooks.md
references/campaign-creation.md
references/insights-fields.md
references/setup.md
references/troubleshooting.md
references/write-actions.md
requirements.txt
scripts/anomaly_detect.py
scripts/auth_check.py
scripts/create_campaign.py
scripts/creative_fatigue.py
scripts/duplicate_ad.py
scripts/exchange_token.py
scripts/fetch_insights.py
scripts/list_accounts.py
scripts/list_campaigns.py
… and 4 more

Open the folder on GitHubat commit f7a43d8

Compare with similar skills

Meta Ads next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Meta Ads compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Meta Ads this skillhoodini/ai-agents-skills	282	—	~4.2k	Automated safety check: Notes	None	3 mo ago
Facebook Ads Library Searchbrowser-act/skills	6.1k	—	~2.3k	Automated safety check: Pass	MIT	1 mo ago
Meta Ad Builderkrusemediallc/arcads-claude-code	1.6k	—	~1.7k	Automated safety check: Notes	MIT	17 days ago
Mena Adsgrowthack88/growth-marketing-os	116	—	~2.5k	Automated safety check: Pass	MIT	7 days ago
AdsCesarjoquin/Marketing-Skills	201	1 repos	~3.5k	Automated safety check: Pass	MIT	25 days ago
Adscoreyhaines31/marketingskills	54k	1 repos	~7k	Automated safety check: Pass	MIT	yesterday

Similar skills

Facebook Ads Library Search
browser-act/skills
Searches Meta Ad Library (Facebook/Instagram/WhatsApp ads) by keyword or Facebook page ID and extracts ad details including creatives, copy, CTA, publisher platforms, spend, impressions, reach…
6.1k GitHub stars~2.3k tokensUpdated 1 mo ago
Marketing & SEOAuto-check passed
Meta Ad Builder
krusemediallc/arcads-claude-code
Publish finished creatives as live Meta (Facebook/Instagram) ads via the Meta Marketing API, plus research and ad-copy support.
1.6k GitHub stars~1.7k tokensUpdated 17 days ago
Marketing & SEOAuto-check: notes
Mena Ads
growthack88/growth-marketing-os
MENA Ads Command Center — a complete paid-ads operating system for the Arab world (Egypt, KSA, UAE, GCC, Levant, North Africa) and global accounts.
116 GitHub stars~2.5k tokensUpdated 7 days ago
Marketing & SEOAuto-check passed
Ads
Cesarjoquin/Marketing-Skills
When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.
201 GitHub starsUsed in 1 repo~3.5k tokens
Marketing & SEOAuto-check passed
Ads
coreyhaines31/marketingskills
When the user wants help with paid advertising campaigns on Google Ads, Meta (Facebook/Instagram), LinkedIn, Twitter/X, or other ad platforms.
54k GitHub starsUsed in 1 repo~7k tokens
Marketing & SEOAuto-check passed
Meta Ads Connect
LeoYeAI/openclaw-marketing-skills
Connect to Meta Marketing API to pull real Facebook and Instagram ad data — campaign performance, creative fatigue, audience saturation, ROAS by ad set, frequency analysis, and Learning Phase status.
1k GitHub starsUsed in 1 repo~2k tokens
Marketing & SEOAuto-check passed

Questions about Meta Ads

What does Meta Ads do?

Pull, analyze, manage, and CREATE Meta ads (Facebook, Instagram, Messenger, Threads, Click-to-WhatsApp) via the Marketing API. Meta Ads is an agent skill from hoodini/ai-agents-skills. Pull, analyze, manage, and CREATE Meta ads (Facebook, Instagram, Messenger, Threads, Click-to-WhatsApp) via the Marketing API.

When should I use Meta Ads?

Meta Ads fits situations like: the user mentions Meta/FB/IG ads; ad set performance; creative fatigue; audience/placement breakdowns.

How do I install Meta Ads in Claude Code?

Run `npx skills add hoodini/ai-agents-skills --skill meta-ads -a claude-code`. Or copy the skill folder (skills/meta-ads in hoodini/ai-agents-skills) into .claude/skills/meta-ads in your project. Claude Code loads it when a task matches its description.

How do I install Meta Ads in Codex?

Run `npx skills add hoodini/ai-agents-skills --skill meta-ads -a codex`. Or copy the skill folder (skills/meta-ads in hoodini/ai-agents-skills) into .agents/skills/meta-ads in your project. Codex loads it when a task matches its description.

Can I use Meta Ads in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hoodini/ai-agents-skills --skill meta-ads -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/meta-ads, .gemini/skills/meta-ads, .github/skills/meta-ads and .opencode/skills/meta-ads in your project.

What does Meta Ads need to run?

Going by SKILL.md and its folder, Meta Ads needs Python for the scripts in its folder, the command-line tools its instructions call (python and python3) and credentials named META_ACCESS_TOKEN. Our summary lists: Python 3; A credential in META_ACCESS_TOKEN.

Does Meta Ads access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Meta Ads safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Meta Ads use?

No licence was found for Meta Ads or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Meta Ads use?

About 4.2k tokens (SKILL.md is roughly 17k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 18k tokens, read only when the agent opens those files.

What are the alternatives to Meta Ads?

Skills that share tags, products or a category with Meta Ads: Facebook Ads Library Search (browser-act/skills, 6.1k stars), Meta Ad Builder (krusemediallc/arcads-claude-code, 1.6k stars), Mena Ads (growthack88/growth-marketing-os, 116 stars) and Ads (Cesarjoquin/Marketing-Skills, 201 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Meta Ads?

hoodini (a GitHub user) maintains it in hoodini/ai-agents-skills, which has 282 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on July 11, 2026.

Source: hoodini/ai-agents-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Meta Ads

Install Meta Ads

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

Facebook Ads Library Search

Meta Ad Builder

Mena Ads

Ads

Ads

Meta Ads Connect

More from hoodini/ai-agents-skills

Parallax Scroll-Scrub Landing Page

Yuv Viral Video

YUV Video Director

Video To Landing Page

Mermaid Diagrams

Yuv Reel Covers

Questions about Meta Ads

Install Meta Ads

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

More from hoodini/ai-agents-skills

Related

Questions about Meta Ads