Skip to content

Flyweel Agent Skills

Flyweel agent skills are instructions your AI agent follows to answer specific questions about your ad spend. The Flyweel MCP server connects your agent to your data. The skills provide the method: what to check, which figures to use and when the evidence is too thin for a firm answer.

The skills are open source under Apache 2.0 in the flyweel-production/flyweel-skills repository.


Available SkillsLink to this section

SkillAnswersNeeds Flyweel MCP
flyweel”How is my ad spend doing?” Checks what is connected and routes your questionYes
flyweel-card-top-upHow much to top up and when, with normal and heavier-spend scenariosYes, plus Flyweel Cards
flyweel-real-cash-paybackWhat your card charges produced, as far as your data supportsYes, plus Flyweel Cards
flyweel-where-to-spend-nextAdd, hold, trim or cut by platform, with an amountYes, plus Flyweel Cards
flyweel-mcp-deep-ad-analysisGoogle, Meta and TikTok performance review (details)Yes
ad-performance-analyser-flyweelReview a CSV export, pasted numbers or a screenshot (details)No, no account needed

Install the SkillsLink to this section

One command works with Claude Code, Cursor, Codex, Gemini CLI, OpenCode and most other coding agents:

Terminal window
npx skills add flyweel-production/flyweel-skills

Install just one skill:

Terminal window
npx skills add flyweel-production/flyweel-skills --skill flyweel-card-top-up

See what is included without installing:

Terminal window
npx skills add flyweel-production/flyweel-skills --list

Claude Code pluginLink to this section

/plugin marketplace add flyweel-production/flyweel-skills
/plugin install flyweel@flyweel

The plugin also adds the Flyweel MCP server. Run /mcp and sign in to Flyweel.

Restart your agent after installing so it picks up the skills.


Before You StartLink to this section

Five of the six skills read your data through the Flyweel MCP server.

  1. Have a Flyweel account.
  2. Connect the Flyweel MCP server to your agent and sign in when it asks. Follow the MCP setup guide or the page for your agent: Claude Code, Cursor, Codex CLI, Gemini CLI, any MCP client.
  3. Connect at least one ad platform in Flyweel: Google Ads, Meta Ads or TikTok Ads.
  4. For the three card skills, have Flyweel Cards set up and paying for your ads.
  5. A CRM is optional. With one, answers can go as far as signed deals and revenue. Without one, they stop at platform results and say so.

Not sure what is connected? Ask your agent “Is everything set up right?” and the flyweel skill will check.

Already using the Flyweel MCP server? Install the skills, restart your agent and keep your existing connection.


Card Spend vs Reported SpendLink to this section

Ad platforms report what ran. Your cards record the charges. Tax, fees and billing dates can put a gap between the two.

  • Card charges: flyweel-card-top-up, flyweel-real-cash-payback, flyweel-where-to-spend-next
  • Platform-reported spend and results: flyweel-mcp-deep-ad-analysis

Each skill says which figure it uses.


GuardrailsLink to this section

  • You make every payment. Top-up advice gives an amount and a date. You pay in Flyweel when you are ready.
  • Card changes wait for your yes. Supported changes, such as a new card budget, show a preview and run only after you confirm.
  • Campaigns stay in your hands. The skills read campaign data. Creating, pausing and editing campaigns stays in your ad platforms (Meta changes are in early access for some organizations).
  • Credit limits stay with Flyweel. Your agent works within your limit and never changes it.
  • Gaps are flagged, not filled. Missing revenue is called out, never counted as zero.
Using the older @flyweel/skill CLI?

The @flyweel/skill npm package only carries the original two skills (ad-performance-analyser-flyweel and flyweel-mcp-deep-ad-analysis). Use npx skills add flyweel-production/flyweel-skills to get all six.


What Is a SKILL.md?Link to this section

A SKILL.md is a portable markdown file that gives an AI agent domain knowledge and a structured workflow. It holds the background the agent needs, the steps it follows when your question matches, and the rules that keep its answer honest. Because the Flyweel skills are open source, you can read exactly what your agent checks before you install them.


Next StepsLink to this section

Ready to get started?

Start optimizing your ad spend today with Flyweel.