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 Skills
| 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 Skill
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 Agent
npx @flyweel/skill install ad-performance-analyser-flyweel --agent=cursorTarget Multiple Agents
npx @flyweel/skill install ad-performance-analyser-flyweel --agent=claude-code,cursor,windsurfInstall All Skills
npx @flyweel/skill install --allSupported Agents
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 Skill
npx @flyweel/skill remove ad-performance-analyser-flyweelUsing Skills with Flyweel MCP
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 token
Sign up at signup.flyweel.co/mcp (free, no credit card). Then go to app.flyweel.co > Settings > API Tokens and create a token.
2. Connect the MCP server
Follow the setup guide for your agent:
3. Install the MCP skill
npx @flyweel/skill install flyweel-mcp-deep-ad-analysis4. Connect your ad platforms
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 querying
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?
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 Steps
- Ad Performance Analyser (works with any data, no account needed)
- MCP Deep Ad Analysis (live campaign data, free account required)
- MCP Quickstart Guide
