@skillkit/cli 1.9.0 → 1.10.0

package/dist/index.d.ts

@@ -236,12 +236,18 @@ declare class RecommendCommand extends Command {
     explain: boolean;
     reasoning: boolean;
     showPath: boolean;
+    hybrid: boolean;
+    expand: boolean;
+    rerank: boolean;
+    buildIndex: boolean;
     execute(): Promise<number>;
     private handleReasoningRecommendations;
     private getProjectProfile;
     private showProjectProfile;
     private displayRecommendations;
     private displayExplainedRecommendations;
+    private handleHybridSearch;
+    private buildHybridIndex;
     private handleSearch;
     private loadIndex;
     private updateIndex;

package/dist/index.js

@@ -3391,7 +3391,10 @@ var RecommendCommand = class extends Command15 {
       ["Show detailed reasons", "$0 recommend --verbose"],
       ["Update skill index", "$0 recommend --update"],
       ["Search for skills by task", '$0 recommend --task "authentication"'],
-      ["Search for skills (alias)", '$0 recommend --search "testing"']
+      ["Search for skills (alias)", '$0 recommend --search "testing"'],
+      ["Hybrid search (vector + keyword)", '$0 recommend --search "auth" --hybrid'],
+      ["Hybrid search with query expansion", '$0 recommend --search "auth" --hybrid --expand'],
+      ["Build hybrid search index", "$0 recommend --build-index"]
     ]
   });
   // Limit number of results
@@ -3450,11 +3453,33 @@ var RecommendCommand = class extends Command15 {
   showPath = Option14.Boolean("--show-path", false, {
     description: "Show category path for each recommendation"
   });
+  // Hybrid search mode
+  hybrid = Option14.Boolean("--hybrid,-H", false, {
+    description: "Use hybrid search (vector + keyword)"
+  });
+  // Query expansion
+  expand = Option14.Boolean("--expand,-x", false, {
+    description: "Enable query expansion (requires --hybrid)"
+  });
+  // Reranking
+  rerank = Option14.Boolean("--rerank", false, {
+    description: "Enable LLM reranking (requires --hybrid)"
+  });
+  // Build index
+  buildIndex = Option14.Boolean("--build-index", false, {
+    description: "Build/rebuild the hybrid search embedding index"
+  });
   async execute() {
     const targetPath = resolve4(this.projectPath || process.cwd());
     if (this.update) {
       return await this.updateIndex();
     }
+    if (this.buildIndex) {
+      return await this.buildHybridIndex();
+    }
+    if ((this.expand || this.rerank) && !this.hybrid) {
+      warn("--expand and --rerank require --hybrid flag. These options will be ignored.");
+    }
     if (!this.quiet && !this.json) {
       header("Skill Recommendations");
     }
@@ -3478,6 +3503,9 @@ var RecommendCommand = class extends Command15 {
     engine.loadIndex(index);
     const searchQuery = this.search || this.task;
     if (searchQuery) {
+      if (this.hybrid) {
+        return await this.handleHybridSearch(engine, searchQuery);
+      }
       return this.handleSearch(engine, searchQuery);
     }
     const result = engine.recommend(profile, {
@@ -3691,6 +3719,110 @@ var RecommendCommand = class extends Command15 {
     console.log(colors.muted("Install with: skillkit install <source>"));
     console.log(colors.muted("More details: skillkit recommend --explain --verbose"));
   }
+  async handleHybridSearch(engine, query) {
+    if (!this.quiet && !this.json) {
+      header(`Hybrid Search: "${query}"`);
+    }
+    const s = !this.quiet && !this.json ? spinner2() : null;
+    s?.start("Initializing hybrid search...");
+    try {
+      await engine.initHybridSearch();
+      s?.message("Searching...");
+      const results = await engine.hybridSearch({
+        query,
+        limit: this.limit ? parseInt(this.limit, 10) : 10,
+        hybrid: true,
+        enableExpansion: this.expand,
+        enableReranking: this.rerank,
+        filters: {
+          minScore: this.minScore ? parseInt(this.minScore, 10) : void 0
+        }
+      });
+      s?.stop(`Found ${results.length} results`);
+      if (this.json) {
+        console.log(JSON.stringify(results, null, 2));
+        return 0;
+      }
+      if (results.length === 0) {
+        warn(`No skills found matching "${query}"`);
+        return 0;
+      }
+      console.log("");
+      console.log(colors.bold(`Hybrid search results for "${query}" (${results.length} found):`));
+      if (this.expand && results[0]?.expandedTerms?.length) {
+        console.log(colors.muted(`  Expanded: ${results[0].expandedTerms.join(", ")}`));
+      }
+      console.log("");
+      for (const result of results) {
+        let relevanceColor;
+        if (result.relevance >= 70) {
+          relevanceColor = colors.success;
+        } else if (result.relevance >= 50) {
+          relevanceColor = colors.warning;
+        } else {
+          relevanceColor = colors.muted;
+        }
+        const relevanceBar = progressBar(result.relevance, 100, 10);
+        console.log(`  ${relevanceColor(`${result.relevance}%`)} ${colors.dim(relevanceBar)} ${colors.bold(result.skill.name)}`);
+        if (result.skill.description) {
+          console.log(`      ${colors.muted(truncate3(result.skill.description, 70))}`);
+        }
+        if (this.verbose) {
+          const scores = [];
+          if (typeof result.vectorSimilarity === "number") {
+            scores.push(`vector: ${(result.vectorSimilarity * 100).toFixed(0)}%`);
+          }
+          if (typeof result.keywordScore === "number") {
+            scores.push(`keyword: ${result.keywordScore.toFixed(0)}%`);
+          }
+          if (typeof result.rrfScore === "number") {
+            scores.push(`rrf: ${result.rrfScore.toFixed(3)}`);
+          }
+          if (scores.length > 0) {
+            console.log(`      ${colors.dim("Scores:")} ${scores.join(" | ")}`);
+          }
+        }
+        if (result.matchedTerms.length > 0) {
+          console.log(`      ${colors.dim("Matched:")} ${result.matchedTerms.join(", ")}`);
+        }
+        console.log("");
+      }
+      return 0;
+    } catch (err) {
+      s?.stop(colors.error("Hybrid search failed"));
+      console.log(colors.muted(err instanceof Error ? err.message : String(err)));
+      console.log(colors.muted("Falling back to standard search..."));
+      return this.handleSearch(engine, query);
+    }
+  }
+  async buildHybridIndex() {
+    if (!this.quiet) {
+      header("Build Hybrid Search Index");
+    }
+    const index = this.loadIndex();
+    if (!index || index.skills.length === 0) {
+      warn("No skill index found. Run --update first.");
+      return 1;
+    }
+    const s = spinner2();
+    s.start("Initializing...");
+    try {
+      const engine = new RecommendationEngine();
+      engine.loadIndex(index);
+      await engine.buildHybridIndex((progress) => {
+        const percentage = Math.round(progress.current / progress.total * 100);
+        s.message(`${progress.phase}: ${progress.message || ""} (${percentage}%)`);
+      });
+      s.stop(colors.success(`${symbols.success} Built hybrid index for ${index.skills.length} skills`));
+      console.log(colors.muted("  Index stored in: ~/.skillkit/search.db"));
+      console.log(colors.muted("  Use --hybrid flag for vector+keyword search\n"));
+      return 0;
+    } catch (err) {
+      s.stop(colors.error("Failed to build hybrid index"));
+      console.log(colors.muted(err instanceof Error ? err.message : String(err)));
+      return 1;
+    }
+  }
   handleSearch(engine, query) {
     if (!this.quiet && !this.json) {
       header(`Search: "${query}"`);
@@ -10688,8 +10820,8 @@ import { Command as Command40, Option as Option39 } from "clipanion";
 var skills_default = {
   $schema: "./schema.json",
   version: 1,
-  updatedAt: "2026-01-26",
-  totalSkills: 15064,
+  updatedAt: "2026-02-02",
+  totalSkills: 15065,
   curatedCollections: 31,
   skills: [
     {
@@ -43799,6 +43931,23 @@ var skills_default = {
         "k8s"
       ]
     },
+    {
+      id: "rohitg00/beautiful-mermaid/beautiful-mermaid",
+      name: "Beautiful Mermaid",
+      description: "Render Mermaid diagrams as beautiful SVGs or ASCII art. 5 diagram types, 15 themes, Shiki integration, zero DOM dependencies.",
+      source: "rohitg00/beautiful-mermaid",
+      tags: [
+        "mermaid",
+        "diagrams",
+        "visualization",
+        "flowchart",
+        "sequence",
+        "uml",
+        "ascii",
+        "svg",
+        "themes"
+      ]
+    },
     {
       id: "itsmostafa/aws-agent-skills/cognito",
       name: "Cognito",