meta-ads-audit — Claude Code skill: audit Meta ad accounts
This skill pulls live data from a Meta ad account and reviews campaign structure, creative fatigue, budget pacing and lead quality.
npx skills add cognyai/claude-code-marketing-skills --skill meta-ads-audit -a claude-codeWhat meta-ads-audit does
The skill talks to your ad account through Cogny's MCP server. It lists ad accounts, then walks campaigns, ad sets and ads, pulling insights for the last 30 days. From there it looks at audience overlap, frequency saturation and demographic breakdown, flags ads with frequency above 3 and weak CTR, and checks custom audience sizes along with pixel health. On B2B accounts Fibbler is wired in, so the report covers lead quality instead of stopping at form fills.
You call it as a slash command with an argument: /meta-ads-audit for the whole thing, /meta-ads-audit audiences, /meta-ads-audit creatives or /meta-ads-audit budget for one section. The same structure and fatigue pass runs against TikTok, Snapchat, Reddit and X accounts connected to the workspace. Each account carries its own currency, so the report keeps one section per platform and never adds spend or leads across them.
A paid Cogny Agent subscription and a connected ad account are required. With no integration in place the skill stops and asks you to connect one. Conversions are counted by each platform's own pixel and attribution window, so treating CPL as the same event across platforms will mislead you.
What it helps with
- map campaign and ad set structure in a Meta account
- spot ads with worn-out creative from frequency and CTR decay
- check audience overlap and frequency saturation
- compare budget spend against the plan for the period
- judge B2B lead quality rather than lead count
Example prompts for the agent
- Run a full audit of my Meta ad account for the last 30 days
- Look at audiences only: overlap, sizes, pixel health
- Go through creatives and show me where fatigue and low CTR are
How to install meta-ads-audit
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill meta-ads-audit -a claude-code2Manually: put the files in place
~/.claude/skills/meta-ads-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/meta-ads-audit/
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill meta-ads-audit -a codex2Manually: put the files in place
.agents/skills/meta-ads-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill meta-ads-audit -a cursor2Manually: put the files in place
.cursor/skills/meta-ads-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cognyai/claude-code-marketing-skills meta-ads-audit2Manually: put the files in place
.github/skills/meta-ads-audit/SKILL.md1Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill meta-ads-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/cognyai/claude-code-marketing-skills --path skill-pipeline/meta-ads-auditManually: put the files in place
.devin/skills/meta-ads-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cognyai/claude-code-marketing-skills --skill meta-ads-audit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about meta-ads-audit
How do I install meta-ads-audit in Claude Code?
Run npx skills add cognyai/claude-code-marketing-skills --skill meta-ads-audit -a claude-code. The skill lands at ~/.claude/skills/meta-ads-audit/SKILL.md.
What does meta-ads-audit do?
It audits a Meta ad account from live data: campaign structure, creative fatigue, budget pacing, audience and pixel health. On B2B accounts it adds lead quality through Fibbler.
Do I need a paid account for this skill?
Yes. A Cogny Agent subscription and an ad account connected through Cogny's MCP server are required. If nothing is connected, the skill asks you to set up an integration first.
