skillops-cli 1.3.1 → 1.3.3

package/dist/index.d.ts

@@ -8,7 +8,7 @@ import { z } from 'zod';
  * telemetry and Multi-Runtime Transpilation lockfiles.
  */
 
-declare const SKILLOPS_VERSION = "1.3.1";
+declare const SKILLOPS_VERSION = "1.3.3";
 /**
  * Count whitespace-delimited words in text.
  */
@@ -2165,7 +2165,7 @@ declare const COMMAND_HELP_SPECS: readonly CommandHelpSpec[];
  */
 declare function findCommandHelpSpec(commandOrAlias: string): CommandHelpSpec | undefined;
 /**
- * Render the compact, emoji-free 3-Pillar Framework & Library global help tree (`npx skillops-cli --help`).
+ * Render the compact, emoji-free global help tree (`npx skillops-cli --help`) focused on the 5 core commands.
  */
 declare function renderGlobalHelp(version: string, colorEnabled?: boolean): string;
 /**
@@ -2173,6 +2173,60 @@ declare function renderGlobalHelp(version: string, colorEnabled?: boolean): stri
  */
 declare function renderCommandHelp(spec: CommandHelpSpec, version: string, colorEnabled?: boolean): string;
 
+/**
+ * Zero-dependency interactive terminal multi-select prompt (`src/ui/prompt.ts`).
+ *
+ * Supports:
+ * - Horizontal tabs (`←`/`→` or `Tab`) separating `Skills` and `Agents`
+ * - Vertical navigation (`↑`/`↓` or `j`/`k`)
+ * - Real-time keyword filtering (`/` to search, `Backspace` to edit, `Esc` to clear)
+ * - `Space` to toggle selection across tabs, `a` to toggle all in current tab, `Enter` to confirm
+ */
+type MultiSelectTab = "skill" | "agent";
+interface MultiSelectOption {
+    readonly value: string;
+    readonly label: string;
+    readonly kind?: "skill" | "agent" | "ide";
+    readonly hint?: string;
+    readonly initialSelected?: boolean;
+}
+interface MultiSelectState {
+    readonly options: readonly MultiSelectOption[];
+    readonly activeTab: MultiSelectTab;
+    readonly cursor: number;
+    readonly selected: ReadonlySet<string>;
+    readonly searchMode: boolean;
+    readonly searchQuery: string;
+    readonly status: "active" | "submitted" | "cancelled";
+}
+interface RenderMultiSelectOptions {
+    readonly subtitle?: string;
+    readonly targetHint?: string;
+    readonly maxVisible?: number;
+    readonly colorEnabled?: boolean;
+}
+/**
+ * Return the filtered options for a given tab (`skill` or `agent`) and active `searchQuery`.
+ */
+declare function getFilteredTabOptions(state: MultiSelectState, tab?: MultiSelectTab): MultiSelectOption[];
+/**
+ * Initialize a deterministic multi-select state from a list of options.
+ */
+declare function createMultiSelectState(options: readonly MultiSelectOption[]): MultiSelectState;
+/**
+ * Pure state reducer for keyboard input in the tabbed + searchable multi-select TUI.
+ */
+declare function applyMultiSelectKey(state: MultiSelectState, key: string): MultiSelectState;
+/**
+ * Render a single frame of the tabbed + searchable multi-select tree prompt (guaranteed <= 78 columns).
+ */
+declare function renderMultiSelectFrame(title: string, state: MultiSelectState, options?: RenderMultiSelectOptions): string;
+/**
+ * Run an interactive multi-select prompt in a TTY terminal.
+ * Returns the array of selected values, or `null` if cancelled by user.
+ */
+declare function runMultiSelectPrompt(title: string, options: readonly MultiSelectOption[], renderOpts?: RenderMultiSelectOptions): Promise<string[] | null>;
+
 /**
  * SkillOps Zero-Dependency Terminal UI (TUI) Aesthetic Engine.
  *
@@ -2292,4 +2346,4 @@ declare const DEFAULT_VALID_COMMANDS: readonly string[];
  */
 declare function suggestCommand(unknownCommand: string, validCommands?: readonly string[]): string | null;
 
-export { ALL_RUNTIME_TARGETS, type AddOptions, type AnalyzeTokenEconomyOptions, type AuditCatalogOptions, type BadgeType, type BenchmarkArm, BenchmarkArmSchema, type BenchmarkDelta, BenchmarkDeltaSchema, type BoxOptions, COMMAND_HELP_SPECS, CORE_RUNTIME_TARGETS, type CatalogEvalSummary, CatalogEvalSummarySchema, type CatalogItemInfo, type CatalogSearchMatch, type CatalogSearchReport, type CatalogTokenBudgetSummary, type CatalogTrack, CatalogTrackSchema, type CleanOptions, type CollisionPair, CollisionPairSchema, type CollisionReport, CollisionReportSchema, type CollisionSeverity, CollisionSeveritySchema, type ColorOverrideOptions, type CommandHelpSpec, type CommandOptionSpec, DEFAULT_VALID_COMMANDS, type DiagnoseRepositoryOptions, type DoctorCheckItem, type DoctorReport, type EvalAssertion, EvalAssertionSchema, type EvalCase, EvalCaseSchema, ExitCode, type ExitCodeValue, type HarnessCategory, type HarnessInspectionEntry, type HarnessInspectionReport, type HarnessSkillFormat, type JsonRpcRequest, type JsonRpcResponse, type LoadedSkillOpsConfigResult, type LockfileArtifactDiagnostic, type McpConfigAction, type McpServerContext, type McpSetupOptions, type McpSetupReport, type NextStepHint, type ParseSkillOptions, type ParsedSkillDirectory, type ParsedSubagentFile, type QuickstartOptions, type QuickstartReport, RUNTIME_HARNESS_SPECS, type RemoveOptions, RepoFingerprinter, type RepoProfile, RepoProfileSchema, type RouteOptions, type RoutedBundle, RoutedBundleSchema, type RoutingSignals, RoutingSignalsSchema, type RuntimeHarnessSpec, type RuntimeTarget, RuntimeTargetSchema, SKILLOPS_VERSION, type ScaffoldOptions, type ScaffoldResult, type ScoredSkill, ScoredSkillSchema, type ScriptEntrypoint, ScriptEntrypointSchema, type SkillBenchmark, SkillBenchmarkSchema, type SkillEntrypoints, SkillEntrypointsSchema, type SkillEvalSuite, SkillEvalSuiteSchema, type SkillManifest, type SkillManifestInput, SkillManifestSchema, type SkillOpsConfig, SkillOpsConfigSchema, type SkillOpsDetectedStackConfig, SkillOpsDetectedStackConfigSchema, type SkillOpsTokenEconomyConfig, SkillOpsTokenEconomyConfigSchema, type SkillTokenBudgetAudit, type SkippedSkill, SkippedSkillSchema, type SubagentManifest, SubagentManifestSchema, type SubagentTokenBudgetAudit, type SyncLockEntry, SyncLockEntrySchema, type SyncLockfile, SyncLockfileSchema, type SyncOptions, type SyncReport, SyncReportSchema, type SyncedArtifact, SyncedArtifactSchema, type TableOptions, type TokenBarOptions, type TokenEconomyReport, TokenEconomyReportSchema, type TokenFileCategory, TokenFileCategorySchema, type TokenFileEntry, TokenFileEntrySchema, type TokenWasteHotspot, TokenWasteHotspotSchema, addSkillOrSubagent, analyzeRepoTokenEconomy, auditCatalog, auditCatalogTokenBudgets, auditSkillTokenBudget, auditSubagentTokenBudget, classifyCollisionSeverity, cleanSyncedArtifacts, compileSkillBundle, computeCollisionMatrix, computeFeatureCosine, computeIdfWeights, computeSha256, countWords, createCollisionPair, createCollisionReport, createSkillManifest, createSubagentManifest, detectInstalledHarnesses, diagnoseRepository, discoverSkillDirectories, discoverSubagentFiles, estimateTokenCount, evaluateCatalog, evaluateSkillDirectory, extractSkillFeatures, findCommandHelpSpec, fingerprintRepository, formatBadge, formatCatalogItemInfo, formatCatalogSearchReport, formatDoctorReport, formatEvalSummary, formatHarnessInspectionReport, formatMcpSetupReport, formatQuickstartReport, formatRoutedBundle, formatScaffoldReport, formatSyncReport, formatTokenEconomyReport, handleMcpJsonRpcRequest, inspectCatalogItem, inspectHarnesses, isColorEnabled, levenshteinDistance, loadSkillOpsConfig, normalizePackageName, padVisible, parseSkillDirectory, parseSkillMdFile, parseSubagentFile, parseSubagentMdFile, removeSkillOrSubagent, renderAiUsageGuide, renderBox, renderCodexAgentsIndex, renderCommandHelp, renderGlobalHelp, renderHeaderBanner, renderNextSteps, renderProgressBar, renderSectionHeader, renderStep, renderTable, renderTokenBar, resolveRuntimeTargets, routeRepository, runQuickstart, scaffoldFrameworkItem, scoreSkillAgainstProfile, searchCatalog, setupMcpForHarnesses, splitFrontmatter, startMcpStdioServer, stripAnsi, stripCodexAgentsBlock, stripNegativeTriggerClauses, style, suggestCommand, syncRepository, tokenizeRoutingText, visibleLength };
+export { ALL_RUNTIME_TARGETS, type AddOptions, type AnalyzeTokenEconomyOptions, type AuditCatalogOptions, type BadgeType, type BenchmarkArm, BenchmarkArmSchema, type BenchmarkDelta, BenchmarkDeltaSchema, type BoxOptions, COMMAND_HELP_SPECS, CORE_RUNTIME_TARGETS, type CatalogEvalSummary, CatalogEvalSummarySchema, type CatalogItemInfo, type CatalogSearchMatch, type CatalogSearchReport, type CatalogTokenBudgetSummary, type CatalogTrack, CatalogTrackSchema, type CleanOptions, type CollisionPair, CollisionPairSchema, type CollisionReport, CollisionReportSchema, type CollisionSeverity, CollisionSeveritySchema, type ColorOverrideOptions, type CommandHelpSpec, type CommandOptionSpec, DEFAULT_VALID_COMMANDS, type DiagnoseRepositoryOptions, type DoctorCheckItem, type DoctorReport, type EvalAssertion, EvalAssertionSchema, type EvalCase, EvalCaseSchema, ExitCode, type ExitCodeValue, type HarnessCategory, type HarnessInspectionEntry, type HarnessInspectionReport, type HarnessSkillFormat, type JsonRpcRequest, type JsonRpcResponse, type LoadedSkillOpsConfigResult, type LockfileArtifactDiagnostic, type McpConfigAction, type McpServerContext, type McpSetupOptions, type McpSetupReport, type MultiSelectOption, type MultiSelectState, type MultiSelectTab, type NextStepHint, type ParseSkillOptions, type ParsedSkillDirectory, type ParsedSubagentFile, type QuickstartOptions, type QuickstartReport, RUNTIME_HARNESS_SPECS, type RemoveOptions, type RenderMultiSelectOptions, RepoFingerprinter, type RepoProfile, RepoProfileSchema, type RouteOptions, type RoutedBundle, RoutedBundleSchema, type RoutingSignals, RoutingSignalsSchema, type RuntimeHarnessSpec, type RuntimeTarget, RuntimeTargetSchema, SKILLOPS_VERSION, type ScaffoldOptions, type ScaffoldResult, type ScoredSkill, ScoredSkillSchema, type ScriptEntrypoint, ScriptEntrypointSchema, type SkillBenchmark, SkillBenchmarkSchema, type SkillEntrypoints, SkillEntrypointsSchema, type SkillEvalSuite, SkillEvalSuiteSchema, type SkillManifest, type SkillManifestInput, SkillManifestSchema, type SkillOpsConfig, SkillOpsConfigSchema, type SkillOpsDetectedStackConfig, SkillOpsDetectedStackConfigSchema, type SkillOpsTokenEconomyConfig, SkillOpsTokenEconomyConfigSchema, type SkillTokenBudgetAudit, type SkippedSkill, SkippedSkillSchema, type SubagentManifest, SubagentManifestSchema, type SubagentTokenBudgetAudit, type SyncLockEntry, SyncLockEntrySchema, type SyncLockfile, SyncLockfileSchema, type SyncOptions, type SyncReport, SyncReportSchema, type SyncedArtifact, SyncedArtifactSchema, type TableOptions, type TokenBarOptions, type TokenEconomyReport, TokenEconomyReportSchema, type TokenFileCategory, TokenFileCategorySchema, type TokenFileEntry, TokenFileEntrySchema, type TokenWasteHotspot, TokenWasteHotspotSchema, addSkillOrSubagent, analyzeRepoTokenEconomy, applyMultiSelectKey, auditCatalog, auditCatalogTokenBudgets, auditSkillTokenBudget, auditSubagentTokenBudget, classifyCollisionSeverity, cleanSyncedArtifacts, compileSkillBundle, computeCollisionMatrix, computeFeatureCosine, computeIdfWeights, computeSha256, countWords, createCollisionPair, createCollisionReport, createMultiSelectState, createSkillManifest, createSubagentManifest, detectInstalledHarnesses, diagnoseRepository, discoverSkillDirectories, discoverSubagentFiles, estimateTokenCount, evaluateCatalog, evaluateSkillDirectory, extractSkillFeatures, findCommandHelpSpec, fingerprintRepository, formatBadge, formatCatalogItemInfo, formatCatalogSearchReport, formatDoctorReport, formatEvalSummary, formatHarnessInspectionReport, formatMcpSetupReport, formatQuickstartReport, formatRoutedBundle, formatScaffoldReport, formatSyncReport, formatTokenEconomyReport, getFilteredTabOptions, handleMcpJsonRpcRequest, inspectCatalogItem, inspectHarnesses, isColorEnabled, levenshteinDistance, loadSkillOpsConfig, normalizePackageName, padVisible, parseSkillDirectory, parseSkillMdFile, parseSubagentFile, parseSubagentMdFile, removeSkillOrSubagent, renderAiUsageGuide, renderBox, renderCodexAgentsIndex, renderCommandHelp, renderGlobalHelp, renderHeaderBanner, renderMultiSelectFrame, renderNextSteps, renderProgressBar, renderSectionHeader, renderStep, renderTable, renderTokenBar, resolveRuntimeTargets, routeRepository, runMultiSelectPrompt, runQuickstart, scaffoldFrameworkItem, scoreSkillAgainstProfile, searchCatalog, setupMcpForHarnesses, splitFrontmatter, startMcpStdioServer, stripAnsi, stripCodexAgentsBlock, stripNegativeTriggerClauses, style, suggestCommand, syncRepository, tokenizeRoutingText, visibleLength };

package/dist/index.js

@@ -2,7 +2,7 @@
 import fs from "fs";
 import YAML from "yaml";
 import { z } from "zod";
-var SKILLOPS_VERSION = "1.3.1";
+var SKILLOPS_VERSION = "1.3.3";
 var SKILL_NAME_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 var SEMVER_REGEX = /^\d+\.\d+\.\d+$/;
 var FRONTMATTER_REGEX = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
@@ -5131,45 +5131,56 @@ function renderGlobalHelp(version, colorEnabled) {
   const c = colorEnabled;
   const bar = style.dim("\u2502", c);
   const banner = renderHeaderBanner(
-    "Framework & Library for AI Skills & Subagents",
+    "Skills & Agents Library for AI Coding IDEs",
     {
       version,
       colorEnabled: c
     }
   );
-  const formatCmdSection = (pillar) => {
-    const specs = COMMAND_HELP_SPECS.filter((s) => s.pillar === pillar);
-    return specs.map((s) => {
-      const aliasPart = s.aliases.length > 0 ? style.dim(` (${s.aliases.join(", ")})`, c) : "";
-      const cmdCol = padVisible(
-        `${style.bold(style.cyan(s.name, c), c)}${aliasPart}`,
-        23,
-        "left"
-      );
-      return `${bar}  ${cmdCol}${s.summary}`;
-    }).join("\n");
-  };
+  const coreCmds = [
+    {
+      cmd: "add [name...]",
+      desc: "Import Skills or Agents (interactive if no name given)"
+    },
+    {
+      cmd: "search <query>",
+      desc: "Search Skills & Agents by keyword, stack, or domain"
+    },
+    {
+      cmd: "list [query]",
+      desc: "List or filter available Skills & Agents in catalog"
+    },
+    {
+      cmd: "info <name>",
+      desc: "View details and how to use a Skill or Agent"
+    },
+    {
+      cmd: "remove <name>",
+      desc: "Remove an imported Skill or Agent from your project"
+    },
+    {
+      cmd: "init",
+      desc: "Auto-detect stack & IDE and import recommended bundle"
+    }
+  ];
+  const cmdRows = coreCmds.map(
+    (item) => `${bar}  ${padVisible(style.bold(style.cyan(item.cmd, c), c), 18, "left")}${item.desc}`
+  ).join("\n");
   return [
     banner,
-    `${bar}  Usage: npx skillops-cli <command> [options]`,
-    renderSectionHeader("Quickstart (Library + Framework)", c),
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.green("npx skillops-cli quickstart", c), c)}          ${style.dim("\u2014 Detect stack, sync Skills & MCP", c)}`,
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.cyan("npx skillops-cli info <name>", c), c)}         ${style.dim("\u2014 Inspect Skill/Subagent & usage", c)}`,
-    `${bar}  ${style.dim("$", c)} ${style.bold(style.magenta("npx skillops-cli create skill <name>", c), c)} ${style.dim("\u2014 Scaffold a custom Skill", c)}`,
-    renderSectionHeader("1. Library of High-End Skills & Subagents", c),
-    formatCmdSection("library"),
-    renderSectionHeader(
-      "2. Framework for Building Custom Skills & Subagents",
-      c
-    ),
-    formatCmdSection("framework"),
-    renderSectionHeader(
-      "3. Universal Runtime Sync, Token Economy & Diagnostics",
-      c
-    ),
-    formatCmdSection("runtime"),
+    `${bar}  Usage: skillops <command> [options]`,
+    renderSectionHeader("Commands", c),
+    cmdRows,
+    renderSectionHeader("Options", c),
+    `${bar}  ${padVisible(style.cyan("-t, --target <ide>", c), 22, "left")}AI IDE (cursor, claude, copilot, windsurf, auto)`,
+    `${bar}  ${padVisible(style.cyan("-p, --project <dir>", c), 22, "left")}Project folder (default: current directory)`,
+    `${bar}  ${padVisible(style.cyan("--all", c), 22, "left")}Import all 10 Skills & 9 Agents`,
+    renderSectionHeader("Examples", c),
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops add", c)}                                  ${style.dim("\u2014 Interactive selector", c)}`,
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops add bug-reproducer-tdd red-team-breaker", c)} ${style.dim("\u2014 Direct import", c)}`,
+    `${bar}  ${style.dim("$", c)} ${style.green("skillops list", c)}                                 ${style.dim("\u2014 Browse catalog", c)}`,
     bar,
-    `${style.dim("\u2570\u2500", c)} ${style.bold("Global Flags:", c)} ${style.cyan("-p <dir>", c)} \xB7 ${style.cyan("-t <harnesses>", c)} \xB7 ${style.cyan("-f <table|json|md>", c)} \xB7 ${style.cyan("-h <cmd>", c)}`
+    `${style.dim("\u2570\u2500", c)} ${style.dim("Run", c)} ${style.cyan("skillops <cmd> -h", c)} ${style.dim("for command options.", c)}`
   ].join("\n");
 }
 function renderCommandHelp(spec, version, colorEnabled) {
@@ -5194,6 +5205,341 @@ function renderCommandHelp(spec, version, colorEnabled) {
   return [headerLines, optionsSection, examplesSection].filter(Boolean).join("\n");
 }
 
+// src/ui/prompt.ts
+function optionMatchesTab(opt, tab) {
+  if (opt.kind === "agent") {
+    return tab === "agent";
+  }
+  return tab === "skill";
+}
+function optionMatchesQuery(opt, rawQuery) {
+  const q = rawQuery.trim().toLowerCase();
+  if (!q) {
+    return true;
+  }
+  return opt.label.toLowerCase().includes(q) || opt.value.toLowerCase().includes(q) || (opt.hint ?? "").toLowerCase().includes(q);
+}
+function getFilteredTabOptions(state, tab = state.activeTab) {
+  return state.options.filter(
+    (opt) => optionMatchesTab(opt, tab) && optionMatchesQuery(opt, state.searchQuery)
+  );
+}
+function createMultiSelectState(options) {
+  const initial = /* @__PURE__ */ new Set();
+  for (const opt of options) {
+    if (opt.initialSelected) {
+      initial.add(opt.value);
+    }
+  }
+  const hasSkills = options.some((opt) => optionMatchesTab(opt, "skill"));
+  return {
+    options,
+    activeTab: hasSkills ? "skill" : "agent",
+    cursor: 0,
+    selected: initial,
+    searchMode: false,
+    searchQuery: "",
+    status: "active"
+  };
+}
+function applyMultiSelectKey(state, key) {
+  if (state.status !== "active" || state.options.length === 0) {
+    return state;
+  }
+  if (key === "") {
+    return {
+      ...state,
+      status: "cancelled"
+    };
+  }
+  if (key === "\x1B") {
+    if (state.searchMode || state.searchQuery.length > 0) {
+      return {
+        ...state,
+        searchMode: false,
+        searchQuery: "",
+        cursor: 0
+      };
+    }
+    return {
+      ...state,
+      status: "cancelled"
+    };
+  }
+  if (key === "\r" || key === "\n") {
+    return {
+      ...state,
+      searchMode: false,
+      status: "submitted"
+    };
+  }
+  if (key === "\x1B[D" || key === "\x1BOD" || key === "\x1B[C" || key === "\x1BOC" || key === "	" || !state.searchMode && (key === "h" || key === "H" || key === "l" || key === "L")) {
+    const nextTab = state.activeTab === "skill" ? "agent" : "skill";
+    return {
+      ...state,
+      activeTab: nextTab,
+      cursor: 0
+    };
+  }
+  const visible = getFilteredTabOptions(state, state.activeTab);
+  const count = visible.length;
+  if (key === "\x1B[A" || key === "\x1BOA" || !state.searchMode && (key === "k" || key === "K")) {
+    if (count === 0) {
+      return state;
+    }
+    const nextCursor = (state.cursor - 1 + count) % count;
+    return {
+      ...state,
+      cursor: nextCursor
+    };
+  }
+  if (key === "\x1B[B" || key === "\x1BOB" || !state.searchMode && (key === "j" || key === "J")) {
+    if (count === 0) {
+      return state;
+    }
+    const nextCursor = (state.cursor + 1) % count;
+    return {
+      ...state,
+      cursor: nextCursor
+    };
+  }
+  if (key === " ") {
+    const currentOpt = visible[state.cursor];
+    if (!currentOpt) {
+      return state;
+    }
+    const nextSelected = new Set(state.selected);
+    if (nextSelected.has(currentOpt.value)) {
+      nextSelected.delete(currentOpt.value);
+    } else {
+      nextSelected.add(currentOpt.value);
+    }
+    return {
+      ...state,
+      selected: nextSelected
+    };
+  }
+  if (state.searchMode) {
+    if (key === "\x7F" || key === "\b") {
+      if (state.searchQuery.length === 0) {
+        return {
+          ...state,
+          searchMode: false,
+          cursor: 0
+        };
+      }
+      const nextQuery = state.searchQuery.slice(0, -1);
+      return {
+        ...state,
+        searchQuery: nextQuery,
+        cursor: 0
+      };
+    }
+    if (/^[a-zA-Z0-9_.-]$/.test(key)) {
+      const nextQuery = `${state.searchQuery}${key}`;
+      const nextState = {
+        ...state,
+        searchQuery: nextQuery,
+        cursor: 0
+      };
+      const currentMatches = getFilteredTabOptions(nextState, state.activeTab);
+      if (currentMatches.length === 0) {
+        const otherTab = state.activeTab === "skill" ? "agent" : "skill";
+        const otherMatches = getFilteredTabOptions(nextState, otherTab);
+        if (otherMatches.length > 0) {
+          return {
+            ...nextState,
+            activeTab: otherTab
+          };
+        }
+      }
+      return nextState;
+    }
+    return state;
+  }
+  if (key === "/") {
+    return {
+      ...state,
+      searchMode: true,
+      cursor: 0
+    };
+  }
+  if (key === "q" || key === "Q") {
+    return {
+      ...state,
+      status: "cancelled"
+    };
+  }
+  if (key === "a" || key === "A") {
+    if (visible.length === 0) {
+      return state;
+    }
+    const allTabSelected = visible.every(
+      (opt) => state.selected.has(opt.value)
+    );
+    const nextSelected = new Set(state.selected);
+    if (allTabSelected) {
+      for (const opt of visible) {
+        nextSelected.delete(opt.value);
+      }
+    } else {
+      for (const opt of visible) {
+        nextSelected.add(opt.value);
+      }
+    }
+    return {
+      ...state,
+      selected: nextSelected
+    };
+  }
+  return state;
+}
+function renderMultiSelectFrame(title, state, options = {}) {
+  const c = options.colorEnabled;
+  const bar = style.dim("\u2502", c);
+  const maxVisible = options.maxVisible ?? 10;
+  const totalSkills = state.options.filter(
+    (o) => optionMatchesTab(o, "skill")
+  ).length;
+  const totalAgents = state.options.filter(
+    (o) => optionMatchesTab(o, "agent")
+  ).length;
+  const filteredSkills = getFilteredTabOptions(state, "skill");
+  const filteredAgents = getFilteredTabOptions(state, "agent");
+  const visible = state.activeTab === "skill" ? filteredSkills : filteredAgents;
+  const total = visible.length;
+  const header = `${style.bold(style.cyan(`\u25C6 ${title}`, c), c)}`;
+  const instructions = state.searchMode ? `${bar}  ${style.dim("\u2191/\u2193 move \xB7 \u2190/\u2192 switch tab \xB7 Space select \xB7 Esc clear search \xB7 Enter import", c)}` : `${bar}  ${style.dim("\u2191/\u2193 move \xB7 \u2190/\u2192 switch tab \xB7 Space select \xB7 / search \xB7 a all \xB7 Enter import", c)}`;
+  const lines = [header];
+  if (options.subtitle) {
+    lines.push(`${bar}  ${options.subtitle}`);
+  }
+  lines.push(instructions, bar);
+  const hasQuery = state.searchQuery.length > 0;
+  const skillCountStr = hasQuery ? `${filteredSkills.length}/${totalSkills}` : `${totalSkills}`;
+  const agentCountStr = hasQuery ? `${filteredAgents.length}/${totalAgents}` : `${totalAgents}`;
+  const skillTabLabel = state.activeTab === "skill" ? style.bold(style.cyan(`[ \u25C6 Skills (${skillCountStr}) ]`, c), c) : style.dim(`\u25CB Skills (${skillCountStr})`, c);
+  const agentTabLabel = state.activeTab === "agent" ? style.bold(style.magenta(`[ \u25C6 Agents (${agentCountStr}) ]`, c), c) : style.dim(`\u25CB Agents (${agentCountStr})`, c);
+  const rawQuerySlice = state.searchQuery.length > 14 ? `\u2026${state.searchQuery.slice(-13)}` : state.searchQuery;
+  const searchSuffix = state.searchMode || hasQuery ? `   ${style.yellow(`/ Filter: ${rawQuerySlice}${state.searchMode ? "\u2588" : ""}`, c)}` : `   ${style.dim("(/ search)", c)}`;
+  lines.push(
+    `${style.dim("\u251C\u2500", c)} ${skillTabLabel}   ${agentTabLabel}${searchSuffix}`,
+    bar
+  );
+  if (total === 0) {
+    const tabName = state.activeTab === "skill" ? "Skills" : "Agents";
+    lines.push(
+      `${bar}  ${style.dim(`No ${tabName} match "${state.searchQuery}". Press Esc to clear filter.`, c)}`
+    );
+  } else {
+    let startIdx = 0;
+    if (total > maxVisible) {
+      const half = Math.floor(maxVisible / 2);
+      startIdx = Math.max(0, Math.min(state.cursor - half, total - maxVisible));
+    }
+    const endIdx = Math.min(total, startIdx + maxVisible);
+    if (startIdx > 0) {
+      lines.push(`${bar}  ${style.dim(`\u2191 ${startIdx} more above...`, c)}`);
+    }
+    const maxLabelCols = Math.min(
+      26,
+      visible.reduce((m, o) => Math.max(m, visibleLength(o.label)), 14)
+    );
+    for (let i = startIdx; i < endIdx; i++) {
+      const opt = visible[i];
+      if (!opt) continue;
+      const isCurrent = i === state.cursor;
+      const isChecked = state.selected.has(opt.value);
+      const pointer = isCurrent ? style.cyan("\u276F", c) : " ";
+      const checkbox = isChecked ? style.green("\u25C9", c) : style.dim("\u25EF", c);
+      const labelRaw = opt.label.length > maxLabelCols ? `${opt.label.slice(0, maxLabelCols - 1)}\u2026` : opt.label;
+      const labelPadded = padVisible(labelRaw, maxLabelCols + 1, "left");
+      const styledLabel = isCurrent ? style.bold(labelPadded, c) : isChecked ? style.green(labelPadded, c) : labelPadded;
+      const prefixWidth = 7 + maxLabelCols + 1;
+      const maxHintCols = Math.max(10, 76 - prefixWidth);
+      const rawHint = opt.hint ?? "";
+      const shortHint = rawHint.length > maxHintCols ? `${rawHint.slice(0, maxHintCols - 1)}\u2026` : rawHint;
+      const hintPart = shortHint ? ` ${style.dim(shortHint, c)}` : "";
+      lines.push(`${bar}  ${pointer} ${checkbox} ${styledLabel}${hintPart}`);
+    }
+    if (endIdx < total) {
+      lines.push(
+        `${bar}  ${style.dim(`\u2193 ${total - endIdx} more below...`, c)}`
+      );
+    }
+  }
+  lines.push(bar);
+  const selectedSkillsCount = state.options.filter(
+    (o) => optionMatchesTab(o, "skill") && state.selected.has(o.value)
+  ).length;
+  const selectedAgentsCount = state.options.filter(
+    (o) => optionMatchesTab(o, "agent") && state.selected.has(o.value)
+  ).length;
+  const summaryText = `${state.selected.size} selected (${selectedSkillsCount} Skills, ${selectedAgentsCount} Agents)`;
+  const rawTarget = options.targetHint ?? "";
+  const shortTarget = rawTarget.length > 18 ? `${rawTarget.slice(0, 17)}\u2026` : rawTarget;
+  const targetSuffix = shortTarget ? ` \xB7 IDE: ${shortTarget}` : "";
+  lines.push(
+    `${style.dim("\u2570\u2500", c)} ${style.bold(summaryText, c)}${style.dim(`${targetSuffix} \u2014 Enter to import`, c)}`
+  );
+  return lines.join("\n");
+}
+async function runMultiSelectPrompt(title, options, renderOpts = {}) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return null;
+  }
+  let state = createMultiSelectState(options);
+  let renderedLineCount = 0;
+  const render = () => {
+    const frame = renderMultiSelectFrame(title, state, renderOpts);
+    if (renderedLineCount > 0) {
+      process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+    }
+    process.stdout.write(`${frame}
+`);
+    renderedLineCount = frame.split("\n").length;
+  };
+  return new Promise((resolve) => {
+    const stdin = process.stdin;
+    const wasRaw = stdin.isRaw;
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf-8");
+    process.stdout.write("\x1B[?25l");
+    render();
+    const cleanup = () => {
+      stdin.removeListener("data", onData);
+      if (stdin.isTTY) {
+        stdin.setRawMode(Boolean(wasRaw));
+      }
+      stdin.pause();
+      process.stdout.write("\x1B[?25h");
+    };
+    const onData = (chunk) => {
+      const key = typeof chunk === "string" ? chunk : chunk.toString("utf-8");
+      state = applyMultiSelectKey(state, key);
+      if (state.status === "cancelled") {
+        if (renderedLineCount > 0) {
+          process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+        }
+        cleanup();
+        resolve(null);
+        return;
+      }
+      if (state.status === "submitted") {
+        if (renderedLineCount > 0) {
+          process.stdout.write(`\x1B[${renderedLineCount}A\x1B[J`);
+        }
+        cleanup();
+        resolve([...state.selected]);
+        return;
+      }
+      render();
+    };
+    stdin.on("data", onData);
+  });
+}
+
 // src/framework/index.ts
 function extractMarkdownHeadings(markdownBody) {
   const headings = [];
@@ -5950,6 +6296,7 @@ export {
   TokenWasteHotspotSchema,
   addSkillOrSubagent,
   analyzeRepoTokenEconomy,
+  applyMultiSelectKey,
   auditCatalog,
   auditCatalogTokenBudgets,
   auditSkillTokenBudget,
@@ -5964,6 +6311,7 @@ export {
   countWords,
   createCollisionPair,
   createCollisionReport,
+  createMultiSelectState,
   createSkillManifest,
   createSubagentManifest,
   detectInstalledHarnesses,
@@ -5988,6 +6336,7 @@ export {
   formatScaffoldReport,
   formatSyncReport,
   formatTokenEconomyReport,
+  getFilteredTabOptions,
   handleMcpJsonRpcRequest,
   inspectCatalogItem,
   inspectHarnesses,
@@ -6007,6 +6356,7 @@ export {
   renderCommandHelp,
   renderGlobalHelp,
   renderHeaderBanner,
+  renderMultiSelectFrame,
   renderNextSteps,
   renderProgressBar,
   renderSectionHeader,
@@ -6015,6 +6365,7 @@ export {
   renderTokenBar,
   resolveRuntimeTargets,
   routeRepository,
+  runMultiSelectPrompt,
   runQuickstart,
   scaffoldFrameworkItem,
   scoreSkillAgainstProfile,