Agent skill

Meta Ads Expert

by Varnan-Tech in Varnan-Tech/opendirectory

A skill your agent uses when interacting with the Meta Ads CLI to manage accounts, campaigns, ads, and insights.

MITAuto-check passedMarketing & SEO

Install Meta Ads Expert

skills CLI
$ npx skills add Varnan-Tech/opendirectory --skill meta-ads-expert -a claude-code

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

GitHub CLI
$ gh skill install Varnan-Tech/opendirectory meta-ads-expert --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/Varnan-Tech/opendirectory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/meta-ads-skill/meta-ads-skill .claude/skills/meta-ads-expert && 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/

Facts

Skill name
meta-ads-expert
GitHub stars
674
Token cost
~649 tokens
SKILL.md length
319 words
Files
3 (incl. references)
Skills in repo
61
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when interacting with the Meta Ads CLI to manage accounts, campaigns, ads, and insights.

  • Works in 3 steps: Present the exact CLI command and… → Ask for explicit approval. → Only proceed if approved.
  • Interacting with the Meta Ads CLI to manage accounts
  • SKILL.md covers Authentication & Setup, CLI Routing, Strict Guardrails and Safety Guardrails…, plus 1 more section
  • Needs ACCESS_TOKEN

What it does

Meta Ads Expert is an agent skill from Varnan-Tech/opendirectory. Use when interacting with the Meta Ads CLI to manage accounts, campaigns, ads, and insights. Act as an Expert Media Buyer.

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/report_templates.md` and `references/workflows.md`).

It sits in Marketing & SEO, covering Paid advertising. It works with Meta Ads. The repository describes itself as: AI Agent Skills built for Founders who hate Marketing. The licence is MIT.

When your agent uses it

  • Interacting with the Meta Ads CLI to manage accounts
  • Tasks that involve Paid advertising

Example prompts

  • “/meta-ads-expert”

Requirements

  • A credential in ACCESS_TOKEN

Workflow steps

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

  1. Present the exact CLI command and parameters to the user.
  2. Ask for explicit approval.
  3. Only proceed if approved.

What it can do on your machine

Read from SKILL.md and the folder at commit 62e437a. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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:

    • ACCESS_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Meta Ads Expert loads about 649 tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 35 tokens; SKILL.md has 319 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Varnan-Tech/opendirectory at commit 62e437a, republished under its MIT licence (© Varnan-Tech). 319 words, ~649 tokens.

Download SKILL.mdSave it as .claude/skills/meta-ads-expert/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
meta-ads-expert
description
Use when interacting with the Meta Ads CLI to manage accounts, campaigns, ads, and insights. Act as an Expert Media Buyer.

Meta Ads Expert Skill

Persona: You are an Expert Media Buyer. This skill acts as a router, providing high-level instructions and linking to detailed references for interacting with the Meta Ads API via the meta-ads CLI.

Authentication & Setup

The Meta Ads CLI uses a System User Access Token for authentication.

Environment Variables

Ensure the following environment variables are set in the environment where the CLI is executed:

  • ACCESS_TOKEN: Your Meta System User Access Token.
  • AD_ACCOUNT_ID: Your target Ad Account ID (e.g., act_123456789).

CRITICAL: NEVER use inline tokens in commands (e.g., meta ads --token <TOKEN>). Always rely on environment variables or pre-configured config files.

CLI Routing

Map your intent to the following meta-ads CLI commands:

IntentCLI Command
List Ad Accountsmeta ads account list
List Campaignsmeta ads campaign list
List Ad Setsmeta ads adset list
List Adsmeta ads ad list
Get Insightsmeta ads insights get
Create Campaignmeta ads campaign create

Strict Guardrails

Command Execution
  • JSON Output: ALWAYS use --output json for all read operations to ensure structured data for analysis.
  • No Input: ALWAYS use --no-input (or equivalent) to prevent the Bash tool from hanging on interactive prompts.
  • Creation Safety: ALWAYS use --status PAUSED for all creation commands unless the user explicitly requests an active status.
Date Ranges & Pagination

To prevent context window overflow and API rate limits:

  • Pagination Limits: When listing items, cap the limit parameter (e.g., --limit 10) initially. Only expand if explicitly required.
  • Date Ranges: For insights, ALWAYS default to --time-range last_7d. Do NOT request larger ranges unless instructed by the user.

Safety Guardrails (State-Changing Actions)

You MUST require explicit user confirmation before executing any state-changing commands (e.g., campaign create, campaign update).

  1. Present the exact CLI command and parameters to the user.
  2. Ask for explicit approval.
  3. Only proceed if approved.

Orchestration Workflows

For complex orchestrations (e.g., CPA spike analysis), see references/workflows.md.

For reporting standards and output templates, see references/report_templates.md.

© Varnan-Tech, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/meta-ads-skill/meta-ads-skill of Varnan-Tech/opendirectory.

  • SKILL.md
  • references/report_templates.md
  • references/workflows.md

Open the folder on GitHubat commit 62e437a

Compare with similar skills

Meta Ads Expert 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 Expert compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Meta Ads Expert this skillVarnan-Tech/opendirectory674—~649Automated safety check: PassMIT
AdsCesarjoquin/Marketing-Skills2011 repos~3.5kAutomated safety check: PassMIT
Adscoreyhaines31/marketingskills54k1 repos~7kAutomated safety check: PassMIT
Money Adsiamzifei/show-me-the-money1k—~2.4kAutomated safety check: PassCustom licence
Meta Ad Builderkrusemediallc/arcads-claude-code1.6k—~1.7kAutomated safety check: NotesMIT
Mena Adsgrowthack88/growth-marketing-os116—~2.5kAutomated safety check: PassMIT

Similar skills

  • 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
  • Money Ads

    iamzifei/show-me-the-money

    Paid advertising automation for Google Ads, Meta Ads, and other ad platforms.

    1k GitHub stars~2.4k 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 16 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 6 days ago
    Marketing & SEOAuto-check passed
  • Bundles Meta's official Pixel and Conversions API documentation so tracking changes, event deduplication and conversion events are checked against the real spec.

    350 GitHub stars~1.8k tokensUpdated 3 days ago
    Marketing & SEOAuto-check passed

More from Varnan-Tech/opendirectory

All 61 skills in this repo
  • Graphic Ebook

    Varnan-Tech/opendirectory

    Creates professionally designed B2B SaaS e-books in HTML + CSS, exported as print-ready PDF.

    674 GitHub stars~5k tokensUpdated 1 mo ago
    Auto-check passed
  • Docs From Code

    Varnan-Tech/opendirectory

    Generates and updates README.md and API reference docs by reading your codebase's functions, routes, types, schemas, and architecture.

    674 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Graphic Chart

    Varnan-Tech/opendirectory

    Generates data visualization charts (bar, line, area, pie, doughnut, scatter, radar, treemap) as PNG using Apache ECharts v6.

    674 GitHub stars~2.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Graphic Gif

    Varnan-Tech/opendirectory

    Creates animated looping GIFs from CSS animations (default) or AI image-to-video.

    674 GitHub stars~3k tokensUpdated 1 mo ago
    Auto-check passed
  • Map Your Market

    Varnan-Tech/opendirectory

    Given a product description, category keywords, or competitor names (any combination), searches Reddit, Hacker News, GitHub Issues, G2, and Google Trends for the real pains your market experiences…

    674 GitHub stars~4.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Newsletter Digest

    Varnan-Tech/opendirectory

    Aggregates RSS feeds from the past week, synthesizes the top stories using Gemini, and publishes a newsletter digest to Ghost CMS.

    674 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Meta Ads Expert

What does Meta Ads Expert do?

A skill your agent uses when interacting with the Meta Ads CLI to manage accounts, campaigns, ads, and insights. Meta Ads Expert is an agent skill from Varnan-Tech/opendirectory. Use when interacting with the Meta Ads CLI to manage accounts, campaigns, ads, and insights.

When should I use Meta Ads Expert?

Meta Ads Expert fits situations like: interacting with the Meta Ads CLI to manage accounts; tasks that involve Paid advertising.

How do I install Meta Ads Expert in Claude Code?

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

How do I install Meta Ads Expert in Codex?

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

Can I use Meta Ads Expert 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 Varnan-Tech/opendirectory --skill meta-ads-expert -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-expert, .gemini/skills/meta-ads-expert, .github/skills/meta-ads-expert and .opencode/skills/meta-ads-expert in your project.

What does Meta Ads Expert need to run?

Going by SKILL.md and its folder, Meta Ads Expert needs credentials named ACCESS_TOKEN. Our summary lists: A credential in ACCESS_TOKEN.

Does Meta Ads Expert 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 Expert safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Meta Ads Expert use?

Meta Ads Expert is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Meta Ads Expert use?

About 649 tokens (SKILL.md is roughly 2.6k 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 1.2k tokens, read only when the agent opens those files.

What are the alternatives to Meta Ads Expert?

Skills that share tags, products or a category with Meta Ads Expert: Ads (Cesarjoquin/Marketing-Skills, 201 stars), Ads (coreyhaines31/marketingskills, 54k stars), Money Ads (iamzifei/show-me-the-money, 1k stars) and Meta Ad Builder (krusemediallc/arcads-claude-code, 1.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Meta Ads Expert?

Varnan-Tech (a GitHub organization) maintains it in Varnan-Tech/opendirectory, which has 674 GitHub stars. The repository holds 61 skills in this directory. The repository was last updated on August 16, 2026.

Source: Varnan-Tech/opendirectory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.