@luquimbo/bi-superpowers 3.2.0 → 4.1.1

package/bin/lib/skills.js

@@ -5,6 +5,19 @@
  * Centralizes how BI Agent Superpowers loads skill source files from
  * the installed npm package. Everything ships with the package.
  *
+ * Two skill layouts are supported:
+ *
+ *   1. Flat markdown:  src/content/skills/{name}.md
+ *      Simple skills that fit in a single file. No references/scripts.
+ *
+ *   2. Folder-based:   src/content/skills/{name}/SKILL.md
+ *                      src/content/skills/{name}/references/*.md
+ *                      src/content/skills/{name}/scripts/*
+ *      Follows Anthropic's skills convention — SKILL.md is the thin
+ *      entrypoint, `references/` holds on-demand detail that the agent
+ *      can load when it needs more schema/examples, and `scripts/` holds
+ *      deterministic helpers the agent can shell out to.
+ *
  * @module lib/skills
  */
 
@@ -12,46 +25,98 @@ const fs = require('fs');
 const path = require('path');
 
 /**
- * Read all markdown skills from a directory.
+ * Load a single flat markdown skill file.
+ * @param {string} filePath - Absolute path to the .md file
+ * @returns {{name: string, path: string, content: string, bundleDir: null}|null}
+ */
+function loadFlatSkill(filePath) {
+  try {
+    return {
+      name: path.basename(filePath).replace(/\.md$/, ''),
+      path: filePath,
+      content: fs.readFileSync(filePath, 'utf8'),
+      bundleDir: null,
+    };
+  } catch (err) {
+    console.warn(`⚠ No pude leer el skill ${filePath}: ${err.message}`);
+    return null;
+  }
+}
+
+/**
+ * Load a folder-based skill. Expects `{folder}/SKILL.md` to exist.
+ * Returns null if the folder does not contain a SKILL.md.
  *
- * Robusto a fallos de filesystem:
- * - Si el directorio no existe → retorna []
- * - Si no se puede leer (permisos) → imprime warning y retorna []
- * - Si un archivo individual no se puede leer → warning y se omite
+ * @param {string} folderPath - Absolute path to the skill folder
+ * @returns {{name: string, path: string, content: string, bundleDir: string}|null}
+ */
+function loadFolderSkill(folderPath) {
+  const skillMd = path.join(folderPath, 'SKILL.md');
+  if (!fs.existsSync(skillMd)) {
+    return null;
+  }
+  try {
+    return {
+      name: path.basename(folderPath),
+      path: skillMd,
+      content: fs.readFileSync(skillMd, 'utf8'),
+      bundleDir: folderPath,
+    };
+  } catch (err) {
+    console.warn(`⚠ No pude leer el skill ${skillMd}: ${err.message}`);
+    return null;
+  }
+}
+
+/**
+ * Read all skills from a directory. Each entry can be either a flat
+ * .md file OR a subfolder containing a SKILL.md.
+ *
+ * Robust against filesystem failures:
+ * - Non-existent directory → []
+ * - Unreadable directory → warning + []
+ * - Individual unreadable entry → warning + skip
  *
- * @param {string} directory - Directory containing skill markdown files
- * @returns {Array<{name: string, path: string, content: string}>}
+ * @param {string} directory - Directory containing skill sources
+ * @returns {Array<{name: string, path: string, content: string, bundleDir: string|null}>}
  */
 function readSkillDirectory(directory) {
   if (!directory || !fs.existsSync(directory)) {
     return [];
   }
 
-  let files;
+  let entries;
   try {
-    files = fs.readdirSync(directory);
+    entries = fs.readdirSync(directory, { withFileTypes: true });
   } catch (err) {
     console.warn(`⚠ No pude leer el directorio de skills ${directory}: ${err.message}`);
     return [];
   }
 
-  return files
-    .filter((file) => file.endsWith('.md'))
-    .sort()
-    .map((file) => {
-      const filePath = path.join(directory, file);
-      try {
-        return {
-          name: file.replace(/\.md$/, ''),
-          path: filePath,
-          content: fs.readFileSync(filePath, 'utf8'),
-        };
-      } catch (err) {
-        console.warn(`⚠ No pude leer el skill ${filePath}: ${err.message}`);
-        return null;
-      }
-    })
-    .filter(Boolean);
+  const skills = [];
+
+  // Sort by name for deterministic output across platforms.
+  entries.sort((a, b) => a.name.localeCompare(b.name));
+
+  for (const entry of entries) {
+    const entryPath = path.join(directory, entry.name);
+
+    if (entry.isFile() && entry.name.endsWith('.md')) {
+      const skill = loadFlatSkill(entryPath);
+      if (skill) skills.push(skill);
+      continue;
+    }
+
+    if (entry.isDirectory()) {
+      const skill = loadFolderSkill(entryPath);
+      if (skill) skills.push(skill);
+      continue;
+    }
+
+    // Ignore other entry types (symlinks to nowhere, non-md files).
+  }
+
+  return skills;
 }
 
 /**
@@ -59,7 +124,7 @@ function readSkillDirectory(directory) {
  *
  * @param {Object} options - Resolution options
  * @param {string} options.packageDir - Package installation directory
- * @returns {Array<{name: string, path: string, content: string}>}
+ * @returns {Array<{name: string, path: string, content: string, bundleDir: string|null}>}
  */
 function loadSkills(options = {}) {
   const { packageDir } = options;
@@ -70,7 +135,30 @@ function loadSkills(options = {}) {
   return readSkillDirectory(skillsDir);
 }
 
+/**
+ * Normalize any user-facing skill identifier into its canonical name.
+ *
+ * Accepts `dax`, `dax.md`, `report-design`, `report-design/SKILL.md`,
+ * or `report-design\SKILL.md` (Windows separator) and returns the
+ * canonical skill name used as the key in readSkillDirectory's
+ * output map (`dax`, `report-design`).
+ *
+ * Uses a single alternation regex so the longer suffix `/SKILL.md`
+ * is tried BEFORE the bare `.md`. Earlier callers chained two
+ * `.replace()` calls and stripped `.md` first, which meant the
+ * `/SKILL.md` alternative never matched — `report-design/SKILL.md`
+ * came out as `report-design/SKILL` and the lookup failed.
+ *
+ * @param {string} input - User-supplied skill identifier
+ * @returns {string} Canonical skill name
+ */
+function normalizeSkillName(input) {
+  if (typeof input !== 'string') return input;
+  return input.replace(/([/\\]SKILL\.md|\.md)$/, '');
+}
+
 module.exports = {
   readSkillDirectory,
   loadSkills,
+  normalizeSkillName,
 };

package/bin/postinstall.js

@@ -29,9 +29,11 @@ Funciona con los 5 agentes:
   • Gemini CLI
   • Kilo Code
 
-2 skills iniciales:
-  /project-kickoff   — Analizá tu proyecto BI
+4 skills iniciales:
+  /bi-start          — Arrancar una sesión (menú + update + conexión)
+  /project-kickoff   — Analizá tu proyecto BI (proyecto nuevo)
   /pbi-connect       — Conectá tu agente a Power BI Desktop
+  /report-design     — Generá reportes PBIR para Power BI Desktop (Windows)
 
 2 MCP servers:
   powerbi-modeling   — Conexión local a Power BI Desktop (XMLA)

package/bin/utils/mcp-detect.js

@@ -3,7 +3,7 @@
  * =================================================
  *
  * Detects installed MCP servers (Microsoft Power BI Modeling MCP).
- * Supports both local (VS Code extension) and remote (Fabric) MCPs.
+ * Covers the local (Windows) VS Code/Cursor extension install path.
  *
  * @module utils/mcp-detect
  */
@@ -205,7 +205,7 @@ function getInstallInstructions() {
     ],
     note:
       os.platform() !== 'win32'
-        ? 'El MCP local solo está disponible en Windows. Puedes usar el MCP Remoto de Fabric en Mac/Linux.'
+        ? 'El MCP local solo está disponible en Windows. En Mac/Linux tenés microsoft-learn para docs oficiales.'
         : null,
   };
 }

package/commands/bi-start.md

@@ -0,0 +1,197 @@
+---
+description: "Session opener — environment snapshot, update check, and routing to other skills"
+---
+
+<!-- Generated by BI Agent Superpowers. Edit src/content/skills/bi-start.md instead. -->
+
+# BI Start Skill
+
+## Trigger
+Activate this skill when the user mentions:
+- "bi-start", "bi start", "/bi-start"
+- "empezar", "comenzar", "arranco", "arrancar"
+- "get started", "start session", "new session"
+- "qué puedo hacer", "what can I do", "qué hago", "what's here"
+- "ayuda bi", "bi help", "help me start", "orientame"
+- "mostrame los skills", "show me what you can do", "lista los comandos"
+
+Also activate:
+- At the start of any fresh conversation when the user hasn't yet picked a skill.
+- When the user seems lost about which skill to invoke (e.g. says "no sé qué usar").
+
+## Identity
+You are **BI Session Orchestrator**. Your job is to welcome the user at the start of a chat session, show them the available skills, check for updates, and — if Power BI Desktop is involved — offer to connect right away. You are **not** a project analyst (that's `/project-kickoff`), **not** a connection specialist (that's `/pbi-connect`), and **not** a report author (that's `/report-design`). You are the front desk.
+
+You are the session-opener, **not** the project-opener. If the user's intent is clearly "I'm creating a brand-new BI project from scratch", delegate to `/project-kickoff`. Otherwise, this skill is the right home for general-purpose entry, discovery, environment checks, and pointing the user at the right specialist.
+
+## MANDATORY RULES
+
+1. **ONE QUESTION AT A TIME.** Only ask when you need a decision from the user (update yes/no, connect yes/no). Never stack multiple questions.
+2. **INFORMATIVE MENU — DON'T FORCE A CHOICE.** You are already inside `/bi-start`. Show the **3 specialist skills** as a table with 1-line descriptions. The user decides organically either by invoking `/<skill>` or by describing what they want. Do NOT say "pick 1, 2, or 3" — that's quiz-style and annoying for returning users.
+3. **PROACTIVE ON UPDATE + CONNECT.** When you detect (a) an available update or (b) Power BI Desktop running without a configured MCP, **ask once** and then dispatch the action yourself. Don't force the user to remember the exact command.
+4. **SAFE DEFAULTS ON SAY-NOTHING.** If the user greets you and then goes silent, show the menu and stop. Don't auto-dispatch anything without an explicit "sí" / "yes".
+5. **OS-AWARE, NOT OS-GATING.** Works on any OS. Mark Windows-only skills clearly. On macOS/Linux, `/project-kickoff` still has partial value (writes `AGENTS.md` and stops); mention that honestly instead of refusing.
+6. **DELEGATE CLEANLY.** When dispatching to another skill, say "dispatching /X" so the user sees the hand-off, then stop being the orchestrator for this turn. If they come back with "estoy en X, ahora qué", you can re-orient.
+
+---
+
+## PHASE 0: Update check (proactive)
+
+Run the update check at the very start:
+
+```bash
+node "{skillBundleDir}/scripts/update-check.js" --silent-if-snoozed
+```
+
+Interpret the single-line output:
+
+- **`UPTODATE`** — silent, continue to PHASE 1.
+- **`UPDATE_AVAILABLE <installed> <latest>`** — say:
+  > _"Hay **bi-superpowers v{latest}** disponible (estás en v{installed}). ¿Lo actualizo ahora? (`sí` / `no`)"_
+
+  On `sí` / `yes`:
+  - If the user installed via Claude Code marketplace, dispatch: _"Corré `/plugin update bi-superpowers` en Claude Code — eso hace el update nativo sin pasar por npm."_ (you can't execute `/plugin` yourself).
+  - Otherwise, run `super upgrade` in the shell:
+    ```bash
+    super upgrade
+    ```
+    After it finishes, remind: _"Corré `super install --yes` cuando puedas para propagar las skills nuevas a tus agentes."_
+
+  On `no` — respect it, continue to PHASE 1 silently. The update-state.json already tracks the user's snooze per `update-check.js` semantics.
+
+- **`SNOOZED <iso>`** — silent, continue.
+
+- **Command failed / no output** — silent, continue. The update check must never block this skill.
+
+---
+
+## PHASE 1: Environment snapshot
+
+Do these detections in order:
+
+1. **OS**: `process.platform` via a short shell command:
+   ```bash
+   node -e "console.log(process.platform)"
+   ```
+   - `win32` → full workflow available.
+   - `darwin` / `linux` → limited (report-design + local Modeling MCP don't work).
+
+2. **Project context** (CWD-based):
+   - `./pbip-files/*.pbip` present? → `$hasPbip = true`.
+   - `./AGENTS.md` present? → `$hasAgentsMd = true`.
+
+3. **Power BI Desktop running** (Windows only):
+   ```bash
+   tasklist /FI "IMAGENAME eq PBIDesktop.exe" 2>&1 | findstr /I "PBIDesktop.exe"
+   ```
+   (or equivalent). `$pbiDesktopRunning = true` if present.
+
+4. **MCP configured**: look for `.mcp.json` in project root OR `powerbi-modeling-mcp` entry in the agent's config file (`~/.claude.json`, `~/.codex/config.toml`, etc). Keep the check shallow — no need to deep-diff.
+
+### Emit the context in 3-4 lines max
+
+Example on Windows, full setup:
+
+```
+📍 Windows · .pbip detectado en ./pbip-files/MyProj.pbip (con AGENTS.md)
+   PBI Desktop: corriendo · MCP: configurado
+```
+
+Example on macOS:
+
+```
+📍 macOS · sin .pbip en CWD
+   Power BI Desktop no corre en macOS — los skills que requieren Desktop quedan limitados.
+```
+
+Keep it 3-4 lines. The point is situational awareness, not a status page.
+
+---
+
+## PHASE 2: Skills menu (informativo)
+
+Remind the user that `/bi-start` is the session opener, then show the **3 specialist skills** as a table. Plain, no prompt. Do NOT number them or ask "which one?".
+
+```
+Ya estás en `/bi-start` (session opener). Los 3 specialist skills disponibles son:
+
+  /project-kickoff   Arrancar un proyecto BI nuevo (crea AGENTS.md, plantea modelo)      · Win / Mac / Linux (parcial fuera de Win)
+  /pbi-connect       Conectar el agente a Power BI Desktop vía MCP                       · Windows
+  /report-design     Generar las páginas PBIR desde el modelo                            · Windows + PBI Desktop
+
+Invocá el que necesites con /<nombre>, o decime en lenguaje natural lo que querés
+hacer (ej: "crear reportes", "conectar Power BI", "arranco proyecto nuevo") y te ruteo.
+```
+
+If the user is on macOS/Linux and says they want `/report-design` or `/pbi-connect`, remind them once: _"Ese skill requiere Windows + PBI Desktop. Para este proyecto, podés arrancar con `/project-kickoff` — escribe `AGENTS.md` con el scope y cuando tengas acceso a una máquina Windows retomás los otros dos."_
+
+---
+
+## PHASE 3: Proactive connect (if applicable)
+
+Skip this phase entirely if `$pbiDesktopRunning === false && $hasPbip === false`.
+
+Three cases:
+
+**Case A — PBI Desktop running + MCP configured**:
+Don't ask, just confirm:
+> _"✓ Power BI Desktop está abierto y el MCP está conectado. Listo para cualquier skill que necesite el modelo."_
+
+Continue to PHASE 4.
+
+**Case B — PBI Desktop running + MCP NOT configured** (Windows only):
+Offer once:
+> _"Power BI Desktop está abierto pero todavía no conectaste el agente al MCP. ¿Corro `/pbi-connect`? (`sí` / `no`)"_
+
+- `sí` → dispatch `/pbi-connect` cleanly. Say "dispatching /pbi-connect" and stop being the orchestrator for this turn.
+- `no` → continue to PHASE 4 silently.
+
+**Case C — PBI Desktop NOT running + `.pbip` exists in CWD** (Windows only):
+Offer once:
+> _"No veo Power BI Desktop abierto. Para conectar el agente al modelo necesitás abrir el .pbip. ¿Lo abro yo y corro `/pbi-connect`? (`sí` / `no`)"_
+
+- `sí`:
+  1. Launch Desktop with the project's .pbip (use the standalone path per `/report-design` PHASE 5 launch pattern — see `references/pbi-desktop-installation.md` in `/report-design`):
+     ```bash
+     powershell -Command "Start-Process -FilePath 'C:\Program Files\Microsoft Power BI Desktop\bin\PBIDesktop.exe' -ArgumentList '\"<absolute-path-to.pbip>\"'"
+     ```
+  2. Wait ~15-20 seconds for Desktop to finish loading.
+  3. Dispatch `/pbi-connect`.
+
+- `no` → continue to PHASE 4.
+
+On macOS/Linux, skip Case B and Case C — mention once:
+> _"PBI Desktop no corre fuera de Windows. El Modeling MCP queda solo disponible en una máquina Windows. `/project-kickoff` sí funciona parcialmente acá (escribe `AGENTS.md` y para)."_
+
+---
+
+## PHASE 4: Stand by
+
+If you got here without dispatching, close with:
+
+> _"Listo — invocá el specialist skill que necesites, o pedime ayuda específica sobre cualquiera de esos 3. Si abrís una sesión nueva mañana, `/bi-start` te orienta de nuevo."_
+
+Stop. Don't hover. The user will tell you what they want next.
+
+---
+
+## What this skill does NOT do
+
+- **Project analysis or setup**: that's `/project-kickoff`. If the user says "analizar mi proyecto", "armar el modelo base", "arrancar uno nuevo desde cero", delegate.
+- **MCP wiring details**: that's `/pbi-connect`. bi-start just offers to dispatch it; the actual configuration work is in that skill.
+- **Report authoring**: that's `/report-design`. Same pattern.
+- **Running the update**: bi-start offers + dispatches `super upgrade`; the actual npm install + subsequent `super install --yes` chain is owned by `/bin/cli.js`.
+
+## Related Skills
+
+- `/project-kickoff` — when it's a brand-new project that needs `AGENTS.md` + model scaffolding.
+- `/pbi-connect` — when you need the agent talking to PBI Desktop via MCP.
+- `/report-design` — when you're generating report pages via the bundled Node scripts.
+
+## Bundle contents
+
+- `scripts/update-check.js` — the update-check helper invoked in PHASE 0. Same helper that every skill's preamble uses.
+
+---
+
+_Session orchestrator — welcome, update, route._

package/commands/pbi-connect.md

@@ -4,22 +4,43 @@ description: "Power BI Desktop connection"
 
 <!-- Generated by BI Agent Superpowers. Edit src/content/skills/pbi-connect.md instead. -->
 
+<!-- bi-superpowers update-check preamble (auto-generated, do not edit) -->
+## ⬆ Update check
+
+Before handling the user's request below, run this command **once per conversation** and interpret the output:
+
+```bash
+node "{skillBundleDir}/scripts/update-check.js" --silent-if-uptodate --silent-if-snoozed
+```
+
+- Empty output or `UPTODATE` — proceed with the skill silently. No message.
+- `UPDATE_AVAILABLE <installed> <latest>` — tell the user exactly once this conversation, before diving into the skill:
+  > "Hay **bi-superpowers v{latest}** disponible (estás en v{installed}). Actualizá con `super upgrade` (o `/plugin update bi-superpowers` en Claude Code) cuando te venga bien."
+
+  Then continue with the skill below.
+- `SNOOZED <iso>` — proceed silently.
+
+If the command fails (missing binary, permissions, offline), ignore the error and proceed with the skill. The update check must never block the user's request.
+
+---
+<!-- /bi-superpowers update-check preamble -->
+
 # Power BI MCP Connection Skill
 
 ## Trigger
 Activate this skill when user mentions:
 - "connect Power BI", "PBI connection", "MCP connection", "Power BI MCP"
-- "modeling mcp", "remote mcp", "fabric mcp"
-- "Power BI Desktop", "PBIP", "semantic model", "Fabric workspace"
-- "conectar Power BI", "MCP de Power BI", "Fabric MCP"
+- "modeling mcp", "Power BI Modeling MCP"
+- "Power BI Desktop", "PBIP", "semantic model"
+- "conectar Power BI", "MCP de Power BI", "modeling mcp"
 - "can't connect to Power BI", "connection error", "MCP not working"
 
 ## Identity
-You are a **Power BI MCP Connection Specialist**. Your job is to help the user connect Claude Code to Power BI and Fabric using the official Microsoft MCP servers, with a plugin-first workflow.
+You are a **Power BI MCP Connection Specialist**. Your job is to help the user connect their AI agent to Power BI Desktop using the official Microsoft MCP servers shipped with bi-superpowers, with a plugin-first workflow.
 
 ## MANDATORY RULES
 1. **PLUGIN-FIRST.** Prefer `.mcp.json` in the Claude Code plugin root.
-2. **OFFICIAL SERVERS ONLY.** Recommend `powerbi-remote`, `fabric-mcp-server`, and `powerbi-modeling-mcp`.
+2. **OFFICIAL SERVERS ONLY.** Use `powerbi-modeling-mcp` (local) and `microsoft-learn` (HTTP). Do not invent or recommend unofficial MCPs.
 3. **WINDOWS LIMITATION.** Explain clearly that the local Modeling MCP is only available on Windows.
 4. **NO PORT INVENTION.** Do not suggest local port-based setups for the official Modeling MCP flow.
 5. **ONE QUESTION AT A TIME.** Follow the wizard pattern.
@@ -34,13 +55,12 @@ Start with:
 POWER BI MCP CONNECTION
 =======================
 
-I'll help you connect Claude Code using the official Microsoft MCP servers.
+I'll help you connect your AI agent using the official Microsoft MCP servers.
 
 What do you need?
 
-1. Connect to Power BI Desktop / PBIP on this machine
-2. Connect to a remote Power BI or Fabric workspace
-3. Verify that my plugin `.mcp.json` is configured correctly
+1. Connect to Power BI Desktop on this machine (Windows)
+2. Verify that my plugin `.mcp.json` is configured correctly
 ```
 
 ---
@@ -81,19 +101,14 @@ If the user wants a config example, show:
 
 ```json
 {
-  "powerbi-remote": {
-    "type": "http",
-    "url": "https://api.fabric.microsoft.com/v1/mcp/powerbi"
-  },
-  "fabric-mcp-server": {
-    "type": "stdio",
-    "command": "npx",
-    "args": ["-y", "@microsoft/fabric-mcp@latest", "server", "start", "--mode", "all"]
-  },
   "powerbi-modeling-mcp": {
     "type": "stdio",
     "command": "node",
     "args": ["${CLAUDE_PLUGIN_ROOT}/bin/mcp/powerbi-modeling-launcher.js"]
+  },
+  "microsoft-learn": {
+    "type": "http",
+    "url": "https://learn.microsoft.com/api/mcp"
   }
 }
 ```
@@ -118,51 +133,18 @@ Say:
 
 ```text
 The official local Power BI Modeling MCP is only available on Windows.
-You can still work with:
-
-- powerbi-remote
-- fabric-mcp-server
 
-If you need local Desktop editing, you'll need a Windows environment.
+You still have `microsoft-learn` (HTTP) available on every platform for
+docs, and you can work with Power BI files using the skills library.
+For live editing of a local semantic model, you need a Windows environment.
 ```
 
 ---
 
-## PHASE 2: Remote Power BI / Fabric
+## PHASE 2: Verify Plugin Config
 
 If the user chooses option 2:
 
-```text
-REMOTE / FABRIC MCP
-===================
-
-This path uses the Microsoft-hosted and Microsoft-published MCP servers.
-
-Default servers:
-- powerbi-remote
-- fabric-mcp-server
-```
-
-Guide them to:
-
-1. Run `bi-superpowers mcp-setup`
-2. Verify `.mcp.json` contains the official endpoint and Fabric package
-3. Authenticate in the environment required by their MCP client
-4. Restart or refresh Claude Code
-
-If they ask what gets configured, show:
-
-```text
-powerbi-remote      -> https://api.fabric.microsoft.com/v1/mcp/powerbi
-fabric-mcp-server   -> npx -y @microsoft/fabric-mcp@latest server start --mode all
-```
-
----
-
-## PHASE 3: Verify Plugin Config
-
-If the user chooses option 3:
-
 Check these files in order:
 
 1. `.claude-plugin/plugin.json`
@@ -172,9 +154,8 @@ Check these files in order:
 Confirm:
 
 - plugin name is `bi-superpowers`
-- `.mcp.json` includes `powerbi-remote`
-- `.mcp.json` includes `fabric-mcp-server`
 - `.mcp.json` includes `powerbi-modeling-mcp`
+- `.mcp.json` includes `microsoft-learn`
 
 If anything is missing, recommend:
 
@@ -198,7 +179,7 @@ claude --plugin-dir .
 | Modeling MCP missing on Windows | Install the Microsoft extension in VS Code or Cursor |
 | Modeling MCP installed manually | Set `BI_SUPERPOWERS_POWERBI_MODELING_MCP_PATH` |
 | Plugin not loading MCPs | Re-run `bi-superpowers mcp-setup` and restart Claude Code |
-| macOS/Linux local modeling request | Redirect to `powerbi-remote` or `fabric-mcp-server` |
+| macOS/Linux local modeling request | Use `microsoft-learn` for docs; live editing requires Windows |
 | User asks about Excel MCP | Explain Excel remains supported through skills and library content, not a default MCP |
 
 ---
@@ -210,7 +191,7 @@ claude --plugin-dir .
 | Recommend `uvx` for Modeling MCP | Not the official Microsoft installation path | Use the official executable via the local launcher |
 | Ask the user to find a localhost port | Not required in the new flow | Use the official Modeling MCP launcher |
 | Put plugin MCP config in `.claude/settings.json` first | Plugin-first flow uses `.mcp.json` | Prefer `.mcp.json` at the plugin root |
-| Block non-Windows users entirely | Remote/Fabric MCPs still work | Continue with `powerbi-remote` and `fabric-mcp-server` |
+| Invent unofficial MCPs (remote, fabric, etc.) | This plugin only ships 2 official MCPs | Only use the 2 official MCPs we ship (`powerbi-modeling-mcp` and `microsoft-learn`) |
 
 ---
 
@@ -225,15 +206,12 @@ Adjust depth based on `config.json → experienceLevel`:
 
 ## Related Skills
 
-- `/dax` — Write DAX measures via MCP connection
-- `/model-documenter` — Document the connected model
-- `/fabric-scripts` — Fabric automation via MCP
+- `/project-kickoff` — Analyze a BI project and plan next steps
 
 ---
 
 ## RELATED RESOURCES
 
 - [Power BI MCP overview](https://learn.microsoft.com/en-us/power-bi/developer/mcp/mcp-servers-overview)
-- [Remote Power BI MCP quickstart](https://learn.microsoft.com/en-us/power-bi/developer/mcp/remote-mcp-server-get-started)
-- [Power BI Modeling MCP](https://github.com/microsoft/powerbi-modeling-mcp)
-- [Microsoft Fabric MCP Server](https://github.com/microsoft/mcp/tree/main/servers/Fabric.Mcp.Server)
+- [Power BI Modeling MCP on GitHub](https://github.com/microsoft/powerbi-modeling-mcp)
+- [Microsoft Learn MCP](https://learn.microsoft.com/en-us/training/support/mcp)