Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add Ad-Superpowers/ad-superpowers-plugin --skill meta-performance-troubleshootergit clone --depth 1 https://github.com/Ad-Superpowers/ad-superpowers-pluginWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/ad-superpowers/ad-superpowers-plugin/meta-performance-troubleshooter)<a href="https://agentmods.dev/skills/ad-superpowers/ad-superpowers-plugin/meta-performance-troubleshooter"><img src="https://agentmods.dev/badge/skills/ad-superpowers/ad-superpowers-plugin/meta-performance-troubleshooter/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/ad-superpowers/ad-superpowers-plugin/meta-performance-troubleshooter"><img src="https://agentmods.dev/badge/skills/ad-superpowers/ad-superpowers-plugin/meta-performance-troubleshooter.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00092 | $0.03515 |
| Opus 5.5 | $0.00037 | $0.01406 |
| Sonnet 5.5 | $0.00018 | $0.00703 |
| Haiku 4.5 | $0.00009 | $0.00351 |
Grade A, and why
meta-performance-troubleshooter scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 478 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Performance Troubleshooter
Diagnostic framework for identifying and resolving Meta Ads performance problems.
Quick Diagnostic
WHAT IS THE PRIMARY SYMPTOM?
│
├─► No or low delivery
│ └─► Go to [Delivery Issues]
│
├─► High CPA / Low ROAS
│ └─► Go to [Efficiency Problems]
│
├─► Low CTR
│ └─► Go to [Engagement Issues]
│
├─► High CPM
│ └─► Go to [Auction Competition]
│
├─► Performance declining over time
│ └─► Go to [Performance Decay]
│
└─► Conversions not tracked
└─► Go to [Tracking Issues]
Diagnostic Framework
Step 1: Check Fundamentals
FUNDAMENTALS CHECKLIST:
□ Pixel firing correctly? (⚠️ UI-only — no API for pixel diagnostics; check Events Manager)
□ CAPI active? (Server events visible?)
□ Event Match Quality? (⚠️ UI-only — EMQ score not available via API; check Events Manager)
□ Attribution window correct? (Match buying cycle)
□ Budget sufficient? (Min €50/day for learning)
□ Audience size adequate? (Min 1M+ for prospecting)
□ Creative variety? (Min 3-5 ads per ad set)
Step 2: Ad Relevance Diagnostics
Meta's 3 ranking metrics at ad level:
| Metric | Meaning | Below Average = |
|---|---|---|
| Quality Ranking | Perceived quality vs competitors | Improve creative/landing page |
| Engagement Rate Ranking | Expected engagement vs competitors | Better hooks, more compelling creative |
| Conversion Rate Ranking | Expected CVR vs competitors | Landing page issues, audience mismatch |
Step 3: Identify Root Cause
Use diagnostic matrix below per symptom.
Delivery Issues
Symptom: No or Very Low Impressions
DIAGNOSE: Why no delivery?
│
├─► Ad Account Issues
│ ├── Account restricted/disabled?
│ ├── Payment method issue?
│ └── Policy violation?
│
├─► Campaign Settings
│ ├── Budget too low?
│ ├── Bid/Cost cap too restrictive?
│ ├── Schedule issues? (Ads not active?)
│ └── Campaign paused?
│
├─► Audience Issues
│ ├── Audience too small? (<50K)
│ ├── Too many exclusions?
│ ├── Geo targeting too narrow?
│ └── Overlap with other campaigns?
│
├─► Ad Issues
│ ├── Ads rejected/in review?
│ ├── Low Quality Ranking?
│ └── Policy flags?
│
└─► Competition Issues
├── Auction outbid?
└── CPM spike in market?
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago First seen · 478 lines · 92 tokens per session scan A 0f60af95ae50
meta-performance-troubleshooter is a skill published in the GitHub repository Ad-Superpowers/ad-superpowers-plugin (5 stars, last pushed 29d ago), licensed MIT. It adds 92 tokens to every session and 3,515 once invoked, about $0.0004 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-11.
Other skills, from other repositories
analytics
Growth analytics authority — GA4 event tracking, conversion funnels, attribution models, cohort analysis, A/B testing, Supabase analytics queries, and revenue reporting patterns.
creative-generate
A workflow for creating advertising images and banners from a strategy brief. It separates the main visual artwork from the accurately typeset text and produces variants for display or social formats.
cro-optimizer
CRO specialist that pulls live analytics data via the Humblytics MCP, analyzes conversion funnels, identifies drop-off points, and generates prioritized A/B test hypotheses. Use when analyzing conversion rates, diagnosing funnel leaks, optimizing signup flows, or creating test roadmaps. Triggers: CRO, conversion rate…
learn
Save a marketing diagnosis insight to the pro-diagnosis knowledge base so it is applied in future operations across all platforms. Use when the user runs /learn, explicitly teaches the agent a marketing insight, corrects the agent's analysis, or asks to remember/record an operational learning for next time. Also use…
lead-form-create
Create a Meta Instant Form (Lead Ad form) through a one-question-at-a-time interview. Use when the user asks to create a lead form, Instant Form, CV form, or similar. The agent collects required parameters via a guided dialogue, confirms, then calls metaadsleadformscreate. Also use when the user asks in Japanese…
ai-hive-simulate-dn-samuel
A research and content-planning workflow that studies DN-Samuel's public material and turns its general methods into original work using your own facts and experience. It can also organise authorised documents into a source-linked reference library.