This skill provides a structured analysis workflow for Meta Ads campaigns, beginning with identifying the correct evaluation level to avoid the Breakdown Effect. It applies domain knowledge on marginal efficiency, learning phase, pacing, and auction overlap to diagnose root causes of underperformance and generate actionable recommendations. The skill enforces standardized metric naming and legal terminology for audience size metrics, making it appropriate for paid media analysts, performance marketing managers, and e-commerce advertising teams who need data-driven reports.
Follow the documented setup, then try a first task.
Installs: Installs the Meta Ads Analyzer skill only. This supports analysis of exported CSV files and screenshots without live Meta API access. · Claude Code
Run from: Claude Code project root
In a terminal, from the Claude Code project root containing the repository's skill/ folder, create the destination and copy the skill files.
# From your Claude Code project root mkdir -p .claude/skills/meta-ads-analyzer cp -r skill/* .claude/skills/meta-ads-analyzer/
Installs: Installs the Meta Ads Analyzer skill and configures the repository's optional MCP server for live campaign data from Meta's Marketing API. · Claude Code
Run from: Claude Code project root
In a terminal, from the Claude Code project root containing the repository's skill/ folder, create the destination and copy the skill files.
# From your Claude Code project root mkdir -p .claude/skills/meta-ads-analyzer cp -r skill/* .claude/skills/meta-ads-analyzer/
Manually create a Business-type Meta App, add the Marketing API product, and note its App ID and App Secret.
In Graph API Explorer, select the app, add ads_read, ads_management, and business_management permissions, then generate and authorize an access token.
In a terminal at the project root, run the interactive setup script. When prompted, enter the Meta access token and App Secret; the App ID is optional.
bash scripts/setup.sh
In a terminal at the project root, copy the MCP configuration template.
cp mcp/mcp.json.example .mcp.json
Manually edit .mcp.json, replacing its placeholders with the actual token and App Secret, then restart Claude Code so the MCP server connects.
Uses meta-ads-analyzer
Use the meta-ads-analyzer skill to analyze the attached Meta Ads Manager data for the last 7 days. Identify the strongest supported performance issue, explain its likely root cause using specific evidence from the data, and provide one actionable, testable recommendation.
Claude