Flyweel Team · The Ad Performance Analyser is a free, open-source SKILL.md that transforms raw advertising data into strategic analysis using senior media buying frameworks. It works with any data source (CSV exports, API responses, screenshots, or MCP-connected platforms) and runs inside your AI agent of choice.
The SKILL.md covers 7 scenario playbooks and benchmarks across 4 major ad platforms (Google Ads, Meta, LinkedIn, TikTok), applying the same analytical rigour a senior media buyer would bring to a performance review.
Auto-detect your agent and install:
npx @flyweel/skill install ad-performance-analyser-flyweelInstall for a specific agent:
npx @flyweel/skill install ad-performance-analyser-flyweel --agent=cursor
npx @flyweel/skill install ad-performance-analyser-flyweel --agent=windsurf
npx @flyweel/skill install ad-performance-analyser-flyweel --agent=geminiInstall for multiple agents:
npx @flyweel/skill install ad-performance-analyser-flyweel --agent=claude-code,cursorInstall all Flyweel skills:
npx @flyweel/skill install --allManual install (clone the repo):
git clone https://github.com/openairlabs/ad-performance-analyser-flyweel.gitThe SKILL.md uses a structured 3-tier system that matches how senior media buyers approach performance data:
A quick scan of campaign vitals: spend pacing, delivery status, and obvious red flags. Use this when you need a fast pulse on campaign health without diving into details.
A detailed breakdown of key metrics against platform benchmarks. Covers CTR, CPC, CPM, conversion rates, and ROAS with trend analysis and actionable recommendations.
Full strategic analysis including audience segmentation, creative fatigue detection, budget allocation optimisation, and cross-platform comparison. Outputs a prioritised action plan with expected impact.
The SKILL.md includes built-in benchmark ranges sourced from industry data:
| Platform | CTR Range | CPC Range | CPM Range |
|---|---|---|---|
| Google Search | 3.17-6.11% | $1.00-$4.22 | n/a |
| Google Display / PMax | 0.46-0.84% | $0.50-$1.50 | $2.00-$8.00 |
| Meta (Facebook/Instagram) | 0.90-1.51% | $0.44-$1.20 | $5.00-$14.00 |
| 0.44-0.65% | $5.26-$8.00 | $25.00-$45.00 | |
| TikTok | 0.84-1.50% | $0.50-$2.00 | $4.00-$10.00 |
These benchmarks serve as reference guides. The SKILL.md adapts its analysis to your specific industry and campaign objectives.
Try these in your AI agent after installing:
The SKILL.md automatically detects and flags common performance issues:
Looking for live campaign analysis instead of static exports? Try the MCP Deep Ad Analysis SKILL.md. It connects directly to your Google Ads and Meta Ads accounts via the Flyweel MCP server.
Common questions about the free SKILL.md for ad spend analysis across Google, Meta, LinkedIn and TikTok.
The Ad Performance Analyser is a free, open-source SKILL.md that turns raw ad data into strategic analysis using senior media buying frameworks. It provides a 3-tier analysis system (Health Check, Performance Review, and Deep Dive) with 7 scenario playbooks and built-in benchmarks across Google Ads, Meta Ads, LinkedIn, and TikTok. Install it in any supported AI agent (Claude Code, Cursor, Windsurf, Codex CLI, Gemini CLI, OpenCode) in under 30 seconds.
A SKILL.md is a portable markdown file that gives AI coding agents like Claude Code, Cursor, and Windsurf specialised capabilities. It contains structured prompts, frameworks, and domain knowledge that the agent loads on demand. You install SKILL.md files using the @flyweel/skill CLI, and they work across all major AI coding agents without modification.
Run npx @flyweel/skill install ad-performance-analyser-flyweel in your terminal. The CLI auto-detects your AI agent. To target a specific agent, use --agent=cursor or --agent=claude-code,windsurf. You can also install all Flyweel skills at once with npx @flyweel/skill install --all.
The SKILL.md includes built-in benchmarks for Google Search Ads (CTR 3.17-6.11%, CPC $1.00-$4.22), Google Display and Performance Max, Meta Ads (CTR 0.90-1.51%, CPC $0.44-$1.20), LinkedIn Ads (CTR 0.44-0.65%, CPC $5.26-$8.00), and TikTok Ads (CTR 0.84-1.50%, CPC $0.50-$2.00). It works with data from any platform.
No. The Ad Performance Analyser works with any data source: CSV exports, API JSON responses, dashboard screenshots, or MCP-connected platforms. It is completely free and open-source with no account required.
The Ad Performance Analyser works offline with any data source. You paste CSV exports, screenshots, or API responses directly. The MCP Deep Ad Analysis SKILL.md connects to live campaign data via the Flyweel MCP server and can query metrics in real time, but requires a free Flyweel account. Use this skill for quick analysis of exported data; use the MCP skill when you need live, connected campaign insights.
Free SKILL.md that analyses ad spend across Google, Meta, LinkedIn and TikTok from any data source. Works with Claude Code, Gemini CLI, Codex, Cursor and Windsurf.
Every ad dollar is a loan you give yourself. Here's how to fund the gap between spend and revenue — and which financing models actually fit advertising.
Explore ROI and contribution margin benchmarks for paid ads across service industries. Expert insights and data-driven strategies to optimize performance.
Compare 8 cross-platform ad reporting tools. Track Google and Meta in one unified view. No code needed. Free and paid options.
