Update to Ad Superpowers

{
  "name": "connection-troubleshooter",
  "description": "This skill should be used when a user says the Ad Superpowers connector looks broken or half-empty: \"I only see a few tools\", \"my platform tools are missing\", \"the connector isn't working\", \"I connected my account but nothing shows up\", \"where are my Google Ads / Meta / GA4 tools\", \"a tool is not callable / not available\", or asks how to \"reconnect\" a platform. It explains that a short tool list almost always means a connection needs (re)connecting — not that the platform is broken — and walks through the exact fix (reconnect the affected platform on the dashboard, then start a fresh chat). It covers the Google specifics: Ads, Analytics, Search Console and Tag Manager are connected individually, so each can go missing on its own and each may need its own reconnect. Do NOT use for: diagnosing campaign/ad performance (use the per-platform performance-troubleshooter skills), billing/subscription questions, or building/onboarding client profiles (use client-context-onboarding).",
  "included_files": [],
  "skill_md_contents": "---\nname: connection-troubleshooter\ndescription: \"This skill should be used when a user says the Ad Superpowers connector looks broken or half-empty: \\\"I only see a few tools\\\", \\\"my platform tools are missing\\\", \\\"the connector isn't working\\\", \\\"I connected my account but nothing shows up\\\", \\\"where are my Google Ads / Meta / GA4 tools\\\", \\\"a tool is not callable / not available\\\", or asks how to \\\"reconnect\\\" a platform. It explains that a short tool list almost always means a connection needs (re)connecting \\u2014 not that the platform is broken \\u2014 and walks through the exact fix (reconnect the affected platform on the dashboard, then start a fresh chat). It covers the Google specifics: Ads, Analytics, Search Console and Tag Manager are connected individually, so each can go missing on its own and each may need its own reconnect. Do NOT use for: diagnosing campaign/ad performance (use the per-platform performance-troubleshooter skills), billing/subscription questions, or building/onboarding client profiles (use client-context-onboarding).\"\nallowed-tools: skill, workflow, clients, clients_update\n---\n\n# Connection Troubleshooter\n\n## Purpose\n\nHelp a user who suddenly sees only a handful of Ad Superpowers tools (typically\njust `workflow`, `skill`, and `clients`, sometimes with `clients_update`)\nunderstand what happened and fix it. In almost every case a short tool list\nmeans **a platform connection needs (re)connecting** — the dashboard may still\nsay \"connected\", but the underlying login (the OAuth grant) has expired or been\nrevoked, so the server can no longer fetch that platform's data and hides its\ntools rather than show broken ones. Nothing is \"broken\" and no data was lost;\nthe connection just needs to be refreshed.\n\n## When to Use This Skill\n\nUse this skill when the user reports any of:\n\n- \"I only see a few tools\" / \"most of my tools are gone\" / \"my platform tools are missing\".\n- \"Where are my Google Ads / GA4 / Search Console / Tag Manager tools?\" or\n  \"Where are my Meta / LinkedIn / TikTok tools?\"\n- \"The connector isn't working\" / \"I connected my account but nothing shows up\".\n- \"A tool is not callable\" or \"that tool isn't available.\"\n- \"How do I reconnect <platform>?\"\n\nDo **not** use it for campaign performance problems, billing questions, or\nclient onboarding — see the \"Do NOT use for\" note in the description.\n\n## Why this happens (plain-language)\n\nAd Superpowers only shows a platform's tools when it can actually reach that\nplatform on your behalf. To do that it uses the login you granted when you\nconnected the account (an OAuth \"grant\"). Access to a platform is short-lived\nand is refreshed automatically in the background — but if that grant was\n**revoked or expired** (you changed your password, removed the app's access,\nthe refresh token aged out, an admin rotated permissions, etc.), the automatic\nrefresh fails. When the server can't get a working connection for a platform, it\n**hides that platform's tools** instead of surfacing tools that would only\nerror. That is why the dashboard can still list the account as \"connected\" while\nits tools have quietly disappeared from this chat.\n\nA small set of universal tools never depends on any platform connection, so they\nstay visible even when every platform tool is hidden: `workflow`, `skill`, and\n`clients` for everyone, plus `clients_update` on write-enabled plans. Seeing only\nthese — and none of your platform tools — is the classic signature of a dead\nconnection.\n\n## Figure out which platform to reconnect (works in any client)\n\nYou do not need any special access to diagnose this — **infer the missing\nplatform from the tools you can see right now:**\n\n- No `google_ads_*` tools → **Google Ads** needs reconnecting.\n- No `ga4_*` tools → **Google Analytics (GA4)**.\n- No `gsc_*` tools → **Google Search Console**.\n- No `gtm_*` tools → **Google Tag Manager**.\n- No `meta_*` tools → **Meta** (Facebook/Instagram).\n- No `linkedin_*` tools → **LinkedIn**.\n- No `tiktok_*` tools → **TikTok**.\n\n**Google is four separate connections.** Ads, Analytics, Search Console, and Tag\nManager are each connected **individually** on the dashboard, so any one of them\ncan go missing on its own — and each may need its own reconnect. They do share a\nsingle Google sign-in, so reconnecting one Google service often brings the\nothers back at the same time, but that is not guaranteed once a login has been\nrevoked. The reliable rule: **reconnect every Google service whose tools are\nmissing.**\n\nIf several tool groups are missing, more than one connection needs attention. If\n**every** platform group is missing, start with whichever platform the user\ncares about most.\n\n## The fix (step by step)\n\n1. Go to the dashboard: **`https://app.adsuperpowers.ai/dashboard/integrations`**\n   (the Integrations / Connected Accounts page).\n2. For each platform that's missing its tools, click **Reconnect** (or\n   **Connect**). For Google, do this for **each** Google service you use whose\n   tools are gone — Google Ads, Analytics, Search Console, and Tag Manager are\n   listed and reconnected separately.\n3. Complete the login/consent in the browser.\n4. **Start a fresh chat** in your MCP client (Claude, ChatGPT, Cursor, …). The\n   tool list is negotiated once when a session connects, so the reconnected\n   tools only reappear in a **new** conversation — refreshing the current chat is\n   not enough.\n5. Confirm the platform's tools are back (e.g. `google_ads_*` for Google Ads). If\n   any expected Google tools are still missing, go back to step 2 and reconnect\n   that specific Google service too.\n\n## If it still doesn't work\n\n- Double-check you reconnected the right platform on the dashboard and that the\n  connection shows active and selected there. For Google, confirm each service\n  you expected (Ads / Analytics / Search Console / Tag Manager) is reconnected.\n- Make sure you truly started a **new** chat/session after reconnecting, not the\n  same one.\n- If the tools still don't appear in a fresh chat, the account may not be\n  selected for use, or the connection may belong to a different organization\n  than the one your API key resolves to. Contact Ad Superpowers support with the\n  platform name and the account you expected to see.\n\n## Key facts to remember\n\n- A short tool list ≈ **(re)connect needed**, not \"the platform is broken.\"\n- **Google is four separate connections** (Ads, Analytics, Search Console, Tag\n  Manager). Reconnect **each** Google service whose tools are missing —\n  reconnecting one often restores the others (shared sign-in), but it is not\n  guaranteed after a revoked login.\n- **Always start a fresh chat** after reconnecting — the tool list only\n  re-handshakes on a new session.\n- A few universal tools (`workflow`, `skill`, `clients`, and `clients_update` on\n  write-enabled plans) stay visible even when platform tools are hidden; only\n  *platform* tools disappear when a connection dies.\n"
}