Agent skill · marketing growth · mvanhorn
pp-meta-ads
The first agent-native Meta Ads CLI with local SQLite history and compound queries the live API cannot answer. Trigger phrases: `find creative fatigue on Meta`, `check Facebook ad performance`, `which Meta ads should I retire`, `Meta audience overlap`, `stuck in learning`, `use meta-ads`, `run meta-ads`.
Why this skill is useful
Adds specialized commands for diagnosing Meta Ads performance that are not available in standard APIs or tools.
What it needs
Requires meta-ads-pp-cli installed locally. About 8k tokens when loaded. Last updated 2026-08-06. 1,890 stars on the source repository.
What this skill does
Meta Ads — Printing Press CLI Prerequisites: Install the CLI This skill drives the meta-ads-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first: 1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows: 2. Verify: meta-ads-pp-cli --version 3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill. If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead: If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds. When to Use This CLI Use this CLI when you need creative-fatigue diagnostics, audience overlap cartography, learning-phase forensics, or attribution drift detection across Meta ad accounts. Best when paired with a daily sync into the local store so trend queries are instant. Read-only by design — never used to modify campaigns, budgets, or audiences. Anti-triggers Do not use this CLI for: Do not use this CLI to create, pause, modify, or delete campaigns, adsets, ads, audiences, or creatives — it is read-only. Do not use this CLI for budget management or bid-strategy changes — that is what Meta Ads Manager or facebook-business-sdk are for. Do not use this CLI for write-side audience uploads — custom audience creation from customer files is out of scope. Unique Capabilities These capabilities aren't available in any other tool for this API. Local state that compounds fatigue — Detect ads whose CPM is drifting up, frequency is climbing, and CTR is falling across a configurable window. Use this to decide which ads to retire. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills mvanhorn/meta-ads