🔍 What does this skill do?

The Ads Optimizer Skill turns Claude into an expert in Facebook Ads optimization. It collects metrics for 5 time periods (today, yesterday, 3 days, 7 days, 30 days), calculates a Health Score ranging from -100 to +100 for each ad set, and generates precise recommendations: scale up, reduce the budget, or pause. And if you confirm, it executes the action immediately.

🏥
Health Score
A score ranging from -100 to +100 based on CPL, trends, CTR, CPM, and audience frequency.
🔥
Ad-Eater Detection
Identify ads that are eating up your budget without generating leads, and automatically pause them.
📅
Multi-Period Analysis
Compare performance across 5 time windows to make decisions based on actual trends.
⚡
Automatic Execution
After reviewing the proposed plan, Claude approves the budget changes with a single "yes."

⚙️ How to install

1
Download the ZIP file
Click the download button to get ads-optimizer.zip.
2
Unzip it into your "skills" folder
Extract the contents to Claude's "skills" folder:
~/.claude/skills/ads-optimizer/
3
Set up your account and briefs
Create the necessary configuration files:
~/.claude/ads-agent/config/ad_accounts.md ~/.claude/ads-agent/config/briefs/{nombre}.md
4
Connect the Facebook Ads MCP
This skill requires an MCP with access to the Facebook Ads API to read metrics and make changes.
5
Restart Claude Code or Cowork
Close and reopen the app. Claude will automatically detect the skill.

💬 Usage examples

📊 Complete Analysis
Analyze all active campaigns in the act_XXXXXXX account and give me the Health Score for each ad set.
🔥 Ad-eaters
Find the ads that are burning through your budget without generating leads, and pay for them.
📈 Scale
Which ad sets have a very good Health Score? Scale them up by 20%.
📉 Optimize
Reduce the budget for ad sets with a negative Health Score according to the brief's guidelines.

🛠️ Features

✅
Health Score: 5 Components CPL Gap, Trends, Metrics (CTR/CPM/Frequency), Today Compensation, and Volume Factor.
✅
Multi-period analysis Data from today, yesterday, the last 3 days, 7 days, and 30 days for a comprehensive view of performance.
✅
Action History Record each optimization performed to avoid repeated rollbacks or conflicting decisions.
✅
Safety Rules Maximum exchange rate limits (+30%/-50%), 48-hour Learning Phase protection, and anti-oscillation.
✅
Execution Confirmed Always review the plan before taking action. You decide whether to proceed or make adjustments.

❓ Frequently asked questions

It is currently optimized for Facebook Ads (Meta). The Health Score and ad-eater detection logic is calibrated for Meta Ads metrics.
Yes, but it always shows you the action plan and waits for your confirmation before making any changes. It never acts without your approval.
It is a score ranging from -100 to +100 that summarizes the performance of each ad set. It is calculated based on five components: deviation from the CPL target, seasonal trends, technical diagnostics, adjustment for today's results, and a volume-based confidence factor.
You need an MCP that connects to the Facebook Ads API, with access to read-only functions (insights) and write-only functions (updating budgets, pausing ad sets).
Ads Optimizer

¿Prefieres escuchar el contenido? Genera la narración de audio con un clic.