diagnose-performance
Skill1 starsChanged 3 days agoMITView on GitHub
Find out why Meta or Google Ads results changed. Use when the user says results dropped, CPA or cost per result went up, ROAS fell, spend stopped, "what happened to my ads", "why is it worse this week", or asks for a health check of a Meta (Facebook/Instagram) or Google Ads account through AdChat.
1 other project uses a version of this.
Adopted by
Most recently taken up by
- gomarble-ai/marketing-agenttheir own version, first seen Oct 8, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- gomarble-ai/marketing-agent★ 15same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository8 other files it gives its agents.
- build-audiencesSkill
- creative-analysisSkill
- cut-wasted-spendSkill
- google-search-cleanupSkill
- launch-campaignSkill
- safe-changesSkill
- scale-winnersSkill
- weekly-reportSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 24
Look at spend, results, cost per result, CTR, CPM (Meta) or CPC (Google).
- Very specific: line 59
Read-only until the user picks a fix.
- Distinctive: line 60
Don't call a change a trend on fewer than 3 days of data or a handful of conversions.
- Distinctive: line 64
Don't recommend raising budget to fix a drop you haven't explained.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Diagnose performance
Goal: find the one or two real reasons results changed, backed by numbers, and suggest the smallest fix. Most "my ads stopped working" cases are one of: delivery stopped, tracking broke, the creative tired out, the audience got too small or too expensive, or the comparison is unfair (a holiday, a sale, too few days of data).
Steps
- Context first.
get_account_briefingfor the account's goals, target CPA or ROAS and notes. If the user has no target, ask what a good result costs them. - Pick the account.
meta_list_accounts(orgoogle_get_accounts). Work in one account at a time. - Confirm the change is real. Compare two equal windows, for example the last 7
days against the 7 before.
- Meta:
meta_insightsatlevel: accountwithtime_increment: 1(daily) over 14 to 28 days. - Google:
google_get_insightswithbreakdown: date. Look at spend, results, cost per result, CTR, CPM (Meta) or CPC (Google). Small numbers (under ~20 conversions a week) swing a lot: say so.
- Meta:
- Find where it moved. Drill down one level at a time, sorted by spend:
- Meta:
meta_insightsatlevel: campaign, thenadset, thenad. - Google:
google_listwithlevel: campaigns, thenad_groups,keywords. Usually one campaign or ad set explains most of the change.
- Meta:
- Check the usual causes, in this order:
- Delivery:
meta_diagnosewithkind: delivery_issues(disapproved ads, learning limited, budget or billing problems). Google:google_listwithlevel: adsfor disapprovals and status. - Tracking:
meta_diagnosewithkind: pixel_health. A sudden drop to near zero conversions with steady clicks is usually tracking, not ads. - Creative fatigue: frequency above ~3 to 4 in prospecting with CTR falling
week over week. See the
creative-analysisskill. - Cost pressure: CPM up with CTR flat means the auction got pricier (seasonality, competition), not that the ads got worse.
- Breakdowns:
meta_insightswithbreakdownssuch asage,publisher_platform,platform_positionorcountryto spot one segment eating budget. Google:google_get_insightswithbreakdown: deviceornetwork. - Recent edits:
get_change_history(Meta) orgoogle_get_change_history. A budget jump or targeting edit often resets learning.
- Delivery:
- Check money, if connected.
get_true_profitcompares Meta spend with real revenue; it can show that a "worse" ROAS is actually fine, or the reverse. - Open alerts.
get_alertsmay already describe the problem and a suggested fix.
What to show the user
- One sentence answer first: "Cost per purchase rose from $18 to $27, mostly because ad set Broad US lost its best ad to a disapproval on Tuesday."
- A small table: the before/after window for the 3 to 5 numbers that matter.
- The cause, with the evidence, and how sure you are.
- One to three fixes, smallest first. Name what each will change.
Guardrails
- Read-only until the user picks a fix. Fixes go through the
safe-changesflow. - Don't call a change a trend on fewer than 3 days of data or a handful of conversions.
- Meta and Google count conversions differently; don't add them up as if equal.
- Meta budgets are in cents; insights spend is in currency units. Google amounts are in currency units.
- Don't recommend raising budget to fix a drop you haven't explained.
Example prompt
"My Facebook cost per lead doubled this week. What happened?"
Briefing → account-level daily insights for 14 days → campaign and ad set level →
meta_diagnose delivery issues → frequency and CTR by ad → change history. Answer:
"One ad set's frequency hit 5.2 and CTR halved; the others are steady. Pause its two
oldest ads and add fresh creative. Want me to pause them?"
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

