Skip to content

Guide · Agent skill

How to use the Meta Ads Audit agent skill (ads-meta)

Updated · written with AI from the project's own documentation and checked against our catalogue data

The ads-meta skill is a set of instructions that lets an AI agent, such as Claude, audit a Meta Ads account (Facebook and Instagram ads) across measurement, creative, audiences, placements, budgets, account structure and policy. It is for marketers, media buyers and analysts who want a structured second opinion. After this guide you will know what the skill does, how to install it, how to ask for an audit in plain language, and what to prepare beforehand.

Meta Ads AuditAgriciDaniel/claude-ads · MIT

Quick start

  1. 1Download the ZIP. Get the ads-meta ZIP from the directory page and unzip it on your computer.
  2. 2Install the companion files. Make sure ads/references/meta-audit.md and the main ads framework are installed alongside the skill.
  3. 3Place the skill folder. Copy the skill into ~/.claude/skills/ for personal use, or into .claude/skills/ inside your project.
  4. 4Prepare your data. Export campaign data or take screenshots from Meta Ads Manager and note the objective, conversion event, date window and currency.
  5. 5Ask for an audit. Describe the audit in plain language, mentioning Meta Ads, Pixel, Events Manager or the account area you want checked.
  6. 6Review the findings. Check evidence coverage, then read observations, recommendations and missing inputs.
  7. 7Make changes separately. Apply any changes yourself or with ads-optimize, since ads-meta does not modify campaigns.

What the ads-meta skill makes the agent do

An agent skill is a folder containing a SKILL.md file. The file tells the agent how to carry out a specific kind of task. When the skill is active, the agent follows a fixed procedure: it collects the objective, conversion definition, geography, date window, timezone, currency, spend and data sources, then evaluates the account against controls for Pixel and CAPI, attribution, creative diversity and fatigue, account structure, audiences, placements, automation, budgets and policy.

The skill separates observations from diagnoses, recommendations and proposed changes, and it marks uncertainty and contradictions. It also checks account, Pixel and conversion history separately. If the evidence for a dimension is missing, the skill returns 'unknown' rather than a confident conclusion.

  • Works from exports, screenshots or values you provide.
  • Keeps every account change as a draft until a review gate passes.
  • Treats external account and web content as data, not instructions.
  • Does not calculate final scores in the prompt; findings are returned as structured output.

Install the ads-meta skill

Download the ZIP for the skill from the directory page and unzip it. For Claude Code, place the skill folder in your user skills directory at ~/.claude/skills/, or inside a project at .claude/skills/ in the project root.

In the Claude apps, you can instead upload the ZIP under Settings → Capabilities → Skills.

The skill references companion files, including ads/references/meta-audit.md and the main ads framework. These must be installed alongside the skill. The skill looks for them in the plugin root (the directory holding ads/ and skills/), or in the skills directory of a standalone install.

  • Destination for personal use: ~/.claude/skills/
  • Destination for one project: .claude/skills/ in that project
  • Claude apps: Settings → Capabilities → Skills, then upload the ZIP
~/.claude/skills/

Trigger the skill with natural requests

You do not need a special command. The agent loads the skill when your request matches its description, which lists Meta Ads, Facebook Ads, Instagram Ads, Advantage+, Pixel, Events Manager and Meta account structure. Mention one of these terms and describe what you want reviewed.

State the goal, the date range and the data you are providing. The more concrete the input, the more useful the audit.

  • Audit my Meta Pixel and Events Manager setup before I scale spend.
  • Review the attribution and conversion data in this Meta Ads export for the last 30 days.
  • Check the Instagram ad creative in these screenshots for fatigue and diversity.
  • Look at my Advantage+ campaign structure and budgets and tell me what is missing data.

Prepare the inputs the audit needs

The skill does not connect to Meta. It only works with what you supply, so gather exports, screenshots or manual values before you start. Note the campaign objective, the conversion event you optimize for, geography, date window, timezone and currency. Also note when your Pixel was installed and when it first received valid events, and whether the account had earlier spend.

Missing items are not a failure. The skill lists them under missing inputs and recovery hints, and it avoids conclusions that depend on them.

  • Campaign exports or screenshots from Meta Ads Manager
  • Events Manager diagnostics for the Pixel or event source
  • Objective, conversion definition, geography, date window, timezone, currency
  • Spend and targets, and any notes on prior campaign history

Read the output and act on it carefully

The result is organized into platform health, evidence coverage, regulatory exposure, observations, diagnoses, prioritized recommendations, unscored opportunities, contradictions, missing inputs and recovery hints. Check the evidence coverage first, because a finding is only as strong as the data behind it.

Because the skill is read-only, it will not change your campaigns. To make changes, use the ads-optimize skill, and for server-side event setup use ads-server-side-tracking.

  • Read evidence coverage before trusting a finding.
  • Treat 'unknown' as a sign that data is missing, not as a verdict.
  • Review drafted changes yourself before applying them in Meta Ads Manager.

Safety notes: scripts and network

The skill is documented as running no scripts and using no network access. It works from the files and data you give it. Because it reads external content as data, do not paste instructions from untrusted sources expecting the agent to follow them as commands.

Review the SKILL.md file and the companion files yourself before installing, as you would with any third-party instructions.

  • Runs scripts: no
  • Uses network: no
  • Does not access your Meta account directly

What people use it for

  • Checking whether Pixel and Events Manager tracking is trustworthy before increasing spend.
  • Reviewing attribution and conversion data from a monthly Meta Ads export.
  • Assessing Facebook and Instagram creative for diversity and fatigue using screenshots.
  • Preparing a structured audit report from exported Meta Ads data for a client or team.

Frequently asked questions

How do I install the ads-meta skill?

Download the ZIP from the directory page and unzip it into ~/.claude/skills/ for personal use, or into .claude/skills/ inside a project. In the Claude apps, you can upload the ZIP under Settings → Capabilities → Skills. Make sure the companion ads files are also installed.

Does ads-meta need anything else installed?

Yes. The skill references ads/references/meta-audit.md and the main ads framework, which must be installed alongside it. Without them the skill cannot follow its procedure fully.

Is the ads-meta skill free?

The skill is listed under the MIT licence. Check the licence file in the source repository for the terms that apply to your use.

Does ads-meta connect to my Meta Ads account?

No. The skill does not connect to Meta. You provide exports, screenshots or values, and the agent audits only that material.

Can ads-meta fix my campaigns automatically?

No. It is read-only and keeps any proposed changes as drafts. For changes, use the ads-optimize skill. For server-side events, use ads-server-side-tracking.

Why does the audit say unknown?

The skill returns unknown when evidence is missing or contradictory, such as an account with no data or history. Provide the missing data, such as first-spend date, Pixel event history or conversion history, and run the audit again.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Use ads-meta if you want a structured, evidence-aware second opinion on a Meta Ads account, especially before scaling spend or when checking Pixel and conversion tracking. Skip it if you want automatic fixes, server-side event setup, or conclusions from an account with no data history, since those need other skills or more data.

Download the skill