--- title: SKILL.md CLI Installation Guide | Flyweel Docs description: Install Flyweel SKILL.md files for Claude Code, Cursor, Windsurf, Codex, Gemini and OpenCode using the @flyweel/skill CLI. One command to give your AI agent ad-spend superpowers. url: "https://www.flyweel.co/docs/mcp/skill-cli" type: static generatedAt: "2026-10-07T04:41:33.578Z" --- ![Documentation hero background](https://astro-flyweel-docs.vercel.app/vision-hero.webp) # SKILL.md CLI Installation Guide 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[Link to this section](#available-skills) | Skill | Description | Requires Account | Details | | --- | --- | --- | --- | | **ad-performance-analyser-flyweel** | Analyse ad data from any source (CSV, API, screenshots) | No | [View skill page](https://www.flyweel.co/tools/ad-performance-analyser) | | **flyweel-mcp-deep-ad-analysis** | Analyse live Google Ads and Meta Ads via Flyweel MCP | Yes (free) | [View skill page](https://www.flyweel.co/tools/flyweel-mcp-deep-ad-analysis) | List all available skills: *Terminal window* ``` npx @flyweel/skill ``` --- ## Install a Skill[Link to this section](#install-a-skill) The CLI auto-detects your AI agent and installs the SKILL.md file to the correct location. *Terminal window* ``` npx @flyweel/skill install ad-performance-analyser-flyweel ``` *Terminal window* ``` npx @flyweel/skill install flyweel-mcp-deep-ad-analysis ``` ### Target a Specific Agent[Link to this section](#target-a-specific-agent) *Terminal window* ``` npx @flyweel/skill install ad-performance-analyser-flyweel --agent=cursor ``` ### Target Multiple Agents[Link to this section](#target-multiple-agents) *Terminal window* ``` npx @flyweel/skill install ad-performance-analyser-flyweel --agent=claude-code,cursor,windsurf ``` ### Install All Skills[Link to this section](#install-all-skills) *Terminal window* ``` npx @flyweel/skill install --all ``` --- ## Supported Agents[Link to this section](#supported-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[Link to this section](#remove-a-skill) *Terminal window* ``` npx @flyweel/skill remove ad-performance-analyser-flyweel ``` --- ## Using Skills with Flyweel MCP[Link to this section](#using-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[Link to this section](#1-get-your-api-token) Sign up at [signup.flyweel.co/mcp](https://signup.flyweel.co/mcp) (free, no credit card). Then go to [app.flyweel.co](https://app.flyweel.co) > **Settings** > **API & MCP** and create a token. ### 2. Connect the MCP server[Link to this section](#2-connect-the-mcp-server) Follow the setup guide for your agent: - [Claude Code CLI](/docs/mcp/claude-code-cli) - [Claude Code Desktop](/docs/mcp/claude-desktop) - [Cursor](/docs/mcp/cursor) - [VS Code](/docs/mcp/vscode) - [Windsurf](/docs/mcp/windsurf) - [Other Clients](/docs/mcp/other) ### 3. Install the MCP skill[Link to this section](#3-install-the-mcp-skill) *Terminal window* ``` npx @flyweel/skill install flyweel-mcp-deep-ad-analysis ``` ### 4. Connect your ad platforms[Link to this section](#4-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[Link to this section](#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?[Link to this section](#what-is-a-skillmd) 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[Link to this section](#next-steps) - [Ad Performance Analyser](https://www.flyweel.co/tools/ad-performance-analyser) (works with any data, no account needed) - [MCP Deep Ad Analysis](https://www.flyweel.co/tools/flyweel-mcp-deep-ad-analysis) (live campaign data, free account required) - [MCP Quickstart Guide](/docs/mcp/setup) ### Ready to get started? Start optimizing your ad spend today with Flyweel. [Start Free](https://signup.flyweel.co/?variant=control)