@luquimbo/bi-superpowers 3.1.1 → 4.1.0

package/bin/commands/build-desktop.js

@@ -4,7 +4,7 @@
  *
  * Builds a .mcpb extension for Claude Desktop by:
  * 1. Copying desktop-extension/ template to a temp directory
- * 2. Copying all 24 skill sources into temp/skills/
+ * 2. Copying every skill source (flat + folder-based) into temp/skills/
  * 3. Installing dependencies
  * 4. Running `npx @anthropic-ai/mcpb pack` to create the .mcpb file
  * 5. Moving the result to the current directory
@@ -18,6 +18,7 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const { execSync } = require('child_process');
+const { loadSkills } = require('../lib/skills');
 
 /** Directory where the npm package is installed */
 const PACKAGE_DIR = path.dirname(path.dirname(__dirname));
@@ -25,8 +26,27 @@ const PACKAGE_DIR = path.dirname(path.dirname(__dirname));
 /** Desktop extension template source */
 const DESKTOP_TEMPLATE_DIR = path.join(PACKAGE_DIR, 'desktop-extension');
 
-/** Skill source files directory */
-const SKILLS_SOURCE_DIR = path.join(PACKAGE_DIR, 'src', 'content', 'skills');
+/**
+ * Bundle skills into the Desktop extension's skills/ directory.
+ *
+ * Handles both flat `src/content/skills/<name>.md` and folder-based
+ * `src/content/skills/<name>/SKILL.md` layouts by flattening each skill
+ * to a single `<name>.md` file inside `skillsOutDir`. The Claude Desktop
+ * MCP server loads those flat files as prompts — `references/` and
+ * `scripts/` are distributed through `super install`, not bundled here.
+ *
+ * @param {string} skillsOutDir - Destination directory (created if missing)
+ * @param {string} packageDir - npm package root containing src/content/skills/
+ * @returns {string[]} Names of skills bundled into skillsOutDir
+ */
+function bundleSkills(skillsOutDir, packageDir) {
+  fs.mkdirSync(skillsOutDir, { recursive: true });
+  const skills = loadSkills({ packageDir });
+  for (const skill of skills) {
+    fs.writeFileSync(path.join(skillsOutDir, `${skill.name}.md`), skill.content);
+  }
+  return skills.map((s) => s.name);
+}
 
 /**
  * Build the .mcpb extension for Claude Desktop.
@@ -34,7 +54,7 @@ const SKILLS_SOURCE_DIR = path.join(PACKAGE_DIR, 'src', 'content', 'skills');
  * @param {string[]} args - CLI arguments
  * @param {Object} config - Command config from CLI
  */
-module.exports = function buildDesktop(_args, _config) {
+function buildDesktop(_args, _config) {
   const outputDir = process.cwd();
 
   console.log(`
@@ -50,7 +70,8 @@ BI Agent Superpowers — Build Desktop Extension
   }
 
   // Verify skills exist
-  if (!fs.existsSync(SKILLS_SOURCE_DIR)) {
+  const skillsSourceDir = path.join(PACKAGE_DIR, 'src', 'content', 'skills');
+  if (!fs.existsSync(skillsSourceDir)) {
     console.error(
       'Error: skill sources not found. Try reinstalling: npm install -g @luquimbo/bi-superpowers'
     );
@@ -71,15 +92,10 @@ BI Agent Superpowers — Build Desktop Extension
       }
     }
 
-    // Copy all skill .md files into temp/skills/
-    const skillsOutDir = path.join(tmpDir, 'skills');
-    fs.mkdirSync(skillsOutDir, { recursive: true });
-
-    const skillFiles = fs.readdirSync(SKILLS_SOURCE_DIR).filter((f) => f.endsWith('.md'));
-    for (const file of skillFiles) {
-      fs.copyFileSync(path.join(SKILLS_SOURCE_DIR, file), path.join(skillsOutDir, file));
-    }
-    console.log(`  Bundled ${skillFiles.length} skills`);
+    // Bundle every skill (flat + folder-based) into temp/skills/
+    const bundledNames = bundleSkills(path.join(tmpDir, 'skills'), PACKAGE_DIR);
+    const skillFiles = bundledNames.map((n) => `${n}.md`);
+    console.log(`  Bundled ${bundledNames.length} skills`);
 
     // Patch template placeholder versions with the real package version
     const pkgVersion = require(path.join(PACKAGE_DIR, 'package.json')).version;
@@ -149,7 +165,7 @@ BI Agent Superpowers — Build Desktop Extension
     2. Go to Settings > Extensions > Install Extension
 
   The extension adds ${skillFiles.length} BI skills as MCP prompts.
-  Use the "setup-mcp" prompt for Power BI/Fabric MCP configuration.
+  Use the "setup-mcp" prompt for Power BI Modeling MCP configuration.
 `);
     } else {
       console.log('\n  Build complete. Check current directory for .mcpb file.');
@@ -165,4 +181,7 @@ BI Agent Superpowers — Build Desktop Extension
       // Ignore cleanup errors
     }
   }
-};
+}
+
+module.exports = buildDesktop;
+module.exports.bundleSkills = bundleSkills;

package/bin/commands/diff.js

@@ -12,6 +12,7 @@
 const fs = require('fs');
 const path = require('path');
 const tui = require('../utils/tui');
+const { readSkillDirectory, normalizeSkillName } = require('../lib/skills');
 
 /**
  * Generate a simple diff between two strings
@@ -122,7 +123,12 @@ function compareFiles(skillPath, generatedPath) {
 function getGeneratedPath(skillName, tool, targetDir) {
   switch (tool) {
     case 'claude-code':
-      return path.join(targetDir, '.claude', 'commands', `${skillName}.md`);
+      // The Claude Code plugin generator (bin/lib/generators/claude-plugin.js)
+      // writes slash commands to `<targetDir>/commands/<skill>.md` — NOT
+      // `.claude/commands/...`. An earlier path here pointed at the old
+      // location and silently made `super scan --tool claude-code`
+      // report every skill as "not-generated".
+      return path.join(targetDir, 'commands', `${skillName}.md`);
     case 'cursor':
       // Cursor uses a single file, can't diff per-skill
       return null;
@@ -249,23 +255,27 @@ function diffCommand(args, config) {
     return;
   }
 
-  // Get skill files to compare
+  // Get skill files to compare. Use the shared skill loader so both
+  // flat (`<name>.md`) and folder-based (`<name>/SKILL.md`) skills
+  // are picked up — a previous version filtered with
+  // `f.endsWith('.md')` and silently dropped every folder-based skill.
+  const allSkills = readSkillDirectory(skillsDir);
+  const skillsByName = new Map(allSkills.map((s) => [s.name, s]));
+  const skillNameByPath = new Map(allSkills.map((s) => [s.path, s.name]));
   let skillFiles = [];
 
   if (options.skill) {
-    const skillName = options.skill.replace('.md', '');
-    const skillPath = path.join(skillsDir, `${skillName}.md`);
-    if (fs.existsSync(skillPath)) {
-      skillFiles = [skillPath];
+    // normalizeSkillName accepts `dax`, `dax.md`, `report-design`, or
+    // `report-design/SKILL.md` and returns the canonical skill name.
+    const skill = skillsByName.get(normalizeSkillName(options.skill));
+    if (skill) {
+      skillFiles = [skill.path];
     } else {
       tui.error(`Skill not found: ${options.skill}`);
       process.exit(1);
     }
   } else {
-    skillFiles = fs
-      .readdirSync(skillsDir)
-      .filter((f) => f.endsWith('.md'))
-      .map((f) => path.join(skillsDir, f));
+    skillFiles = allSkills.map((s) => s.path);
   }
 
   if (skillFiles.length === 0) {
@@ -276,9 +286,11 @@ function diffCommand(args, config) {
   tui.info(`Comparing ${skillFiles.length} skill(s) for ${options.tool}...`);
   tui.section('Changes');
 
-  // Compare each skill
+  // Compare each skill. Use the loader-built map to derive the canonical
+  // skill name — for folder-based skills the path is `<folder>/SKILL.md`
+  // and `path.basename(...)` would return `SKILL`, breaking the diff.
   const results = skillFiles.map((skillPath) => {
-    const skillName = path.basename(skillPath, '.md');
+    const skillName = skillNameByPath.get(skillPath) || path.basename(skillPath, '.md');
     const generatedPath = getGeneratedPath(skillName, options.tool, targetDir);
 
     if (!generatedPath) {
@@ -324,4 +336,10 @@ function diffCommand(args, config) {
   }
 }
 
-module.exports = diffCommand;
+// Expose primitives for tests (B3 — replace fake tests with real ones).
+module.exports = Object.assign(diffCommand, {
+  generateDiff,
+  compareFiles,
+  getGeneratedPath,
+  parseArgs,
+});

package/bin/commands/install.js

@@ -1,18 +1,28 @@
 /**
- * Install Command - Multi-agent skill installer
- * ===============================================
+ * Install Command — Multi-agent skill + MCP installer
+ * =====================================================
  *
- * Instala los skills de BI Agent Superpowers en los directorios
- * correctos para cada agente AI. Inspirado en el CLI `npx skills` de
- * Vercel Labs.
+ * Installs the bi-superpowers skills and Microsoft MCP servers into
+ * every supported AI coding agent:
+ *   - Claude Code
+ *   - GitHub Copilot
+ *   - Codex (OpenAI)
+ *   - Gemini CLI
+ *   - Kilo Code
  *
- * Los skills siempre se instalan a nivel de usuario (~/) para no
- * contaminar el repo del proyecto. El usuario los obtiene una vez
- * y los comparte con todos sus proyectos.
+ * Everything is installed at the user level (~/) so it applies across
+ * all projects without polluting any specific repo. Skills land in
+ * ~/.agents/skills/ (universal path) and each agent's own skill dir is
+ * symlinked to that universal copy. MCPs are written to each agent's
+ * expected config file in the format that agent requires (JSON for
+ * most, TOML for Codex) — see `lib/mcp-config.js` for details.
  *
- * Open source: todo el contenido ship gratis con el paquete npm.
+ * Fully open source (MIT). The user-facing messages are in Spanish to
+ * match the primary Spanish-speaking audience of the project; code
+ * comments and JSDoc stay in English so contributors from any language
+ * can work on the source.
  *
- * Uso:
+ * Usage:
  *   npx @luquimbo/bi-superpowers install
  *   super install
  *   super install --agent claude-code --agent codex
@@ -29,9 +39,10 @@ const { AGENTS, UNIVERSAL_DIR } = require('../lib/agents');
 const { writeMcpConfigForAgent } = require('../lib/mcp-config');
 
 /**
- * Detecta qué agentes están instalados revisando sus directorios de config.
- * @param {string} baseDir - Directorio base (home del usuario)
- * @returns {string[]} IDs de agentes detectados
+ * Detect which agents are installed by checking their config directories.
+ * Used in the interactive installer to pre-select the detected agents.
+ * @param {string} baseDir - Base directory to scan (typically the user's home)
+ * @returns {string[]} IDs of detected agents
  */
 function detectAgents(baseDir) {
   const detected = [];
@@ -46,7 +57,7 @@ function detectAgents(baseDir) {
 }
 
 /**
- * Crea una interface de readline para prompts interactivos.
+ * Create a readline interface for interactive prompts.
  */
 function createReadline() {
   return readline.createInterface({
@@ -56,7 +67,7 @@ function createReadline() {
 }
 
 /**
- * Envuelve una pregunta de readline en una Promise.
+ * Promise-wrapped readline question.
  */
 function prompt(rl, question) {
   return new Promise((resolve) => {
@@ -65,11 +76,11 @@ function prompt(rl, question) {
 }
 
 /**
- * Muestra una lista numerada y deja al usuario elegir múltiples items.
+ * Render a numbered multi-select list and wait for the user's choice.
  * @param {readline.Interface} rl
  * @param {Array<{id: string, name: string}>} items
- * @param {string[]} preselected - IDs preseleccionados
- * @returns {Promise<string[]>} IDs seleccionados
+ * @param {string[]} preselected - IDs that should default to selected
+ * @returns {Promise<string[]>} Selected IDs
  */
 async function selectMultiple(rl, items, preselected = []) {
   items.forEach((item, i) => {
@@ -77,8 +88,8 @@ async function selectMultiple(rl, items, preselected = []) {
     console.log(`  ${i + 1}) ${marker} ${item.name}`);
   });
   console.log();
-  console.log('  Ingresa números separados por comas (ej: 1,2,3)');
-  console.log('  Presiona Enter para los detectados, o "a" para todos');
+  console.log('  Ingresá números separados por comas (ej: 1,2,3)');
+  console.log('  Presioná Enter para los detectados, o "a" para todos');
 
   const answer = await prompt(rl, '\n  > ');
 
@@ -99,10 +110,10 @@ async function selectMultiple(rl, items, preselected = []) {
 }
 
 /**
- * Copia un directorio de skill recursivamente.
- * Los errores de fs se propagan al caller para manejo centralizado.
- * @param {string} srcDir - Directorio de skill fuente (contiene SKILL.md)
- * @param {string} destDir - Directorio destino
+ * Recursively copy a skill directory (SKILL.md + references/ + scripts/).
+ * Filesystem errors propagate to the caller for centralized handling.
+ * @param {string} srcDir - Source skill directory
+ * @param {string} destDir - Destination directory
  */
 function copySkillDir(srcDir, destDir) {
   if (!fs.existsSync(destDir)) {
@@ -123,11 +134,12 @@ function copySkillDir(srcDir, destDir) {
 }
 
 /**
- * Formatea un error de filesystem con hint útil según el código.
+ * Format a filesystem error with a user-friendly hint based on the code.
+ * Keeps the underlying error message so debugging is still possible.
  */
 function formatFsError(err, context) {
   const codeHints = {
-    EACCES: 'Permiso denegado. Revisa los permisos del directorio.',
+    EACCES: 'Permiso denegado. Revisá los permisos del directorio.',
     EPERM: 'Operación no permitida. En Windows, probá ejecutar como Administrador.',
     ENOSPC: 'No hay espacio en disco.',
     ENOENT: 'Archivo o directorio no existe.',
@@ -138,8 +150,9 @@ function formatFsError(err, context) {
 }
 
 /**
- * Parsea las flags de CLI y devuelve un objeto de opciones.
- * Valida que cada --agent/-a tenga un valor asociado.
+ * Parse CLI arguments into an options object.
+ * Validates that each --agent / -a flag is followed by a real value
+ * so we don't silently accept dangling flags.
  */
 function parseArgs(args) {
   const opts = {
@@ -152,7 +165,7 @@ function parseArgs(args) {
     if (args[i] === '--agent' || args[i] === '-a') {
       const next = args[i + 1];
       if (next === undefined || next.startsWith('-')) {
-        // Falta valor para --agent; avisamos y seguimos sin ese flag
+        // Missing value — warn and skip this flag instead of crashing.
         console.warn(`⚠ Flag ${args[i]} sin valor. Uso: ${args[i]} <agente-id>. Ignorando.`);
         continue;
       }
@@ -165,8 +178,8 @@ function parseArgs(args) {
 }
 
 /**
- * Resuelve qué agentes instalar según las flags y el modo interactivo.
- * @returns {Promise<string[]>} IDs de agentes seleccionados
+ * Resolve which agents to install based on flags or interactive prompt.
+ * @returns {Promise<string[]>} IDs of the selected agents
  */
 async function resolveSelectedAgents(opts, baseDir, chalk) {
   if (opts.isAll) {
@@ -187,7 +200,7 @@ async function resolveSelectedAgents(opts, baseDir, chalk) {
     return Object.keys(AGENTS);
   }
 
-  // Modo interactivo
+  // Interactive mode — detect installed agents and prompt the user.
   const detected = detectAgents(baseDir);
   console.log(chalk.cyan('  Seleccioná los agentes donde querés instalar:\n'));
 
@@ -205,11 +218,13 @@ async function resolveSelectedAgents(opts, baseDir, chalk) {
 }
 
 /**
- * Instala los skills en los directorios seleccionados.
+ * Copy skills into the universal path first, then either symlink or copy
+ * each selected agent's skill directory to point at the universal copy.
  * @returns {{agentResults: Array, copyFallbacks: number}}
  */
 function performInstall(skillsSourceDir, skillDirs, selectedAgents, baseDir) {
-  // Siempre instalamos primero en el path universal
+  // Always install to the universal path first. This is the source of
+  // truth that all other agent dirs symlink to.
   const universalTarget = path.join(baseDir, UNIVERSAL_DIR);
   for (const skill of skillDirs) {
     const src = path.join(skillsSourceDir, skill);
@@ -217,17 +232,17 @@ function performInstall(skillsSourceDir, skillDirs, selectedAgents, baseDir) {
     copySkillDir(src, dest);
   }
 
-  // Symlinks o copias para los directorios específicos de agentes
   const agentResults = [];
   let copyFallbacks = 0;
 
   for (const agentId of selectedAgents) {
     const agent = AGENTS[agentId];
-    if (agent.dir === UNIVERSAL_DIR) continue; // Ya manejado por el universal
+    if (agent.dir === UNIVERSAL_DIR) continue; // Already handled above.
 
     const agentTarget = path.join(baseDir, agent.dir);
 
-    // Si ya existe y no es symlink, copiamos ahí directamente
+    // If a real directory already exists (not a symlink), copy into it
+    // directly so we don't destroy user data.
     if (fs.existsSync(agentTarget) && !fs.lstatSync(agentTarget).isSymbolicLink()) {
       for (const skill of skillDirs) {
         copySkillDir(path.join(skillsSourceDir, skill), path.join(agentTarget, skill));
@@ -241,22 +256,23 @@ function performInstall(skillsSourceDir, skillDirs, selectedAgents, baseDir) {
       fs.mkdirSync(parentDir, { recursive: true });
     }
 
-    // Eliminar symlink existente si hay uno (para poder recrearlo)
+    // Remove any pre-existing symlink so we can recreate it cleanly.
     if (fs.existsSync(agentTarget) || fs.lstatSync(agentTarget, { throwIfNoEntry: false })) {
       try {
         fs.unlinkSync(agentTarget);
       } catch (_) {
-        /* no existe, seguimos */
+        /* target didn't exist after all — that's fine */
       }
     }
 
     try {
-      // Symlink relativo del dir del agente al dir universal
+      // Relative symlink from the agent's dir to the universal dir.
       const relPath = path.relative(parentDir, universalTarget);
       fs.symlinkSync(relPath, agentTarget);
       agentResults.push({ agent: agent.name, method: 'symlinked', dir: agent.dir });
     } catch (symlinkErr) {
-      // Fallback a copia si el symlink falla (ej: Windows sin permisos)
+      // Windows without admin can't create symlinks. Fall back to copy
+      // and remember so we can warn the user at the end.
       copyFallbacks++;
       if (!fs.existsSync(agentTarget)) {
         fs.mkdirSync(agentTarget, { recursive: true });
@@ -277,18 +293,18 @@ function performInstall(skillsSourceDir, skillDirs, selectedAgents, baseDir) {
 }
 
 /**
- * Configura los 2 MCP servers (powerbi-modeling + microsoft-learn)
- * para cada agente seleccionado escribiendo el config file en el path
- * y formato que cada agente espera.
+ * Configure the 2 MCP servers (powerbi-modeling + microsoft-learn)
+ * for each selected agent by writing the config file in the path and
+ * format that agent expects.
  *
- * Los errores por agente no interrumpen el flujo: se recolectan en los
- * resultados para mostrarlos al final y que el caller decida qué hacer
- * con el exit code.
+ * Per-agent errors don't abort the whole flow: they're collected in the
+ * results array so the caller can display them and decide on the exit
+ * code.
  *
- * @param {string[]} selectedAgents - IDs de agentes seleccionados
- * @param {string} packageDir - Absolute path al paquete instalado
- * @param {string} baseDir - Home directory del usuario (para display)
- * @param {Object} chalk - chalk instance para colorear output
+ * @param {string[]} selectedAgents - Agent IDs to configure
+ * @param {string} packageDir - Absolute path to the installed package
+ * @param {string} baseDir - User's home directory (for display)
+ * @param {Object} chalk - chalk instance for colored output
  * @returns {Array<{agent: string, success: boolean, configPath?: string, error?: string}>}
  */
 function configureMcpsForAgents(selectedAgents, packageDir, baseDir, chalk) {
@@ -315,9 +331,9 @@ function configureMcpsForAgents(selectedAgents, packageDir, baseDir, chalk) {
 }
 
 /**
- * Handler principal del comando install.
- * @param {string[]} args - Argumentos CLI
- * @param {Object} config - Config del comando desde el CLI
+ * Main handler for the `super install` command.
+ * @param {string[]} args - CLI arguments
+ * @param {Object} config - Command config from the CLI (packageDir, version)
  */
 async function installCommand(args, config) {
   const chalk = require('chalk');
@@ -325,10 +341,11 @@ async function installCommand(args, config) {
 
   const opts = parseArgs(args);
 
-  // Siempre a nivel usuario (home) para proteger contenido licenciado
+  // Always install at the user level (home directory) — skills and MCPs
+  // apply across all projects without polluting any specific repo.
   const baseDir = os.homedir();
 
-  // Localizar los skills del paquete
+  // Locate the skills inside the installed package.
   const packageDir = config.packageDir || path.dirname(path.dirname(__dirname));
   const skillsSourceDir = path.join(packageDir, 'skills');
 
@@ -341,7 +358,7 @@ async function installCommand(args, config) {
     process.exit(1);
   }
 
-  // Leer skills disponibles
+  // Read the available skill directories from the package.
   let skillDirs;
   try {
     skillDirs = fs
@@ -355,7 +372,7 @@ async function installCommand(args, config) {
     process.exit(1);
   }
 
-  // Header
+  // Header box shown at the top of every install run.
   console.log(
     boxen(
       chalk.bold.cyan('BI Agent Superpowers') +
@@ -373,7 +390,7 @@ async function installCommand(args, config) {
   console.log(chalk.gray(`  Ruta de instalación: ~/${UNIVERSAL_DIR}/`));
   console.log(chalk.gray(`  Skills: ${skillDirs.length} disponibles\n`));
 
-  // Resolver qué agentes instalar
+  // Resolve which agents to configure.
   const selectedAgents = await resolveSelectedAgents(opts, baseDir, chalk);
 
   if (selectedAgents.length === 0) {
@@ -387,7 +404,7 @@ async function installCommand(args, config) {
     )
   );
 
-  // Instalar skills
+  // Phase 1: copy skills and create symlinks per agent.
   let agentResults;
   let copyFallbacks;
   try {
@@ -399,20 +416,20 @@ async function installCommand(args, config) {
     process.exit(1);
   }
 
-  // Universal skills path
+  // Report on the universal skills path.
   const universalAgents = selectedAgents
     .filter((id) => AGENTS[id] && AGENTS[id].dir === UNIVERSAL_DIR)
     .map((id) => AGENTS[id].name);
   const universalSuffix = universalAgents.length > 0 ? ` — ${universalAgents.join(', ')}` : '';
   console.log(chalk.green(`  ✓ ${UNIVERSAL_DIR}/ (${skillDirs.length} skills)${universalSuffix}`));
 
-  // Skills por agente
+  // Report per agent.
   for (const result of agentResults) {
     const icon = result.method === 'symlinked' ? '→' : '✓';
     console.log(chalk.green(`  ${icon} ${result.dir}/ (${result.method}) — ${result.agent}`));
   }
 
-  // Aviso si hubo fallbacks de symlink a copia
+  // Warn if any agent fell back from symlink to copy.
   if (copyFallbacks > 0) {
     console.log(
       chalk.yellow(
@@ -423,10 +440,10 @@ async function installCommand(args, config) {
     );
   }
 
-  // Configurar MCPs para cada agente seleccionado
+  // Phase 2: write the 2 MCP configs per agent.
   const mcpResults = configureMcpsForAgents(selectedAgents, packageDir, baseDir, chalk);
 
-  // Resumen
+  // Build the final summary box.
   const totalAgents = agentResults.length + (universalAgents.length > 0 ? 1 : 0);
   const mcpSuccess = mcpResults.filter((r) => r.success).length;
   const mcpFailures = mcpResults.filter((r) => !r.success);
@@ -453,11 +470,15 @@ async function installCommand(args, config) {
         '\n' +
         chalk.gray('Reiniciá tu agente AI para que tome los MCPs nuevos.') +
         '\n\n' +
-        chalk.gray('Los 2 skills disponibles:') +
+        chalk.gray('Los 4 skills disponibles:') +
         '\n' +
-        chalk.gray('  /project-kickoff  — Analizá tu proyecto BI') +
+        chalk.gray('  /bi-start         — Arrancar una sesión: menú + update + conexión') +
         '\n' +
-        chalk.gray('  /pbi-connect      — Conectá Claude a Power BI Desktop'),
+        chalk.gray('  /project-kickoff  — Analizá tu proyecto BI (proyecto nuevo)') +
+        '\n' +
+        chalk.gray('  /pbi-connect      — Conectá tu agente a Power BI Desktop') +
+        '\n' +
+        chalk.gray('  /report-design    — Generá reportes PBIR para Power BI Desktop (Windows)'),
       {
         padding: 1,
         margin: { top: 1 },
@@ -468,14 +489,14 @@ async function installCommand(args, config) {
   );
 
   if (hasFailures) {
-    // Non-zero exit so CI/scripts know something went wrong, but skills
-    // still got installed — we use exit code 2 to distinguish from total
-    // failure (exit 1).
+    // Non-zero exit so CI/scripts know something went wrong. Exit code 2
+    // distinguishes partial failure (skills ok, some MCPs failed) from
+    // total failure (exit code 1).
     process.exitCode = 2;
   }
 }
 
-// Exports internos para testing
+// Internal exports for testing.
 module.exports = installCommand;
 module.exports.parseArgs = parseArgs;
 module.exports.detectAgents = detectAgents;