The @flyweel/skill CLI installs SKILL.md files into your AI coding agent. SKILL.md files give agents like Claude Code, Cursor, and Windsurf specialised capabilities without writing custom prompts.
Available SkillsLink to this section
| Skill | Description | Requires Account | Details |
|---|---|---|---|
| ad-performance-analyser-flyweel | Analyse ad data from any source (CSV, API, screenshots) | No | View skill page |
| flyweel-mcp-deep-ad-analysis | Analyse live Google Ads and Meta Ads via Flyweel MCP | Yes (free) | View skill page |
List all available skills:
npx @flyweel/skillInstall a SkillLink to this section
The CLI auto-detects your AI agent and installs the SKILL.md file to the correct location.
npx @flyweel/skill install ad-performance-analyser-flyweelnpx @flyweel/skill install flyweel-mcp-deep-ad-analysisTarget a Specific AgentLink to this section
npx @flyweel/skill install ad-performance-analyser-flyweel --agent=cursorTarget Multiple AgentsLink to this section
npx @flyweel/skill install ad-performance-analyser-flyweel --agent=claude-code,cursor,windsurfInstall All SkillsLink to this section
npx @flyweel/skill install --allSupported AgentsLink to this section
The CLI auto-detects and installs to the correct config location for each agent:
| Agent | Detection | Install Location |
|---|---|---|
| Claude Code | ~/.claude/ directory | ~/.claude/commands/ |
| Cursor | .cursor/ in project | .cursor/rules/ |
| Windsurf | .windsurf/ in project | .windsurf/rules/ |
| Codex CLI | codex binary | ~/.codex/instructions/ |
| Gemini CLI | gemini binary | ~/.gemini/instructions/ |
| OpenCode | opencode binary | ~/.opencode/instructions/ |
Remove a SkillLink to this section
npx @flyweel/skill remove ad-performance-analyser-flyweelUsing Skills with Flyweel MCPLink to this section
The flyweel-mcp-deep-ad-analysis skill works together with the Flyweel MCP server. Here’s how to set up both:
1. Get your API tokenLink to this section
Sign up at signup.flyweel.co/mcp (free, no credit card). Then go to app.flyweel.co > Settings > API & MCP and create a token.
2. Connect the MCP serverLink to this section
Follow the setup guide for your agent:
3. Install the MCP skillLink to this section
npx @flyweel/skill install flyweel-mcp-deep-ad-analysis4. Connect your ad platformsLink to this section
Open your agent and ask:
Connect my Google Ads account to Flyweel.The skill will walk you through the OAuth flow to link Google Ads, Meta Ads, or both.
5. Start queryingLink to this section
Once connected, the skill handles MCP tool orchestration automatically. Try:
Show me a performance overview for all ad accounts this month.Which campaigns have the highest CPA in the last 30 days?Compare Google Ads vs Meta Ads CPL for Q1.The skill batches up to 5 MCP queries per request and applies senior media buying analysis frameworks to the results.
The ad-performance-analyser-flyweel skill does not require MCP. It works with any data you paste into your agent (CSV exports, screenshots, API responses). Install it separately if you want offline analysis alongside live MCP queries.
What Is a SKILL.md?Link to this section
A SKILL.md is a portable markdown file that gives AI coding agents domain-specific knowledge and structured workflows. It contains:
- Context: Background knowledge the agent needs (e.g. ad platform benchmarks, analysis frameworks)
- Instructions: Step-by-step workflows the agent follows when triggered
- Guardrails: Rules that keep the agent on track (e.g. batch MCP queries, check data quality first)
SKILL.md files are open-source and work across all major AI coding agents without modification.
Next StepsLink to this section
- Ad Performance Analyser (works with any data, no account needed)
- MCP Deep Ad Analysis (live campaign data, free account required)
- MCP Quickstart Guide
