🔍 What does this skill do?

The Ads Optimizer Skill turns Claude into an expert in Facebook Ads optimization. It collects metrics for five 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 five time frames 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 detect the skill automatically.

💬 Usage examples

📊 Full analysis
Analyze all active campaigns in the act_XXXXXXX account and provide me with the Health Score for each ad set.
🔥 Ad-eaters
Find the ads that are burning through your budget without generating leads, and pause them.
📈 Scale
Which ad sets have a very good Health Score? Increase their budget by 20%.
📉 Optimize
Reduce the budget for ad sets with a negative Health Score based on 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, and the last 3, 7, and 30 days for a comprehensive view of performance.
✅
Action history Record every optimization performed to avoid repeated rollbacks or conflicting decisions.
✅
Safety Rules Maximum fluctuation 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 logic behind the Health Score and ad-eater detection 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 target CPL, 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.