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
| Skill | Answers | Needs Flyweel MCP |
|---|---|---|
| flyweel | ”How is my ad spend doing?” Checks what is connected and routes your question | Yes |
| flyweel-card-top-up | How much to top up and when, with normal and heavier-spend scenarios | Yes, plus Flyweel Cards |
| flyweel-real-cash-payback | What your card charges produced, as far as your data supports | Yes, plus Flyweel Cards |
| flyweel-where-to-spend-next | Add, hold, trim or cut by platform, with an amount | Yes, plus Flyweel Cards |
| flyweel-mcp-deep-ad-analysis | Google, Meta and TikTok performance review (details) | Yes |
| ad-performance-analyser-flyweel | Review 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:
npx skills add flyweel-production/flyweel-skillsInstall just one skill:
npx skills add flyweel-production/flyweel-skills --skill flyweel-card-top-upSee what is included without installing:
npx skills add flyweel-production/flyweel-skills --listClaude Code pluginLink to this section
/plugin marketplace add flyweel-production/flyweel-skills/plugin install flyweel@flyweelThe 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.
- Have a Flyweel account.
- 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.
- Connect at least one ad platform in Flyweel: Google Ads, Meta Ads or TikTok Ads.
- For the three card skills, have Flyweel Cards set up and paying for your ads.
- 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.
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.