meta-ads-skill
starsforks
How to install meta-ads-skill?
varnan-tech/opendirectory/meta-ads-skill
$npx -y skills add Varnan-Tech/opendirectory --skill meta-ads-skillUse when interacting with the Meta Ads CLI to manage accounts, campaigns, ads, and insights. Act as an Expert Media Buyer.
SKILL.md
| 1 | # Meta Ads Expert Skill |
| 2 | |
| 3 | **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. |
| 4 | |
| 5 | ## Authentication & Setup |
| 6 | |
| 7 | The Meta Ads CLI uses a **System User Access Token** for authentication. |
| 8 | |
| 9 | ### Environment Variables |
| 10 | Ensure the following environment variables are set in the environment where the CLI is executed: |
| 11 | - `ACCESS_TOKEN`: Your Meta System User Access Token. |
| 12 | - `AD_ACCOUNT_ID`: Your target Ad Account ID (e.g., `act_123456789`). |
| 13 | |
| 14 | **CRITICAL:** NEVER use inline tokens in commands (e.g., `meta ads --token <TOKEN>`). Always rely on environment variables or pre-configured config files. |
| 15 | |
| 16 | ## CLI Routing |
| 17 | |
| 18 | Map your intent to the following `meta-ads` CLI commands: |
| 19 | |
| 20 | | Intent | CLI Command | |
| 21 | |---|---| |
| 22 | | List Ad Accounts | `meta ads account list` | |
| 23 | | List Campaigns | `meta ads campaign list` | |
| 24 | | List Ad Sets | `meta ads adset list` | |
| 25 | | List Ads | `meta ads ad list` | |
| 26 | | Get Insights | `meta ads insights get` | |
| 27 | | Create Campaign | `meta ads campaign create` | |
| 28 | |
| 29 | ## Strict Guardrails |
| 30 | |
| 31 | ### Command Execution |
| 32 | - **JSON Output**: ALWAYS use `--output json` for all read operations to ensure structured data for analysis. |
| 33 | - **No Input**: ALWAYS use `--no-input` (or equivalent) to prevent the Bash tool from hanging on interactive prompts. |
| 34 | - **Creation Safety**: ALWAYS use `--status PAUSED` for all creation commands unless the user explicitly requests an active status. |
| 35 | |
| 36 | ### Date Ranges & Pagination |
| 37 | To prevent context window overflow and API rate limits: |
| 38 | - **Pagination Limits**: When listing items, cap the limit parameter (e.g., `--limit 10`) initially. Only expand if explicitly required. |
| 39 | - **Date Ranges**: For insights, ALWAYS default to `--time-range last_7d`. Do NOT request larger ranges unless instructed by the user. |
| 40 | |
| 41 | ## Safety Guardrails (State-Changing Actions) |
| 42 | |
| 43 | You MUST require explicit user confirmation before executing any state-changing commands (e.g., `campaign create`, `campaign update`). |
| 44 | |
| 45 | 1. Present the exact CLI command and parameters to the user. |
| 46 | 2. Ask for explicit approval. |
| 47 | 3. Only proceed if approved. |
| 48 | |
| 49 | ## Orchestration Workflows |
| 50 | |
| 51 | For complex orchestrations (e.g., CPA spike analysis), see [references/workflows.md](references/workflows.md). |
| 52 | |
| 53 | For reporting standards and output templates, see [references/report_templates.md](references/report_templates.md). |
People who liked this also viewed
6 picksType
- seo-auditWhen the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tagSkillsJul 2026
- copywritingWhen the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user sSkillsJul 2026
- marketing-psychologyWhen the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,'SkillsJul 2026
- content-strategyWhen the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "conSkillsJul 2026
- programmatic-seoWhen the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pSkillsJul 2026
- marketing-ideasWhen the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing stratSkillsJul 2026
