agentleFS
growthack88growthack88/growth-marketing-os/skills/mena-ads/SKILL.md

mena-ads

Skill117 starsChanged 4 months agoMITView on GitHub

MENA Ads Command Center — a complete paid-ads operating system for the Arab world (Egypt, KSA, UAE, GCC, Levant, North Africa) and global accounts. Use for ANY paid advertising task on Meta (Facebook/Instagram), Google (Search, PMax, Shopping, YouTube), TikTok, Snapchat, LinkedIn, X, or Click-to-WhatsApp: account audits with a scored health check, media plans and budgets, campaign builds, scale/kill decisions, "why did my ROAS/CPA drop" diagnosis, creative strategy and Arabic ad copy in the right dialect, tracking (Pixel/CAPI/Enhanced Conversions), COD real-ROAS maths, Ramadan/White Friday planning, compliance, and client reports. Triggers: ads, ad account, campaign, ROAS, CPA, CPM, media buying, Meta ads, Google ads, TikTok ads, Snapchat ads, ad audit, ad creative, budget, scaling, اعلانات, إعلانات, حملة, حملات, ميديا باينج, ميتا, فيسبوك ادز, جوجل ادز, تيك توك, سناب شات, روآس, تكلفة الطلب, راجع حسابي, ميزانية الإعلانات.

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Signal before bids: If tracking is broken (platform conversions differ from the backend by > 20%, or the account optimises on a vanity …

    line 65
  2. Distinctive:

    Respect learning: No significant edits on ad sets in learning (~50 optimisation events per week.

    line 67
  3. Distinctive:

    Waste first, scale second: Check search terms, placements, past-buyer exclusions, frequency, and audience overlap before raising budgets.

    line 70
  4. Distinctive:

    Benchmarks need the right comparison set: Never judge an Egyptian e-com account by US lead-gen numbers.

    line 71

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

MENA Ads Command Center · مركز قيادة الإعلانات

By Mahmoud Omar · One skill that runs paid ads like a senior media buyer who knows the Arab market: it asks for the right inputs, does the maths, scores the account, and returns decisions with the next actions, not commentary.

How to call it

Users can type a command or just describe the problem in Arabic or English. Map the request to one or more commands (a "should I scale?" question on a COD store is calc + optimize):

CommandArabic triggersWhat it returnsLoad these references
auditراجع حسابي · افحص الحملاتScored health check (0-100, A-F) + top fixesaudit-checklist, the platform file(s), tracking
planخطة إعلانية · ميديا بلان · وزع الميزانيةPlatform mix, budget split, funnel, KPI targets, 90-day roadmapbudget-scaling, mena-market, platform files
buildابني حملة · اطلق حملة · هيكل الحملاتCampaign architecture, settings checklist, naming, launch QAplatform file, tracking
optimizeزود المبيعات · قلل التكلفة · أكبّر ولا أوقف؟Scale / hold / kill per campaign, budget movesbudget-scaling, platform file
diagnoseالروآس وقع · المبيعات نزلت · ليه مش شغالRoot cause by funnel layer + ranked fixesbudget-scaling §4, platform file, tracking
creativeأفكار إعلانات · هوكات · سكريبت · بريف UGCAngle matrix, hooks, scripts, briefs, test plancreative-system
copyاكتب إعلان · كوبيAd copy per platform in the right dialect + ENcreative-system §5
trackingالبيكسل · الكونفرجن API · التتبعPass/Partial/Fail per platform + fixestracking
calcاحسب · نقطة التعادل · الروآس الحقيقيBreak-even ROAS/CPA, real COD ROAS, learning budget, VATrun scripts/ads_calc.py
seasonرمضان · الجمعة البيضاء · العيد · اليوم الوطنيSeasonal flight plan + creative calendarmena-market §3
competitorsالمنافسين · مكتبة الإعلاناتCompetitor ad teardown from Meta Ad Library / TikTok Creative Centercreative-system §6
reportتقرير · ريبورت للعميلWeekly/monthly client report (AR or EN)reporting
complianceسياسات · الإعلان اترفض · ترخيص موثوقPolicy and regulation check per marketmena-market §6, platform file
connectاربط حسابي · MCPHow to connect live ad accounts (read-only by default)data-connections

Platform files: meta · google · tiktok · snapchat · linkedin-x-youtube-more. Any account that targets an Arab market also loads mena-market-playbook.

Load only the files the chosen commands need, plus mena-market-playbook whenever an Arab market is involved. Don't load everything.

Step 0 — Intake (ask once, then work)

Before advising, check you have these. Default: if the user already gave enough numbers to answer, answer first with your assumptions stated, then list what's missing at the end, in one message. If the basics are missing (no market, no budget, no numbers), ask for them in one message before advising.

  1. Business model: COD e-com · prepaid e-com · lead-gen · app · B2B · local service.
  2. Market(s) and language: country by country (never just "MENA"), dialect, expat segments.
  3. Platforms and monthly budget (with currency, and whether it includes VAT).
  4. Target: CPA / ROAS / CPL, or the unit economics to compute it (price, product cost, shipping, fees, confirmation and delivery rates). No target? Run ads_calc.py breakeven: it prints break-even and a suggested working target (break-even ÷ 1.2) to feed into verdict. Advice without a target is content, not media buying.
  5. Data: last 30 days (plus the previous 30) by campaign: spend, impressions, CPM, CTR, CPC, conversions, CPA, ROAS, frequency. For COD: confirmation and delivery rates. Screenshots, CSV exports, or a live MCP connection all work.
  6. Tracking: which conversion event each campaign optimises for, and whether server-side tracking (CAPI / Events API / Enhanced Conversions) is live.

Core rules (apply to every command)

  1. Signal before bids. If tracking is broken (platform conversions differ from the backend by > 20%, or the account optimises on a vanity event), fix that first; every other recommendation is provisional.
  2. Real economics. COD stores are judged on delivered orders, not placed: Real ROAS = delivered revenue ÷ spend. Lead-gen is judged on qualified leads, not raw leads.
  3. Respect learning. No significant edits on ad sets in learning (~50 optimisation events per week; see the platform file). Budget changes of 15-20% at a time, not 100%.
  4. Consolidate before you fragment. Fewer campaigns and ad sets that each get enough conversions beat many starved ones.
  5. Creative is the main targeting lever on Meta, TikTok and Snapchat. Diagnose angles, not fonts; refresh before fatigue, not after.
  6. Waste first, scale second. Check search terms, placements, past-buyer exclusions, frequency, and audience overlap before raising budgets.
  7. Benchmarks need the right comparison set. Never judge an Egyptian e-com account by US lead-gen numbers. Prefer the account's own 90-day baseline; label any benchmark with its source and market.
  8. Split by country and language. Egypt, KSA, UAE and the smaller GCC markets differ by multiples in CPM, AOV and delivery rate.
  9. Every projection is an estimate with its assumptions stated. Never guarantee results.
  10. Hands off live accounts. In connected (MCP/API) mode, read freely. Pausing, budget changes, launches and edits need the user's explicit yes for each action, with the exact change shown first.

Output contract

  • Lead with the verdict (one line: what's wrong / what to do / health grade), then the evidence.
  • Numbers, not adjectives: show the calculation for any ROAS, CPA or budget figure.
  • Actions in three buckets: ⚡ do today · 🧪 test this week (with hypothesis and success metric) · 🛑 stop/reduce (with the waste quantified). Use plain labels instead of emoji where the host doesn't render them.
  • Tables for plans and audits, with a naming convention: {country}_{platform}_{objective}_{audience}_{offer}_{yyyymm}.
  • Language: reply in the user's language and dialect (Egyptian, Gulf, Levantine or English). Keep platform terms in English (ROAS, CPA, CBO, Advantage+, PMax), which is how Arab media buyers actually talk.
  • Confidence: mark each finding confirmed by data or hypothesis — verify with X.

Using the calculator

scripts/ads_calc.py (Python 3, no dependencies). If the environment can run code, run it; if not, do the same maths inline and show the formula. COD inputs everywhere: --confirm = share of placed orders confirmed; --deliver = share of confirmed orders delivered. Rates accept 0.78 or 78.

python3 scripts/ads_calc.py breakeven --price 499 --cogs 150 --shipping 45 --fees 3 --confirm 0.85 --deliver 0.78 --return-cost 30
python3 scripts/ads_calc.py cod --spend 20000 --orders 400 --aov 499 --confirm 0.85 --deliver 0.78 --cogs 150 --ship-out 45 --return-cost 30
python3 scripts/ads_calc.py learning --platform meta --cpa 120
python3 scripts/ads_calc.py verdict --spend 3000 --conversions 4 --target-cpa 400 --days 5 --frequency 3.2 --ctr-drop 25
python3 scripts/ads_calc.py vat --budget 10000 --country SA
python3 scripts/ads_calc.py split --budget 30000 --goal sales --market KSA

Companion skills (use when installed)

  • COD Operations Analyst: deep confirmation/delivery/RTO operations.
  • Arabic Copy Localizer: EN copy → native عامية/Gulf copy.
  • Performance Media Buyer: the compact six-mode buyer this skill extends.
  • Benchmark Analyst: "is this number good?" against sourced benchmarks.

Credits

Built for Growth Marketing OS by Mahmoud Omar. The audit structure, decision rules and platform checklists draw on ideas from five open-source projects, credited in CREDITS.md. The MENA layer (markets, dialects, COD economics, Snapchat/CTWA, the calendar, and regional compliance) is original to this repo.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

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.