skill

Name: skill
Author: mathiaschu

398stars59forks

How to install skill?

mathiaschu/meta-ads-analyzer/skill

$npx -y skills add mathiaschu/meta-ads-analyzer --skill skill

Installs into the current project.

Summary

Provides expert-level analysis and diagnosis for Meta Ads campaigns. Use this skill to interpret performance data, identify root causes of issues, and generate actionable recommendations, with a special focus on correctly handling the 'Breakdown Effect'. Use when the user mention

Files · 1

View on GitHub

SKILL.md

1	# Meta Ads Analysis & Diagnosis Skill
2
3	## When to Use This Skill
4
5	Use this skill when you need to analyze and diagnose Meta Ads campaign performance, including:
6	- Interpreting campaign, ad set, or ad-level performance data
7	- Identifying root causes of performance issues
8	- Generating actionable optimization recommendations
9	- Understanding why Meta's system makes certain budget allocation decisions
10	- Analyzing CSV exports, screenshots, or raw data from Meta Ads Manager
11
12	## Result Recommendations (MANDATORY for Final Reports)
13
14	> IMPORTANT: The following rules are MANDATORY and MUST be strictly followed when writing the final analysis report. These are not optional guidelines — they define the required standards for all deliverables.
15
16	- NEVER recommend pausing or reducing budget for any segment based solely on higher average CPA/CPM in breakdown reports. Higher average cost does NOT mean poor performance — it often reflects the system capturing low marginal cost opportunities earlier. Removing segments may increase overall costs. Always frame changes as testable hypotheses, not directives.
17	- *ALWAYS justify recommendations with data evidence, Meta's system mechanics, and expected impact on overall campaign performance.*
18	- EVERY insight must include data evidence and explanation. Every recommendation must be actionable and verifiable.
19	- ALIGN WITH OFFICIAL RECOMMENDATIONS. Check `get_recommendations` API first. If diverging, explicitly acknowledge and explain why.
20	- Disambiguate clicks. Never use the term "clicks" alone. Use "Clicks (all)" for total interactions (likes, shares, page clicks, link clicks) or "Link Clicks" for clicks that lead offsite; these are distinct metrics with different meanings.
21	- Audience size: When reporting reach or audience size, use "Accounts Center accounts" or the number without unit — never "people" — per legal requirements.
22
23	## Metric Naming Guidelines
24
25	IMPORTANT: Always rename metric names to standardized, non-sensitive names exactly as specified below in all responses:
26
27	\| Raw Metric Name \| Standardized Display Name \|
28	\| :--- \| :--- \|
29	\| `impressions` \| Impressions \|
30	\| `video_thruplay_watched_actions` \| ThruPlays \|
31	\| `clicks` \| Clicks (all) \|
32	\| `purchase_roas` \| Purchase ROAS (return on ad spend) \|
33	\| `cpm` \| CPM \|
34	\| `cpc` \| CPC (all) \|
35	\| `ctr` \| CTR (all) \|
36	\| `cost_per_action_type:link_click` \| CPC (Link Click) \|
37	\| `outbound_clicks_ctr` \| Outbound CTR \|
38	\| `cost_per_action_type:purchase` \| Cost per Purchase \|
39	\| `actions:purchase` \| Purchases \|
40	\| `action_values:purchase` \| Purchase Value \|
41	\| `frequency` \| Frequency \|
42	\| `reach` \| Reach (Accounts Center accounts) \|
43	\| `spend` \| Amount Spent \|
44
45	## Core Principles
46
47	- Holistic First: Evaluate at aggregate level before drilling down. The system optimizes for the whole, not the parts.
48	- Dynamic over Static: Analyze performance over time, not single snapshots.
49	- Marginal over Average: The system prioritizes marginal CPA (cost of the next result), not average CPA. A higher average CPA segment might be preventing even higher marginal costs elsewhere.
50
51	## Meta Ads Domain Knowledge
52
53	### Legal Requirements & Terminology
54
55	- Audience Size Metrics: Due to legal requirements, when referring to audience size metrics (the total number of accounts that view the ad), you must use "Accounts Center accounts" (case insensitive) or report the metric without any unit instead of "people".
56	- "People" Usage: When "people" is used in contexts referring to audience size, replace with "Accounts Center accounts". When a specific number is used with "people" (e.g., "17,000 people"), use "person" after the number (e.g., "17,000 person").
57
58	### Campaign & Performance Definitions
59
60	- Conversion Ads: Ad entities with objectives like Lead, Sales, or App Promotions are categorized as conversion ads.
61	- Conversion Rate: Conversion rate = conversions / impressions.
62	- Performance Indicators: Lower Cost Per Result or CPM = higher performance. Higher ROAS = higher performance.
63
64	### Account & Asset Issues
65
66	- Disabled or Restricted Account: Occurs when assets (FB account, IG account, ad account, page, payout account) have been disabled or restricted by Meta, usually due to policy violations.
67
68	### Budget & Billing
69
70	- Daily Spending Limit (DSL): The current daily spending limit that advertisers can check, increase, or decrease.
71	- Billing Threshold (Payment Threshold): The amount of ad spend that triggers a payment method charge

People who liked this also viewed

6 picks

Type

skill

398stars59forks

View on GitHub

How to install skill?

mathiaschu/meta-ads-analyzer/skill

$npx -y skills add mathiaschu/meta-ads-analyzer --skill skill

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Meta Ads Analysis & Diagnosis Skill
2
3	## When to Use This Skill
4
5	Use this skill when you need to analyze and diagnose Meta Ads campaign performance, including:
6	- Interpreting campaign, ad set, or ad-level performance data
7	- Identifying root causes of performance issues
8	- Generating actionable optimization recommendations
9	- Understanding why Meta's system makes certain budget allocation decisions
10	- Analyzing CSV exports, screenshots, or raw data from Meta Ads Manager
11
12	## Result Recommendations (MANDATORY for Final Reports)
13
14	> IMPORTANT: The following rules are MANDATORY and MUST be strictly followed when writing the final analysis report. These are not optional guidelines — they define the required standards for all deliverables.
15
16	- NEVER recommend pausing or reducing budget for any segment based solely on higher average CPA/CPM in breakdown reports. Higher average cost does NOT mean poor performance — it often reflects the system capturing low marginal cost opportunities earlier. Removing segments may increase overall costs. Always frame changes as testable hypotheses, not directives.
17	- *ALWAYS justify recommendations with data evidence, Meta's system mechanics, and expected impact on overall campaign performance.*
18	- EVERY insight must include data evidence and explanation. Every recommendation must be actionable and verifiable.
19	- ALIGN WITH OFFICIAL RECOMMENDATIONS. Check `get_recommendations` API first. If diverging, explicitly acknowledge and explain why.
20	- Disambiguate clicks. Never use the term "clicks" alone. Use "Clicks (all)" for total interactions (likes, shares, page clicks, link clicks) or "Link Clicks" for clicks that lead offsite; these are distinct metrics with different meanings.
21	- Audience size: When reporting reach or audience size, use "Accounts Center accounts" or the number without unit — never "people" — per legal requirements.
22
23	## Metric Naming Guidelines
24
25	IMPORTANT: Always rename metric names to standardized, non-sensitive names exactly as specified below in all responses:
26
27	\| Raw Metric Name \| Standardized Display Name \|
28	\| :--- \| :--- \|
29	\| `impressions` \| Impressions \|
30	\| `video_thruplay_watched_actions` \| ThruPlays \|
31	\| `clicks` \| Clicks (all) \|
32	\| `purchase_roas` \| Purchase ROAS (return on ad spend) \|
33	\| `cpm` \| CPM \|
34	\| `cpc` \| CPC (all) \|
35	\| `ctr` \| CTR (all) \|
36	\| `cost_per_action_type:link_click` \| CPC (Link Click) \|
37	\| `outbound_clicks_ctr` \| Outbound CTR \|
38	\| `cost_per_action_type:purchase` \| Cost per Purchase \|
39	\| `actions:purchase` \| Purchases \|
40	\| `action_values:purchase` \| Purchase Value \|
41	\| `frequency` \| Frequency \|
42	\| `reach` \| Reach (Accounts Center accounts) \|
43	\| `spend` \| Amount Spent \|
44
45	## Core Principles
46
47	- Holistic First: Evaluate at aggregate level before drilling down. The system optimizes for the whole, not the parts.
48	- Dynamic over Static: Analyze performance over time, not single snapshots.
49	- Marginal over Average: The system prioritizes marginal CPA (cost of the next result), not average CPA. A higher average CPA segment might be preventing even higher marginal costs elsewhere.
50
51	## Meta Ads Domain Knowledge
52
53	### Legal Requirements & Terminology
54
55	- Audience Size Metrics: Due to legal requirements, when referring to audience size metrics (the total number of accounts that view the ad), you must use "Accounts Center accounts" (case insensitive) or report the metric without any unit instead of "people".
56	- "People" Usage: When "people" is used in contexts referring to audience size, replace with "Accounts Center accounts". When a specific number is used with "people" (e.g., "17,000 people"), use "person" after the number (e.g., "17,000 person").
57
58	### Campaign & Performance Definitions
59
60	- Conversion Ads: Ad entities with objectives like Lead, Sales, or App Promotions are categorized as conversion ads.
61	- Conversion Rate: Conversion rate = conversions / impressions.
62	- Performance Indicators: Lower Cost Per Result or CPM = higher performance. Higher ROAS = higher performance.
63
64	### Account & Asset Issues
65
66	- Disabled or Restricted Account: Occurs when assets (FB account, IG account, ad account, page, payout account) have been disabled or restricted by Meta, usually due to policy violations.
67
68	### Budget & Billing
69
70	- Daily Spending Limit (DSL): The current daily spending limit that advertisers can check, increase, or decrease.
71	- Billing Threshold (Payment Threshold): The amount of ad spend that triggers a payment method charge

People who liked this also viewed

6 picks

Type