skill-tree 0.2.0 → 0.3.0

package/dist/cli/index.js

@@ -30,20 +30,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// node_modules/tsup/assets/cjs_shims.js
-var init_cjs_shims = __esm({
-  "node_modules/tsup/assets/cjs_shims.js"() {
-    "use strict";
-  }
-});
-
 // src/storage/base.ts
-var BaseStorageAdapter, MemoryStorageAdapter;
+var _BaseStorageAdapter, BaseStorageAdapter, MemoryStorageAdapter;
 var init_base = __esm({
   "src/storage/base.ts"() {
     "use strict";
-    init_cjs_shims();
-    BaseStorageAdapter = class {
+    _BaseStorageAdapter = class _BaseStorageAdapter {
       constructor() {
         this.initialized = false;
       }
@@ -135,19 +127,123 @@ var init_base = __esm({
        * Simple text search across skill fields
        */
       textSearch(skills, query) {
-        const lowerQuery = query.toLowerCase();
-        const terms = lowerQuery.split(/\s+/).filter((t) => t.length > 0);
-        return skills.filter((skill) => {
-          const searchText = [
-            skill.name,
-            skill.description,
-            skill.instructions,
-            ...skill.tags
-          ].join(" ").toLowerCase();
-          return terms.every((term) => searchText.includes(term));
+        const queryTerms = this.tokenize(query);
+        if (queryTerms.length === 0) return [];
+        const N = skills.length;
+        const k1 = 1.5;
+        const b = 0.75;
+        const docs = skills.map((skill) => ({
+          skill,
+          terms: this.tokenize(
+            [skill.name, skill.description, ...skill.tags].join(" ")
+          )
+        }));
+        const avgDl = docs.reduce((sum, d) => sum + d.terms.length, 0) / (N || 1);
+        const df = /* @__PURE__ */ new Map();
+        for (const doc of docs) {
+          const unique = new Set(doc.terms);
+          for (const t of unique) {
+            df.set(t, (df.get(t) ?? 0) + 1);
+          }
+        }
+        const requiredTerms = [...new Set(queryTerms)].filter((qt) => (df.get(qt) ?? 0) > 0);
+        const scored = docs.map((doc) => {
+          let score = 0;
+          const tf = /* @__PURE__ */ new Map();
+          for (const t of doc.terms) {
+            tf.set(t, (tf.get(t) ?? 0) + 1);
+          }
+          const matchesAll = requiredTerms.every((qt) => (tf.get(qt) ?? 0) > 0);
+          if (!matchesAll) {
+            return { skill: doc.skill, score: 0 };
+          }
+          for (const qt of queryTerms) {
+            const termDf = df.get(qt) ?? 0;
+            if (termDf === 0) continue;
+            const idf = Math.log((N - termDf + 0.5) / (termDf + 0.5) + 1);
+            const termTf = tf.get(qt) ?? 0;
+            const tfNorm = termTf * (k1 + 1) / (termTf + k1 * (1 - b + b * doc.terms.length / avgDl));
+            score += idf * tfNorm;
+          }
+          return { skill: doc.skill, score };
         });
+        return scored.filter((s) => s.score > 0).sort((a, b2) => b2.score - a.score).map((s) => s.skill);
+      }
+      tokenize(text) {
+        return text.toLowerCase().split(/\W+/).filter((t) => t.length > 1 && !_BaseStorageAdapter.STOP_WORDS.has(t)).map((t) => _BaseStorageAdapter.stem(t));
+      }
+      static stem(word) {
+        if (word.length <= 3) return word;
+        let w = word;
+        w = w.replace(/ies$/, "y");
+        w = w.replace(/(ation|tion)$/, "t");
+        w = w.replace(/sion$/, "s");
+        w = w.replace(/(ing|ment|ness|able|ible|ous|ive|ful|less|ize|ise|ance|ence)$/, "");
+        w = w.replace(/([^aeiou])ed$/, "$1");
+        w = w.replace(/es$/, "");
+        w = w.replace(/([^s])s$/, "$1");
+        w = w.replace(/(.)\1$/, "$1");
+        if (w.length <= 1) return word;
+        return w;
       }
     };
+    _BaseStorageAdapter.STOP_WORDS = /* @__PURE__ */ new Set([
+      "the",
+      "a",
+      "an",
+      "is",
+      "are",
+      "was",
+      "were",
+      "be",
+      "been",
+      "being",
+      "have",
+      "has",
+      "had",
+      "do",
+      "does",
+      "did",
+      "will",
+      "would",
+      "could",
+      "should",
+      "may",
+      "might",
+      "shall",
+      "can",
+      "to",
+      "of",
+      "in",
+      "for",
+      "on",
+      "with",
+      "at",
+      "by",
+      "from",
+      "as",
+      "into",
+      "through",
+      "and",
+      "but",
+      "or",
+      "not",
+      "so",
+      "yet",
+      "if",
+      "when",
+      "that",
+      "this",
+      "it",
+      "its",
+      "also",
+      "which",
+      "what",
+      "how",
+      "why",
+      "where"
+    ]);
+    BaseStorageAdapter = _BaseStorageAdapter;
     MemoryStorageAdapter = class extends BaseStorageAdapter {
       constructor() {
         super(...arguments);
@@ -312,7 +408,6 @@ var import_better_sqlite3, path7, fs7, SCHEMA_VERSION, SQLiteStorageAdapter;
 var init_sqlite = __esm({
   "src/storage/sqlite.ts"() {
     "use strict";
-    init_cjs_shims();
     import_better_sqlite3 = __toESM(require("better-sqlite3"));
     path7 = __toESM(require("path"));
     fs7 = __toESM(require("fs"));
@@ -930,15 +1025,15 @@ var init_sqlite = __esm({
       /**
        * Get or create a taxonomy node
        */
-      async ensureTaxonomyNode(path18) {
+      async ensureTaxonomyNode(path19) {
         this.ensureInitialized();
         const db = this.getDb();
-        const pathStr = path18.join("/");
+        const pathStr = path19.join("/");
         const existing = db.prepare("SELECT id FROM taxonomy_nodes WHERE path = ?").get(pathStr);
         if (existing) return existing.id;
         const id = `node-${pathStr.replace(/\//g, "-").toLowerCase()}`;
-        const name = path18[path18.length - 1] || "Root";
-        const parentPath = path18.slice(0, -1);
+        const name = path19[path19.length - 1] || "Root";
+        const parentPath = path19.slice(0, -1);
         let parentId = null;
         if (parentPath.length > 0) {
           parentId = await this.ensureTaxonomyNode(parentPath);
@@ -1180,7 +1275,6 @@ var DEFAULT_AGENTS_CONFIG;
 var init_types = __esm({
   "src/agents/types.ts"() {
     "use strict";
-    init_cjs_shims();
     DEFAULT_AGENTS_CONFIG = {
       format: "xml",
       includeIds: true,
@@ -1195,7 +1289,6 @@ var AgentsGenerator;
 var init_generator = __esm({
   "src/agents/generator.ts"() {
     "use strict";
-    init_cjs_shims();
     init_types();
     AgentsGenerator = class {
       constructor(config2) {
@@ -1407,7 +1500,6 @@ var AgentsParser;
 var init_parser = __esm({
   "src/agents/parser.ts"() {
     "use strict";
-    init_cjs_shims();
     AgentsParser = class {
       /**
        * Parse AGENTS.md content
@@ -1669,7 +1761,6 @@ var fs9, path9, AgentsSync;
 var init_sync = __esm({
   "src/agents/sync.ts"() {
     "use strict";
-    init_cjs_shims();
     fs9 = __toESM(require("fs"));
     path9 = __toESM(require("path"));
     init_generator();
@@ -1839,17 +1930,9 @@ var init_sync = __esm({
 });
 
 // src/cli/index.ts
-init_cjs_shims();
-var import_commander38 = require("commander");
-
-// src/index.ts
-init_cjs_shims();
-
-// src/skill-bank.ts
-init_cjs_shims();
+var import_commander39 = require("commander");
 
 // src/types.ts
-init_cjs_shims();
 function hasTaxonomySupport(storage) {
   return typeof storage.placeInTaxonomy === "function";
 }
@@ -1857,16 +1940,11 @@ function hasForkSupport(storage) {
   return typeof storage.recordFork === "function";
 }
 
-// src/sync/sync-manager.ts
-init_cjs_shims();
-
 // src/sync/git-sync-adapter.ts
-init_cjs_shims();
 var fs2 = __toESM(require("fs"));
 var path2 = __toESM(require("path"));
 
 // src/sync/conflict-store.ts
-init_cjs_shims();
 var fs = __toESM(require("fs"));
 var path = __toESM(require("path"));
 var ConflictStore = class {
@@ -2914,14 +2992,7 @@ var SyncManager = class {
   }
 };
 
-// src/serving/graph-server.ts
-init_cjs_shims();
-
-// src/serving/catalog-renderer.ts
-init_cjs_shims();
-
 // src/serving/xml-utils.ts
-init_cjs_shims();
 function escapeXml(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
@@ -2953,15 +3024,12 @@ var DEFAULT_CONFIG = {
   maxSummaryLength: 80,
   format: "xml"
 };
-var CatalogRenderer = class _CatalogRenderer {
+var _CatalogRenderer = class _CatalogRenderer {
   constructor(storage, config2) {
     this.storage = storage;
     this.overviewCache = null;
     this.config = { ...DEFAULT_CONFIG, ...config2 };
   }
-  static {
-    this.CACHE_TTL_MS = 6e4;
-  }
   /**
    * Render level-0 catalog overview for system prompt injection.
    * Shows top-level categories with counts. ~200 tokens.
@@ -2989,11 +3057,11 @@ var CatalogRenderer = class _CatalogRenderer {
    * Render a specific category path for browse drill-down.
    * Shows subcategories at intermediate nodes, or skill summaries at leaf nodes.
    */
-  async renderCategory(path18) {
+  async renderCategory(path19) {
     if (hasCatalogSupport(this.storage)) {
-      return this.renderCategoryFromTaxonomy(this.storage, path18);
+      return this.renderCategoryFromTaxonomy(this.storage, path19);
     }
-    return this.renderCategoryFromTags(path18);
+    return this.renderCategoryFromTags(path19);
   }
   /**
    * Invalidate the overview cache (e.g., after skill changes).
@@ -3031,9 +3099,9 @@ var CatalogRenderer = class _CatalogRenderer {
     const categories = counted.sort((a, b) => b.count - a.count).slice(0, this.config.maxCategoriesPerLevel).map((c) => ({ name: c.node.name, count: c.count }));
     return this.renderOverviewXml(totalSkills, categories);
   }
-  async renderCategoryFromTaxonomy(storage, path18) {
-    const tree = await storage.getTaxonomyTree(path18);
-    const pathStr = path18.join("/");
+  async renderCategoryFromTaxonomy(storage, path19) {
+    const tree = await storage.getTaxonomyTree(path19);
+    const pathStr = path19.join("/");
     if (tree.length > 0 && tree.some((n) => n.children.length > 0)) {
       const root = tree[0];
       const rootCount = this.countNodeSkills(root);
@@ -3043,7 +3111,7 @@ var CatalogRenderer = class _CatalogRenderer {
       lines.push(`<catalog_browse path="${escapeXml(pathStr)}" count="${rootCount}">`);
       lines.push("  <subcategories>");
       for (const { node: child, count } of children) {
-        const childPath = [...path18, child.name].join("/");
+        const childPath = [...path19, child.name].join("/");
         lines.push(`    <category path="${escapeXml(childPath)}" count="${count}" />`);
       }
       lines.push("  </subcategories>");
@@ -3067,13 +3135,13 @@ var CatalogRenderer = class _CatalogRenderer {
     const categories = Array.from(tagCounts.entries()).sort((a, b) => b[1] - a[1]).slice(0, this.config.maxCategoriesPerLevel).map(([name, count]) => ({ name, count }));
     return this.renderOverviewXml(skills.length, categories);
   }
-  async renderCategoryFromTags(path18) {
-    if (path18.length === 0) {
+  async renderCategoryFromTags(path19) {
+    if (path19.length === 0) {
       return this.renderOverviewFromTags();
     }
-    const tag = path18[0];
+    const tag = path19[0];
     const matching = await this.storage.listSkills({ status: ["active"], tags: [tag] });
-    const pathStr = path18.join("/");
+    const pathStr = path19.join("/");
     return this.renderLeafSkills(matching, pathStr, matching.length);
   }
   // ===========================================================================
@@ -3126,13 +3194,276 @@ var CatalogRenderer = class _CatalogRenderer {
     return count;
   }
 };
+_CatalogRenderer.CACHE_TTL_MS = 6e4;
+var CatalogRenderer = _CatalogRenderer;
+
+// src/serving/term-similarity.ts
+var STOP_WORDS = /* @__PURE__ */ new Set([
+  "the",
+  "a",
+  "an",
+  "is",
+  "are",
+  "was",
+  "were",
+  "be",
+  "been",
+  "being",
+  "have",
+  "has",
+  "had",
+  "do",
+  "does",
+  "did",
+  "will",
+  "would",
+  "could",
+  "should",
+  "may",
+  "might",
+  "shall",
+  "can",
+  "to",
+  "of",
+  "in",
+  "for",
+  "on",
+  "with",
+  "at",
+  "by",
+  "from",
+  "as",
+  "into",
+  "through",
+  "during",
+  "before",
+  "after",
+  "and",
+  "but",
+  "or",
+  "nor",
+  "not",
+  "so",
+  "yet",
+  "both",
+  "either",
+  "neither",
+  "each",
+  "every",
+  "all",
+  "any",
+  "few",
+  "more",
+  "most",
+  "other",
+  "some",
+  "such",
+  "no",
+  "only",
+  "own",
+  "same",
+  "than",
+  "too",
+  "very",
+  "just",
+  "because",
+  "if",
+  "when",
+  "that",
+  "this",
+  "it",
+  "its",
+  "also",
+  "which",
+  "what",
+  "how",
+  "why",
+  "where"
+]);
+function tokenizeList(text) {
+  return text.toLowerCase().split(/\W+/).filter((t) => t.length > 2 && !STOP_WORDS.has(t));
+}
+function tokenize(text) {
+  return new Set(tokenizeList(text));
+}
+
+// src/serving/hybrid-retrieval.ts
+var DEFAULT_FIELD_WEIGHTS = {
+  name: 10,
+  description: 5,
+  body: 5,
+  tags: 3
+};
+var DEFAULTS = {
+  rrfK: 60,
+  bm25K1: 1.2,
+  bm25B: 0.75,
+  bm25Saturation: 8,
+  signalWeights: { lexical: 0.5, dense: 0.5 }
+};
+function buildFieldDoc(skill, fw) {
+  const fields = [
+    [fw.name, tokenizeList(skill.name)],
+    [fw.description, tokenizeList(skill.description)],
+    [fw.body, tokenizeList(skill.instructions ?? "")],
+    [fw.tags, skill.tags.flatMap((t) => tokenizeList(t))]
+  ];
+  const wtf = /* @__PURE__ */ new Map();
+  let dl = 0;
+  for (const [weight, toks] of fields) {
+    if (weight <= 0) continue;
+    dl += weight * toks.length;
+    for (const t of toks) wtf.set(t, (wtf.get(t) ?? 0) + weight);
+  }
+  return { id: skill.id, wtf, dl };
+}
+function bm25Scores(query, skills, fieldWeights = DEFAULT_FIELD_WEIGHTS, k1 = DEFAULTS.bm25K1, b = DEFAULTS.bm25B) {
+  const scores = /* @__PURE__ */ new Map();
+  if (skills.length === 0) return scores;
+  const queryTerms = [...tokenize(query)];
+  const docs = skills.map((s) => buildFieldDoc(s, fieldWeights));
+  const N = docs.length;
+  const avgdl = docs.reduce((sum, d) => sum + d.dl, 0) / N || 1;
+  const df = /* @__PURE__ */ new Map();
+  for (const t of queryTerms) {
+    let count = 0;
+    for (const d of docs) if (d.wtf.has(t)) count++;
+    df.set(t, count);
+  }
+  for (const d of docs) {
+    let score = 0;
+    for (const t of queryTerms) {
+      const f = d.wtf.get(t);
+      if (!f) continue;
+      const n = df.get(t);
+      const idf = Math.log(1 + (N - n + 0.5) / (n + 0.5));
+      const denom = f + k1 * (1 - b + b * (d.dl / avgdl));
+      score += idf * (f * (k1 + 1) / (denom || 1));
+    }
+    scores.set(d.id, score);
+  }
+  return scores;
+}
+function cosineSimilarity(a, b) {
+  const len = Math.min(a.length, b.length);
+  let dot = 0;
+  let na = 0;
+  let nb = 0;
+  for (let i = 0; i < len; i++) {
+    dot += a[i] * b[i];
+    na += a[i] * a[i];
+    nb += b[i] * b[i];
+  }
+  if (na === 0 || nb === 0) return 0;
+  return dot / (Math.sqrt(na) * Math.sqrt(nb));
+}
+function reciprocalRankFusion(rankings, k = DEFAULTS.rrfK) {
+  const fused = /* @__PURE__ */ new Map();
+  for (const ranking of rankings) {
+    ranking.forEach((id, idx) => {
+      fused.set(id, (fused.get(id) ?? 0) + 1 / (k + idx + 1));
+    });
+  }
+  return fused;
+}
+function skillEmbedText(skill) {
+  return [
+    skill.name,
+    skill.description,
+    skill.tags.join(" "),
+    skill.instructions ?? ""
+  ].join("\n");
+}
+function rankByScore(scores) {
+  return [...scores.entries()].sort((a, b) => b[1] - a[1]).map(([id]) => id);
+}
+async function scoreSkillsHybrid(query, skills, options = {}) {
+  if (skills.length === 0) return [];
+  const fieldWeights = options.fieldWeights ?? DEFAULT_FIELD_WEIGHTS;
+  const sat = options.bm25Saturation ?? DEFAULTS.bm25Saturation;
+  const raw = bm25Scores(
+    query,
+    skills,
+    fieldWeights,
+    options.bm25K1 ?? DEFAULTS.bm25K1,
+    options.bm25B ?? DEFAULTS.bm25B
+  );
+  const lexAbs = /* @__PURE__ */ new Map();
+  for (const s of skills) {
+    const r = raw.get(s.id) ?? 0;
+    lexAbs.set(s.id, r / (r + sat));
+  }
+  let denseAbs = null;
+  if (options.embedder) {
+    try {
+      const vectors = await options.embedder.embed([
+        query,
+        ...skills.map(skillEmbedText)
+      ]);
+      const queryVec = vectors[0];
+      if (queryVec && vectors.length === skills.length + 1) {
+        denseAbs = /* @__PURE__ */ new Map();
+        skills.forEach((s, i) => {
+          denseAbs.set(s.id, Math.max(0, cosineSimilarity(queryVec, vectors[i + 1])));
+        });
+      }
+    } catch {
+      denseAbs = null;
+    }
+  }
+  const sw = options.signalWeights ?? DEFAULTS.signalWeights;
+  const wLex = sw.lexical;
+  const wDense = denseAbs ? sw.dense : 0;
+  const wSum = wLex + wDense || 1;
+  const useUtility = !!options.utilityScorer?.trained;
+  const scored = skills.map((s) => {
+    const l = lexAbs.get(s.id) ?? 0;
+    const d = denseAbs?.get(s.id) ?? 0;
+    const relevanceScore = useUtility ? options.utilityScorer.score({ skillId: s.id, lexAbs: l, denseAbs: d }) : (wLex * l + wDense * d) / wSum;
+    return { skill: s, relevanceScore };
+  });
+  if (!useUtility && (options.fusion ?? "weighted") === "rrf" && denseAbs) {
+    const rrf = reciprocalRankFusion(
+      [rankByScore(lexAbs), rankByScore(denseAbs)],
+      options.rrfK ?? DEFAULTS.rrfK
+    );
+    scored.sort(
+      (a, b) => (rrf.get(b.skill.id) ?? 0) - (rrf.get(a.skill.id) ?? 0) || b.relevanceScore - a.relevanceScore
+    );
+  } else {
+    scored.sort((a, b) => b.relevanceScore - a.relevanceScore);
+  }
+  if (options.reranker) {
+    const topN = options.rerankTopN ?? 20;
+    const head = scored.slice(0, topN);
+    if (head.length > 1) {
+      const ranked = await options.reranker.rerank(
+        query,
+        head.map((h) => ({
+          id: h.skill.id,
+          text: `${h.skill.name}
+${h.skill.description}
+${h.skill.instructions ?? ""}`
+        }))
+      );
+      const byId = new Map(head.map((h) => [h.skill.id, h.skill]));
+      const fusedDesc = head.map((h) => h.relevanceScore);
+      const reordered = ranked.filter((r) => byId.has(r.id)).map((r, i) => ({ skill: byId.get(r.id), relevanceScore: fusedDesc[i] ?? 0 }));
+      const headIds = new Set(reordered.map((s) => s.skill.id));
+      const tail = scored.filter((s) => !headIds.has(s.skill.id));
+      return [...reordered, ...tail];
+    }
+  }
+  return scored;
+}
 
 // src/serving/loadout-compiler.ts
-init_cjs_shims();
 var DEFAULT_CONFIG2 = {
   defaultMaxSkills: 15,
   defaultStatus: ["active"],
-  semanticThreshold: 0.6
+  semanticThreshold: 0.6,
+  retrieval: {},
+  scoringPoolSize: 200
 };
 var LoadoutCompiler = class {
   constructor(storage, config2) {
@@ -3184,6 +3515,66 @@ var LoadoutCompiler = class {
       maxSkills: this.config.defaultMaxSkills
     });
   }
+  /**
+   * Compile with hybrid-retrieval scoring against a task description
+   * (Tier 1). Returns skills annotated with absolute relevance scores in
+   * [0,1], sorted by descending relevance. Used by the hybrid loadout
+   * strategy to determine which skills should be auto-expanded vs shown
+   * as summaries vs excluded.
+   *
+   * Scoring uses field-weighted BM25 over the skill name/description/body/
+   * tags (the body matters most), optionally fused with dense embeddings
+   * (when an `embedder` is
+   * configured via `retrieval`). The candidate pool is the (filtered) set
+   * up to `scoringPoolSize` — larger than the final loadout — so the ranker
+   * re-ranks a real corpus rather than only a lexically pre-truncated top-N.
+   */
+  async compileWithScoring(taskDescription, criteria) {
+    const baseCriteria = {
+      ...criteria,
+      taskDescription,
+      // Score a broad pool, not the final loadout size. Callers narrow the
+      // result via partitionByConfidence + maxExpanded downstream.
+      maxSkills: criteria?.maxSkills ?? this.config.scoringPoolSize
+    };
+    const skills = await this.compile(baseCriteria);
+    return scoreSkillsHybrid(taskDescription, skills, this.config.retrieval);
+  }
+  /**
+   * Partition scored skills into confidence tiers.
+   * - High confidence (>= expandAbove): should be auto-expanded
+   * - Medium confidence (>= includeAbove): included as summaries
+   * - Below includeAbove: excluded
+   *
+   * Abstain floor (Tier 1, T1.3): if `thresholds.minConfidence` is set and
+   * even the single best-scoring skill is below it, the whole loadout
+   * abstains — every skill is excluded and **nothing** is injected. This
+   * makes "no sufficiently relevant skill" a first-class outcome (B=0),
+   * which prevents irrelevant skills from dragging task success below the
+   * no-skill baseline. `scored` is expected to be sorted descending, but we
+   * defensively take the max rather than assume order.
+   */
+  partitionByConfidence(scored, thresholds) {
+    const expand = [];
+    const summarize = [];
+    const excluded = [];
+    if (thresholds.minConfidence !== void 0) {
+      const topScore = scored.reduce((m, s) => Math.max(m, s.relevanceScore), 0);
+      if (scored.length === 0 || topScore < thresholds.minConfidence) {
+        return { expand, summarize, excluded: [...scored] };
+      }
+    }
+    for (const item of scored) {
+      if (item.relevanceScore >= thresholds.expandAbove) {
+        expand.push(item);
+      } else if (item.relevanceScore >= thresholds.includeAbove) {
+        summarize.push(item);
+      } else {
+        excluded.push(item);
+      }
+    }
+    return { expand, summarize, excluded };
+  }
   /**
    * Compile from a named profile
    */
@@ -3255,13 +3646,31 @@ var LoadoutCompiler = class {
     return result;
   }
   /**
-   * Apply semantic filters (task description, problem context, etc.)
+   * Apply semantic filters (task description matching).
    *
-   * Currently returns skills unchanged. Semantic matching was removed;
-   * use SQLite FTS via storage.searchSkills() for keyword-based search.
+   * When `taskDescription` is provided, uses storage.searchSkills()
+   * to find matching skills and boosts them to the front. Skills not
+   * matching the search are retained at lower priority so that tag
+   * filters and explicit includes still work.
    */
-  async applySemanticFilters(skills, _criteria) {
-    return skills;
+  async applySemanticFilters(skills, criteria) {
+    if (!criteria.taskDescription) return skills;
+    const searchResults = await this.storage.searchSkills(criteria.taskDescription);
+    const searchIds = new Set(searchResults.map((s) => s.id));
+    const candidateIds = new Set(skills.map((s) => s.id));
+    const boosted = [];
+    const rest = [];
+    for (const s of searchResults) {
+      if (candidateIds.has(s.id)) {
+        boosted.push(s);
+      }
+    }
+    for (const s of skills) {
+      if (!searchIds.has(s.id)) {
+        rest.push(s);
+      }
+    }
+    return [...boosted, ...rest];
   }
   /**
    * Apply relationship-based filters (root skills, dependencies)
@@ -3347,8 +3756,6 @@ var LoadoutCompiler = class {
    */
   applyLimits(skills, criteria) {
     let result = skills;
-    if (criteria.priorityOrder === "relevance") {
-    }
     const maxSkills = criteria.maxSkills ?? this.config.defaultMaxSkills;
     if (result.length > maxSkills) {
       result = result.slice(0, maxSkills);
@@ -3384,79 +3791,13 @@ var LoadoutCompiler = class {
 };
 
 // src/serving/project-detector.ts
-init_cjs_shims();
 var import_fs = require("fs");
 var import_path = require("path");
-var ProjectDetector = class _ProjectDetector {
+var _ProjectDetector = class _ProjectDetector {
   constructor() {
     /** Cache for project context */
     this.cache = /* @__PURE__ */ new Map();
   }
-  static {
-    /** Project type patterns */
-    this.PROJECT_TYPES = [
-      { manifestFile: "package.json", type: "nodejs", tags: ["nodejs", "javascript"], packageManager: "npm" },
-      { manifestFile: "pyproject.toml", type: "python", tags: ["python"], packageManager: "pip" },
-      { manifestFile: "requirements.txt", type: "python", tags: ["python"], packageManager: "pip" },
-      { manifestFile: "Cargo.toml", type: "rust", tags: ["rust"], packageManager: "cargo" },
-      { manifestFile: "go.mod", type: "go", tags: ["go", "golang"] },
-      { manifestFile: "pom.xml", type: "java", tags: ["java", "maven"], packageManager: "maven" },
-      { manifestFile: "build.gradle", type: "java", tags: ["java", "gradle"], packageManager: "gradle" },
-      { manifestFile: "build.gradle.kts", type: "kotlin", tags: ["kotlin", "gradle"], packageManager: "gradle" }
-    ];
-  }
-  static {
-    /** TypeScript detection */
-    this.TYPESCRIPT_FILES = ["tsconfig.json", "tsconfig.base.json"];
-  }
-  static {
-    /** Node.js framework patterns */
-    this.NODE_FRAMEWORKS = [
-      { name: "react", packageName: "react", tags: ["react", "frontend"] },
-      { name: "next", packageName: "next", tags: ["nextjs", "react", "fullstack"] },
-      { name: "vue", packageName: "vue", tags: ["vue", "frontend"] },
-      { name: "nuxt", packageName: "nuxt", tags: ["nuxt", "vue", "fullstack"] },
-      { name: "angular", packageName: "@angular/core", tags: ["angular", "frontend"] },
-      { name: "svelte", packageName: "svelte", tags: ["svelte", "frontend"] },
-      { name: "express", packageName: "express", tags: ["express", "backend", "api"] },
-      { name: "fastify", packageName: "fastify", tags: ["fastify", "backend", "api"] },
-      { name: "nestjs", packageName: "@nestjs/core", tags: ["nestjs", "backend", "api"] },
-      { name: "hono", packageName: "hono", tags: ["hono", "backend", "api"] },
-      { name: "prisma", packageName: "@prisma/client", tags: ["prisma", "database", "orm"] },
-      { name: "drizzle", packageName: "drizzle-orm", tags: ["drizzle", "database", "orm"] },
-      { name: "typeorm", packageName: "typeorm", tags: ["typeorm", "database", "orm"] },
-      { name: "jest", packageName: "jest", tags: ["testing", "jest"] },
-      { name: "vitest", packageName: "vitest", tags: ["testing", "vitest"] },
-      { name: "playwright", packageName: "@playwright/test", tags: ["testing", "e2e", "playwright"] },
-      { name: "cypress", packageName: "cypress", tags: ["testing", "e2e", "cypress"] }
-    ];
-  }
-  static {
-    /** Python framework patterns (from pyproject.toml or requirements.txt) */
-    this.PYTHON_FRAMEWORKS = [
-      { name: "fastapi", packageName: "fastapi", tags: ["fastapi", "backend", "api"] },
-      { name: "django", packageName: "django", tags: ["django", "backend", "fullstack"] },
-      { name: "flask", packageName: "flask", tags: ["flask", "backend", "api"] },
-      { name: "sqlalchemy", packageName: "sqlalchemy", tags: ["sqlalchemy", "database", "orm"] },
-      { name: "pytest", packageName: "pytest", tags: ["testing", "pytest"] },
-      { name: "pydantic", packageName: "pydantic", tags: ["pydantic", "validation"] }
-    ];
-  }
-  static {
-    /** Directory patterns */
-    this.DIRECTORY_PATTERNS = [
-      { pattern: ".github/workflows", feature: "github-actions", tags: ["ci", "github-actions"] },
-      { pattern: ".gitlab-ci.yml", feature: "gitlab-ci", tags: ["ci", "gitlab"] },
-      { pattern: "Dockerfile", feature: "docker", tags: ["docker", "containers"] },
-      { pattern: "docker-compose.yml", feature: "docker-compose", tags: ["docker", "containers"] },
-      { pattern: "docker-compose.yaml", feature: "docker-compose", tags: ["docker", "containers"] },
-      { pattern: "terraform", feature: "terraform", tags: ["terraform", "infrastructure"] },
-      { pattern: "kubernetes", feature: "kubernetes", tags: ["kubernetes", "infrastructure"] },
-      { pattern: "k8s", feature: "kubernetes", tags: ["kubernetes", "infrastructure"] },
-      { pattern: ".env.example", feature: "env-config", tags: ["configuration"] },
-      { pattern: "prisma/schema.prisma", feature: "prisma", tags: ["prisma", "database"] }
-    ];
-  }
   /**
    * Detect project context from a directory
    */
@@ -3618,9 +3959,64 @@ var ProjectDetector = class _ProjectDetector {
     }
   }
 };
+/** Project type patterns */
+_ProjectDetector.PROJECT_TYPES = [
+  { manifestFile: "package.json", type: "nodejs", tags: ["nodejs", "javascript"], packageManager: "npm" },
+  { manifestFile: "pyproject.toml", type: "python", tags: ["python"], packageManager: "pip" },
+  { manifestFile: "requirements.txt", type: "python", tags: ["python"], packageManager: "pip" },
+  { manifestFile: "Cargo.toml", type: "rust", tags: ["rust"], packageManager: "cargo" },
+  { manifestFile: "go.mod", type: "go", tags: ["go", "golang"] },
+  { manifestFile: "pom.xml", type: "java", tags: ["java", "maven"], packageManager: "maven" },
+  { manifestFile: "build.gradle", type: "java", tags: ["java", "gradle"], packageManager: "gradle" },
+  { manifestFile: "build.gradle.kts", type: "kotlin", tags: ["kotlin", "gradle"], packageManager: "gradle" }
+];
+/** TypeScript detection */
+_ProjectDetector.TYPESCRIPT_FILES = ["tsconfig.json", "tsconfig.base.json"];
+/** Node.js framework patterns */
+_ProjectDetector.NODE_FRAMEWORKS = [
+  { name: "react", packageName: "react", tags: ["react", "frontend"] },
+  { name: "next", packageName: "next", tags: ["nextjs", "react", "fullstack"] },
+  { name: "vue", packageName: "vue", tags: ["vue", "frontend"] },
+  { name: "nuxt", packageName: "nuxt", tags: ["nuxt", "vue", "fullstack"] },
+  { name: "angular", packageName: "@angular/core", tags: ["angular", "frontend"] },
+  { name: "svelte", packageName: "svelte", tags: ["svelte", "frontend"] },
+  { name: "express", packageName: "express", tags: ["express", "backend", "api"] },
+  { name: "fastify", packageName: "fastify", tags: ["fastify", "backend", "api"] },
+  { name: "nestjs", packageName: "@nestjs/core", tags: ["nestjs", "backend", "api"] },
+  { name: "hono", packageName: "hono", tags: ["hono", "backend", "api"] },
+  { name: "prisma", packageName: "@prisma/client", tags: ["prisma", "database", "orm"] },
+  { name: "drizzle", packageName: "drizzle-orm", tags: ["drizzle", "database", "orm"] },
+  { name: "typeorm", packageName: "typeorm", tags: ["typeorm", "database", "orm"] },
+  { name: "jest", packageName: "jest", tags: ["testing", "jest"] },
+  { name: "vitest", packageName: "vitest", tags: ["testing", "vitest"] },
+  { name: "playwright", packageName: "@playwright/test", tags: ["testing", "e2e", "playwright"] },
+  { name: "cypress", packageName: "cypress", tags: ["testing", "e2e", "cypress"] }
+];
+/** Python framework patterns (from pyproject.toml or requirements.txt) */
+_ProjectDetector.PYTHON_FRAMEWORKS = [
+  { name: "fastapi", packageName: "fastapi", tags: ["fastapi", "backend", "api"] },
+  { name: "django", packageName: "django", tags: ["django", "backend", "fullstack"] },
+  { name: "flask", packageName: "flask", tags: ["flask", "backend", "api"] },
+  { name: "sqlalchemy", packageName: "sqlalchemy", tags: ["sqlalchemy", "database", "orm"] },
+  { name: "pytest", packageName: "pytest", tags: ["testing", "pytest"] },
+  { name: "pydantic", packageName: "pydantic", tags: ["pydantic", "validation"] }
+];
+/** Directory patterns */
+_ProjectDetector.DIRECTORY_PATTERNS = [
+  { pattern: ".github/workflows", feature: "github-actions", tags: ["ci", "github-actions"] },
+  { pattern: ".gitlab-ci.yml", feature: "gitlab-ci", tags: ["ci", "gitlab"] },
+  { pattern: "Dockerfile", feature: "docker", tags: ["docker", "containers"] },
+  { pattern: "docker-compose.yml", feature: "docker-compose", tags: ["docker", "containers"] },
+  { pattern: "docker-compose.yaml", feature: "docker-compose", tags: ["docker", "containers"] },
+  { pattern: "terraform", feature: "terraform", tags: ["terraform", "infrastructure"] },
+  { pattern: "kubernetes", feature: "kubernetes", tags: ["kubernetes", "infrastructure"] },
+  { pattern: "k8s", feature: "kubernetes", tags: ["kubernetes", "infrastructure"] },
+  { pattern: ".env.example", feature: "env-config", tags: ["configuration"] },
+  { pattern: "prisma/schema.prisma", feature: "prisma", tags: ["prisma", "database"] }
+];
+var ProjectDetector = _ProjectDetector;
 
 // src/serving/view-renderer.ts
-init_cjs_shims();
 var DEFAULT_CONFIG3 = {
   includeTokenEstimates: false,
   maxSummaryLength: 150
@@ -3672,6 +4068,9 @@ var ViewRenderer = class {
         lines.push(`<skill id="${this.escapeXml(id)}" state="available">`);
         lines.push(`  <name>${this.escapeXml(skill.name)}</name>`);
         lines.push(`  <description>${this.escapeXml(summary)}</description>`);
+        if (skill.serving?.instructionPreview) {
+          lines.push(`  <key_insight>${this.escapeXml(skill.serving.instructionPreview)}</key_insight>`);
+        }
         if (skill.tags.length > 0) {
           lines.push(`  <tags>${skill.tags.map((t) => this.escapeXml(t)).join(", ")}</tags>`);
         }
@@ -3810,13 +4209,15 @@ var ViewRenderer = class {
    */
   estimateSummaryTokens(skill) {
     const summary = this.getSummary(skill);
-    const content = [skill.name, summary, skill.tags.join(" ")].join(" ");
-    return Math.ceil(content.length / 4);
+    const parts = [skill.name, summary, skill.tags.join(" ")];
+    if (skill.serving?.instructionPreview) {
+      parts.push(skill.serving.instructionPreview);
+    }
+    return Math.ceil(parts.join(" ").length / 4);
   }
 };
 
 // src/serving/profiles/index.ts
-init_cjs_shims();
 var codeReviewProfile = {
   tags: ["review", "quality", "security", "best-practices"],
   taskDescription: "review code for quality, security, and best practices",
@@ -3879,6 +4280,10 @@ var builtInProfiles = {
 };
 
 // src/serving/graph-server.ts
+var DEFAULT_CONFIDENCE_THRESHOLDS = {
+  expandAbove: 0.3,
+  includeAbove: 0.15
+};
 var DEFAULT_CONFIG4 = {
   agentCanModify: true,
   agentCanSetLoadout: false,
@@ -3886,8 +4291,16 @@ var DEFAULT_CONFIG4 = {
   requireApproval: false,
   autoExpandOnUse: true,
   autoExpandRelated: true,
-  maxExpanded: 5,
+  // Default cap on simultaneously-expanded (full-body) skills. Set to 3:
+  // on the SkillsBench selection benchmark the true-positive skill lands in
+  // the top 3 every time, so 3 (vs 5) lifts loadout precision ~23%→38% with
+  // zero recall loss — fewer irrelevant bodies injected into context.
+  maxExpanded: 3,
   evictionStrategy: "lru",
+  confidenceThresholds: DEFAULT_CONFIDENCE_THRESHOLDS,
+  retrieval: {},
+  scoringPoolSize: 200,
+  deferExpansion: false,
   persistState: false,
   outputFormat: "xml",
   includeTokenEstimates: false,
@@ -3895,18 +4308,22 @@ var DEFAULT_CONFIG4 = {
   profiles: {}
 };
 var SkillGraphServer = class {
-  // Track LRU for eviction
   constructor(storage, config2) {
     this.storage = storage;
     this.catalogRenderer = null;
     this.handlers = /* @__PURE__ */ new Set();
     this.lruOrder = [];
+    this.relevanceScores = /* @__PURE__ */ new Map();
     this.config = {
       ...DEFAULT_CONFIG4,
       ...config2,
-      profiles: { ...builtInProfiles, ...DEFAULT_CONFIG4.profiles, ...config2?.profiles }
+      profiles: { ...builtInProfiles, ...DEFAULT_CONFIG4.profiles, ...config2?.profiles },
+      confidenceThresholds: { ...DEFAULT_CONFIDENCE_THRESHOLDS, ...config2?.confidenceThresholds }
     };
-    this.compiler = new LoadoutCompiler(storage);
+    this.compiler = new LoadoutCompiler(storage, {
+      retrieval: this.config.retrieval,
+      scoringPoolSize: this.config.scoringPoolSize
+    });
     this.projectDetector = new ProjectDetector();
     this.viewRenderer = new ViewRenderer({
       includeTokenEstimates: this.config.includeTokenEstimates
@@ -3947,11 +4364,32 @@ var SkillGraphServer = class {
     return this.applyLoadout(skills, { type: "criteria", criteria });
   }
   /**
-   * Set loadout based on task description (semantic matching)
+   * Set loadout based on task description using hybrid confidence-tiered
+   * compilation. Skills above the high threshold are auto-expanded,
+   * skills between high and low thresholds are included as summaries,
+   * and skills below the low threshold are excluded.
+   *
+   * Stores relevance scores for use by the 'relevance' eviction strategy.
    */
   async setLoadoutForTask(taskDescription) {
-    const skills = await this.compiler.compileForTask(taskDescription);
-    return this.applyLoadout(skills, { type: "task", taskDescription });
+    const scored = await this.compiler.compileWithScoring(taskDescription);
+    const { expand, summarize, excluded } = this.compiler.partitionByConfidence(
+      scored,
+      this.config.confidenceThresholds
+    );
+    const allIncluded = [...expand, ...summarize];
+    const skills = allIncluded.map((s) => s.skill);
+    const state = this.applyLoadout(skills, { type: "task", taskDescription });
+    for (const item of allIncluded) {
+      this.relevanceScores.set(item.skill.id, item.relevanceScore);
+    }
+    for (const item of expand) {
+      if (this.state.expanded.size >= this.config.maxExpanded) break;
+      this.state.expanded.add(item.skill.id);
+      this.touchLru(item.skill.id);
+      this.emit({ type: "skill:expanded", skillId: item.skill.id });
+    }
+    return state;
   }
   /**
    * Set loadout based on detected project context
@@ -4151,12 +4589,8 @@ var SkillGraphServer = class {
    * Returns skill summaries for display
    */
   async agentSearchSkills(query, limit = 5) {
-    const allSkills = await this.storage.listSkills({ status: ["active"] });
-    const queryLower = query.toLowerCase();
-    const matches = allSkills.filter(
-      (skill) => skill.name.toLowerCase().includes(queryLower) || skill.description.toLowerCase().includes(queryLower) || skill.instructions.toLowerCase().includes(queryLower) || skill.tags.some((tag) => tag.toLowerCase().includes(queryLower))
-    ).slice(0, limit);
-    return matches.map((skill) => ({
+    const matches = await this.storage.searchSkills(query);
+    return matches.slice(0, limit).map((skill) => ({
       id: skill.id,
       name: skill.name,
       description: this.getSummary(skill),
@@ -4197,19 +4631,19 @@ var SkillGraphServer = class {
    * Returns rendered category view (subcategories or skill summaries at leaf).
    * Pass no path for the top-level overview.
    */
-  async agentBrowseCatalog(path18) {
+  async agentBrowseCatalog(path19) {
     if (!this.catalogRenderer) {
       return "<error>Catalog browsing is not enabled</error>";
     }
-    if (!path18 || path18.length === 0) {
+    if (!path19 || path19.length === 0) {
       const result2 = await this.catalogRenderer.renderOverview();
       if (result2) {
         this.emit({ type: "catalog:browsed", path: [] });
       }
       return result2;
     }
-    const result = await this.catalogRenderer.renderCategory(path18);
-    this.emit({ type: "catalog:browsed", path: path18 });
+    const result = await this.catalogRenderer.renderCategory(path19);
+    this.emit({ type: "catalog:browsed", path: path19 });
     return result;
   }
   /**
@@ -4241,13 +4675,25 @@ var SkillGraphServer = class {
   /**
    * Render current state as system prompt content.
    * Includes catalog overview when catalog is enabled.
+   *
+   * When `deferExpansion` is enabled, all skills are rendered as
+   * summaries regardless of expansion state — the agent must
+   * explicitly request expansion. This avoids the reactive-signals
+   * problem where upfront skill injection derails model planning.
    */
   async renderSystemPrompt() {
+    let renderState = this.state;
+    if (this.config.deferExpansion) {
+      renderState = {
+        ...this.state,
+        expanded: /* @__PURE__ */ new Set()
+      };
+    }
     let prompt;
     if (this.config.outputFormat === "markdown") {
-      prompt = this.viewRenderer.renderMarkdown(this.state);
+      prompt = this.viewRenderer.renderMarkdown(renderState);
     } else {
-      prompt = this.viewRenderer.renderXml(this.state);
+      prompt = this.viewRenderer.renderXml(renderState);
     }
     if (this.catalogRenderer) {
       const overview = await this.catalogRenderer.renderOverview();
@@ -4285,21 +4731,70 @@ var SkillGraphServer = class {
   // PRIVATE HELPERS
   // ===========================================================================
   /**
-   * Apply a new set of skills as the loadout
+   * Get the relevance score for a skill (0 if not scored).
+   */
+  getRelevanceScore(skillId) {
+    return this.relevanceScores.get(skillId) ?? 0;
+  }
+  /**
+   * Apply a new set of skills as the loadout.
+   * After populating the available set, evaluates autoExpand triggers
+   * on each skill to determine if any should be pre-expanded.
    */
   applyLoadout(skills, source) {
     this.state.available.clear();
     this.state.expanded.clear();
     this.state.pending.clear();
     this.lruOrder = [];
+    this.relevanceScores.clear();
     for (const skill of skills) {
       this.state.available.set(skill.id, skill);
     }
+    this.evaluateAutoExpand(source);
     this.state.source = source;
     this.state.updatedAt = /* @__PURE__ */ new Date();
     this.emit({ type: "loadout:changed", state: this.state });
     return this.state;
   }
+  /**
+   * Evaluate autoExpand trigger conditions for all skills in the loadout.
+   * Checks keyword matches against the task description, file pattern
+   * matches against the project path, and framework matches.
+   */
+  evaluateAutoExpand(source) {
+    const taskText = source.taskDescription ?? "";
+    for (const [id, skill] of this.state.available) {
+      if (this.state.expanded.size >= this.config.maxExpanded) break;
+      if (this.state.expanded.has(id)) continue;
+      const triggers = skill.serving?.autoExpand;
+      if (!triggers || triggers.length === 0) continue;
+      for (const trigger of triggers) {
+        if (this.matchesTrigger(trigger, taskText, source)) {
+          this.state.expanded.add(id);
+          this.touchLru(id);
+          this.emit({ type: "skill:expanded", skillId: id });
+          break;
+        }
+      }
+    }
+  }
+  /**
+   * Check if a single autoExpand trigger matches the current context.
+   */
+  matchesTrigger(trigger, taskText, source) {
+    const conditions = trigger.conditions;
+    if (!conditions) return false;
+    const taskLower = taskText.toLowerCase();
+    if (trigger.on === "mention" && conditions.keywords?.length) {
+      return conditions.keywords.some((kw) => taskLower.includes(kw.toLowerCase()));
+    }
+    if (trigger.on === "file-match" && conditions.filePatterns?.length && source.projectPath) {
+      return conditions.filePatterns.some(
+        (pattern) => source.projectPath.includes(pattern)
+      );
+    }
+    return false;
+  }
   /**
    * Evict a skill from expanded based on strategy
    */
@@ -4310,7 +4805,7 @@ var SkillGraphServer = class {
       case "lru":
         toEvict = this.lruOrder.shift();
         break;
-      case "priority":
+      case "priority": {
         let lowestPriority = Infinity;
         for (const id of this.state.expanded) {
           const skill = this.state.available.get(id);
@@ -4321,6 +4816,18 @@ var SkillGraphServer = class {
           }
         }
         break;
+      }
+      case "relevance": {
+        let lowestScore = Infinity;
+        for (const id of this.state.expanded) {
+          const score = this.relevanceScores.get(id) ?? 0;
+          if (score < lowestScore) {
+            lowestScore = score;
+            toEvict = id;
+          }
+        }
+        break;
+      }
       case "manual":
         return;
     }
@@ -4376,7 +4883,6 @@ var SkillGraphServer = class {
 };
 
 // src/serving/interfaces.ts
-init_cjs_shims();
 function createStorageView(storage) {
   return {
     getSkill: storage.getSkill.bind(storage),
@@ -4416,11 +4922,7 @@ function createServingEventBridge() {
   };
 }
 
-// src/federation/index.ts
-init_cjs_shims();
-
 // src/federation/remote-store.ts
-init_cjs_shims();
 var fs3 = __toESM(require("fs"));
 var path3 = __toESM(require("path"));
 var REMOTES_FILE = "remotes.json";
@@ -4616,14 +5118,12 @@ var RemoteStore = class {
 };
 
 // src/federation/remote-manager.ts
-init_cjs_shims();
 var fs5 = __toESM(require("fs"));
 var path5 = __toESM(require("path"));
 var import_child_process = require("child_process");
 var import_util = require("util");
 
 // src/federation/skilltree-config.ts
-init_cjs_shims();
 var fs4 = __toESM(require("fs"));
 var path4 = __toESM(require("path"));
 function resolveSkilltreeDir(repoRoot) {
@@ -5292,11 +5792,7 @@ ${body.join("\n")}
   }
 };
 
-// src/federation/federation-manager.ts
-init_cjs_shims();
-
 // src/versioning/semver.ts
-init_cjs_shims();
 function parseVersion(version) {
   const match = version.match(
     /^(\d+)\.(\d+)\.(\d+)(?:-([a-zA-Z0-9.-]+))?(?:\+([a-zA-Z0-9.-]+))?$/
@@ -5846,13 +6342,11 @@ ${remote.instructions}` : remote.instructions,
 init_base();
 
 // src/storage/cached.ts
-init_cjs_shims();
 var fs8 = __toESM(require("fs"));
 var path8 = __toESM(require("path"));
 init_base();
 
 // src/storage/filesystem.ts
-init_cjs_shims();
 var fs6 = __toESM(require("fs/promises"));
 var path6 = __toESM(require("path"));
 init_base();
@@ -6507,11 +7001,7 @@ var CachedStorageAdapter = class extends BaseStorageAdapter {
   }
 };
 
-// src/versioning/index.ts
-init_cjs_shims();
-
 // src/versioning/lineage.ts
-init_cjs_shims();
 var LineageTracker = class {
   constructor(storage) {
     this.storage = storage;
@@ -6754,11 +7244,7 @@ ${source}`;
   }
 };
 
-// src/versioning/merge.ts
-init_cjs_shims();
-
 // src/hooks/registry.ts
-init_cjs_shims();
 var import_crypto = require("crypto");
 var PRIORITY_ORDER = {
   high: 0,
@@ -6943,7 +7429,6 @@ var HookRegistry = class {
 var hookRegistry = new HookRegistry();
 
 // src/materialization/materializer.ts
-init_cjs_shims();
 var fs10 = __toESM(require("fs"));
 var path10 = __toESM(require("path"));
 var SKILLTREE_MARKER_START = "<!-- SKILLTREE_START -->";
@@ -7691,8 +8176,7 @@ var SkillBank = class {
    * The `loadout:changed` event is currently the only one we react to.
    * Earlier versions also handled `skill:used` / `skill:feedback` to mutate
    * `Skill.metrics`, but skill-tree no longer tracks per-skill usage —
-   * cognitive-core owns that signal via `playbook.evolution.*`. See
-   * docs/SKILL_TREE_METRICS_DEPRECATION.md.
+   * cognitive-core owns that signal via `playbook.evolution.*`.
    */
   async handleServingEvent(event) {
     switch (event.type) {
@@ -7797,38 +8281,15 @@ var SkillBank = class {
 };
 
 // src/storage/index.ts
-init_cjs_shims();
 init_base();
 init_sqlite();
 
-// src/storage/migration.ts
-init_cjs_shims();
-
 // src/agents/index.ts
-init_cjs_shims();
 init_types();
 init_generator();
 init_parser();
 init_sync();
 
-// src/hooks/index.ts
-init_cjs_shims();
-
-// src/hooks/builtin.ts
-init_cjs_shims();
-
-// src/serving/index.ts
-init_cjs_shims();
-
-// src/materialization/index.ts
-init_cjs_shims();
-
-// src/sync/index.ts
-init_cjs_shims();
-
-// src/sync/hierarchical-sync-adapter.ts
-init_cjs_shims();
-
 // src/sync/index.ts
 function createDefaultSyncConfig(remoteUrl, agentId, options) {
   return {
@@ -7858,15 +8319,10 @@ function createDefaultSyncConfig(remoteUrl, agentId, options) {
 }
 
 // src/services/indexer.ts
-init_cjs_shims();
 var path12 = __toESM(require("path"));
 var fs12 = __toESM(require("fs"));
 
-// src/config/index.ts
-init_cjs_shims();
-
 // src/config/types.ts
-init_cjs_shims();
 var DEFAULT_CONFIG6 = {
   storage: {
     path: "~/.skill-tree"
@@ -7901,7 +8357,6 @@ var DEFAULT_CONFIG6 = {
 };
 
 // src/config/loader.ts
-init_cjs_shims();
 var fs11 = __toESM(require("fs"));
 var path11 = __toESM(require("path"));
 var os = __toESM(require("os"));
@@ -7953,8 +8408,8 @@ function substituteEnvVarsInObject(obj) {
   }
   return obj;
 }
-function setNestedProperty(obj, path18, value) {
-  const parts = path18.split(".");
+function setNestedProperty(obj, path19, value) {
+  const parts = path19.split(".");
   let current = obj;
   for (let i = 0; i < parts.length - 1; i++) {
     const part = parts[i];
@@ -8113,8 +8568,8 @@ var ConfigLoader = class {
   /**
    * Get a specific config value by path
    */
-  get(path18) {
-    const parts = path18.split(".");
+  get(path19) {
+    const parts = path19.split(".");
     let current = this.getConfig();
     for (const part of parts) {
       if (current === null || typeof current !== "object") {
@@ -8197,7 +8652,6 @@ function loadConfig(configPath) {
 }
 
 // src/import/converter.ts
-init_cjs_shims();
 function convertIndexerSkill(indexerSkill) {
   const warnings = [];
   const instructions = indexerSkill.content || "";
@@ -9060,20 +9514,349 @@ function createIntegratedIndexer(skillBank, config2 = {}) {
   return new IndexerService(config2, skillBank);
 }
 
+// src/import/skillmd.ts
+function splitFrontmatter(content) {
+  const normalized = content.replace(/\r\n/g, "\n");
+  const match = normalized.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+  if (match) {
+    return { frontmatter: match[1], body: match[2], hasFrontmatter: true };
+  }
+  return { frontmatter: "", body: normalized, hasFrontmatter: false };
+}
+function extractField(yaml, field) {
+  const match = yaml.match(new RegExp(`^${field}:\\s*(.+)$`, "m"));
+  if (!match) return void 0;
+  return match[1].trim().replace(/^["']|["']$/g, "");
+}
+function extractMultiline(yaml, field) {
+  const match = yaml.match(
+    new RegExp(`^${field}:\\s*\\|\\n((?:\\s{2}.+\\n?)+)`, "m")
+  );
+  if (match) {
+    return match[1].split("\n").map((line) => line.replace(/^\s{2}/, "")).join("\n").trim();
+  }
+  return extractField(yaml, field);
+}
+function extractList(yaml, field) {
+  const match = yaml.match(new RegExp(`^${field}:\\n((?:\\s+-\\s+.+\\n?)+)`, "m"));
+  if (match) {
+    return match[1].split("\n").map((line) => line.replace(/^\s+-\s+/, "").trim().replace(/^["']|["']$/g, "")).filter((line) => line.length > 0);
+  }
+  return [];
+}
+function parseSkillMd(content) {
+  const { frontmatter, body, hasFrontmatter } = splitFrontmatter(content);
+  return {
+    name: extractField(frontmatter, "name"),
+    description: extractMultiline(frontmatter, "description"),
+    version: extractField(frontmatter, "version"),
+    author: extractField(frontmatter, "author"),
+    status: extractField(frontmatter, "status"),
+    date: extractField(frontmatter, "date"),
+    tags: extractList(frontmatter, "tags"),
+    body: body.trim(),
+    hasFrontmatter
+  };
+}
+
+// src/import/skill-from-md.ts
+var VALID_STATUSES2 = ["draft", "active", "deprecated", "experimental"];
+function slugify(input) {
+  return input.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80) || "skill";
+}
+function skillFromSkillMd(content, options = {}) {
+  const warnings = [];
+  const parsed = parseSkillMd(content);
+  if (!parsed.hasFrontmatter) {
+    warnings.push("SKILL.md has no YAML frontmatter; using fallback metadata");
+  }
+  if (!parsed.body) {
+    warnings.push("SKILL.md body is empty; instructions will be empty");
+  }
+  const id = slugify(options.id || parsed.name || options.defaultName || "skill");
+  const tags = new Set(parsed.tags);
+  for (const tag of options.extraTags ?? []) {
+    if (tag) tags.add(tag);
+  }
+  const status = parsed.status && VALID_STATUSES2.includes(parsed.status) ? parsed.status : options.defaultStatus ?? "active";
+  const now = options.now ?? /* @__PURE__ */ new Date();
+  const skill = {
+    id,
+    name: parsed.name || options.defaultName || id,
+    version: parsed.version || options.defaultVersion || "1.0.0",
+    description: parsed.description || options.defaultDescription || "",
+    instructions: parsed.body,
+    author: parsed.author || options.defaultAuthor || "unknown",
+    tags: Array.from(tags),
+    createdAt: now,
+    updatedAt: now,
+    status,
+    source: options.source,
+    taxonomy: options.taxonomyPath && options.taxonomyPath.length > 0 ? { primaryPath: options.taxonomyPath } : void 0,
+    externalSource: options.externalSource
+  };
+  return { skill, warnings, parsed };
+}
+
+// src/services/skillnet.ts
+var DEFAULT_SKILLNET_API = "http://api-skillnet.openkg.cn/v1";
+function parseGitHubUrl(url) {
+  const m = url.match(
+    /github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:\/(?:tree|blob)\/([^/]+)\/(.*))?$/
+  );
+  if (!m) return null;
+  const [, owner, repo, ref, path19] = m;
+  return {
+    owner,
+    repo,
+    ref: ref || "main",
+    path: (path19 || "").replace(/\/$/, "")
+  };
+}
+var SkillNetClient = class {
+  constructor(config2 = {}) {
+    this.apiBaseUrl = (config2.apiBaseUrl || DEFAULT_SKILLNET_API).replace(/\/$/, "");
+    this.githubToken = config2.githubToken;
+    this.githubMirror = config2.githubMirror;
+    const resolved = config2.fetchImpl || globalThis.fetch;
+    if (!resolved) {
+      throw new Error(
+        "No fetch implementation available. Provide config.fetchImpl or run on Node 18+."
+      );
+    }
+    this.fetchImpl = resolved;
+  }
+  /**
+   * Search the SkillNet index. Free and requires no API key.
+   */
+  async search(query, options = {}) {
+    const params = new URLSearchParams({ q: query });
+    if (options.mode) params.set("mode", options.mode);
+    if (options.category) params.set("category", options.category);
+    if (options.limit != null) params.set("limit", String(options.limit));
+    if (options.page != null) params.set("page", String(options.page));
+    if (options.minStars != null) params.set("min_stars", String(options.minStars));
+    if (options.sortBy) params.set("sort_by", options.sortBy);
+    if (options.threshold != null) params.set("threshold", String(options.threshold));
+    const url = `${this.apiBaseUrl}/search?${params.toString()}`;
+    const res = await this.fetchImpl(url);
+    if (!res.ok) {
+      throw new Error(`SkillNet search failed: ${res.status} ${res.statusText}`);
+    }
+    const body = await res.json();
+    const rows = Array.isArray(body.data) ? body.data : [];
+    return rows.map((row) => ({
+      skillName: String(row.skill_name ?? ""),
+      skillDescription: row.skill_description != null ? String(row.skill_description) : void 0,
+      author: row.author != null ? String(row.author) : void 0,
+      stars: typeof row.stars === "number" ? row.stars : Number(row.stars) || 0,
+      skillUrl: String(row.skill_url ?? ""),
+      category: row.category != null ? String(row.category) : void 0,
+      evaluation: row.evaluation && typeof row.evaluation === "object" ? row.evaluation : void 0
+    }));
+  }
+  /**
+   * Convert a GitHub skill URL into the raw URL for its SKILL.md.
+   * Applies the configured mirror prefix when set.
+   */
+  toRawSkillMdUrl(skillUrl) {
+    const parsed = parseGitHubUrl(skillUrl);
+    if (!parsed) {
+      throw new Error(`Not a recognizable GitHub skill URL: ${skillUrl}`);
+    }
+    const { owner, repo, ref, path: path19 } = parsed;
+    const filePath = /SKILL\.md$/i.test(path19) ? path19 : path19 ? `${path19}/SKILL.md` : "SKILL.md";
+    const raw = `https://raw.githubusercontent.com/${owner}/${repo}/${ref}/${filePath}`;
+    return this.githubMirror ? `${this.githubMirror.replace(/\/$/, "")}/${raw}` : raw;
+  }
+  /**
+   * Fetch the raw SKILL.md content for a skill URL.
+   */
+  async fetchSkillMd(skillUrl) {
+    const rawUrl = this.toRawSkillMdUrl(skillUrl);
+    const headers = {};
+    if (this.githubToken) {
+      headers.Authorization = `Bearer ${this.githubToken}`;
+    }
+    const res = await this.fetchImpl(rawUrl, { headers });
+    if (!res.ok) {
+      throw new Error(
+        `Failed to fetch SKILL.md (${res.status} ${res.statusText}): ${rawUrl}`
+      );
+    }
+    return { content: await res.text(), rawUrl };
+  }
+  /**
+   * Convert a SkillNet search result + its SKILL.md content into a skill-tree Skill.
+   */
+  convertSkillNetSkill(result, content, rawUrl) {
+    const gh = parseGitHubUrl(result.skillUrl);
+    const folderName = gh?.path ? gh.path.split("/").filter(Boolean).pop() : void 0;
+    const now = /* @__PURE__ */ new Date();
+    const { skill, warnings } = skillFromSkillMd(content, {
+      id: folderName || result.skillName,
+      defaultName: result.skillName,
+      defaultDescription: result.skillDescription,
+      defaultAuthor: result.author || "skillnet",
+      // SkillNet skills are curated/published → default active.
+      defaultStatus: "active",
+      extraTags: [
+        ...result.category ? [result.category.toLowerCase()] : [],
+        ...gh?.repo ? [gh.repo] : []
+      ],
+      taxonomyPath: result.category ? [result.category] : void 0,
+      source: {
+        type: "imported",
+        location: result.skillUrl,
+        importedAt: now
+      },
+      externalSource: {
+        url: result.skillUrl,
+        repo: gh ? `${gh.owner}/${gh.repo}` : "",
+        scrapedAt: now
+      },
+      now
+    });
+    return { skill, warnings, rawUrl };
+  }
+  /**
+   * Import a single skill by its SkillNet/GitHub URL into a SkillBank.
+   */
+  async importSkill(skillUrl, bank, meta = {}) {
+    const { content, rawUrl } = await this.fetchSkillMd(skillUrl);
+    const result = {
+      skillName: meta.skillName || "",
+      skillDescription: meta.skillDescription,
+      author: meta.author,
+      stars: meta.stars ?? 0,
+      skillUrl,
+      category: meta.category,
+      evaluation: meta.evaluation
+    };
+    const converted = this.convertSkillNetSkill(result, content, rawUrl);
+    await bank.saveSkill(converted.skill);
+    return converted;
+  }
+  /**
+   * Search SkillNet and import the matching skills into a SkillBank.
+   */
+  async importFromSearch(query, bank, options = {}) {
+    const result = {
+      imported: 0,
+      failed: 0,
+      skills: [],
+      errors: []
+    };
+    const results = await this.search(query, options);
+    for (const row of results) {
+      if (!row.skillUrl) {
+        result.failed++;
+        result.errors.push(`Skipped "${row.skillName}": no skill_url`);
+        continue;
+      }
+      try {
+        const converted = await this.importSkill(row.skillUrl, bank, row);
+        result.imported++;
+        result.skills.push(converted.skill);
+      } catch (err) {
+        result.failed++;
+        result.errors.push(
+          `Failed to import ${row.skillUrl}: ${err.message}`
+        );
+      }
+    }
+    return result;
+  }
+};
+function createSkillNetClient(config2 = {}) {
+  return new SkillNetClient(config2);
+}
+
+// src/import/local.ts
+var fs13 = __toESM(require("fs/promises"));
+var path13 = __toESM(require("path"));
+var SKILL_FILE_RE = /^skill\.md$/i;
+async function findSkillMdFiles(root, maxDepth = 6) {
+  const found = [];
+  async function walk(dir, depth) {
+    if (depth > maxDepth) return;
+    let entries;
+    try {
+      entries = await fs13.readdir(dir, { withFileTypes: true });
+    } catch (err) {
+      if (err.code === "ENOENT") return;
+      throw err;
+    }
+    for (const entry of entries) {
+      if (entry.isFile() && SKILL_FILE_RE.test(entry.name)) {
+        found.push({
+          filePath: path13.join(dir, entry.name),
+          directory: dir,
+          id: path13.basename(dir)
+        });
+      }
+    }
+    for (const entry of entries) {
+      if (entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules") {
+        await walk(path13.join(dir, entry.name), depth + 1);
+      }
+    }
+  }
+  await walk(root, 0);
+  return found;
+}
+async function importSkillMdFile(filePath, bank, options = {}) {
+  const content = await fs13.readFile(filePath, "utf-8");
+  const dirName = path13.basename(path13.dirname(filePath));
+  const now = /* @__PURE__ */ new Date();
+  const { skill, warnings } = skillFromSkillMd(content, {
+    source: { type: "imported", location: filePath, importedAt: now },
+    now,
+    ...options,
+    id: options.id ?? dirName
+  });
+  await bank.saveSkill(skill);
+  return { skill, warnings };
+}
+async function importLocalSkillDir(dirPath, bank, options = {}) {
+  const result = {
+    imported: 0,
+    failed: 0,
+    skills: [],
+    errors: []
+  };
+  const files = await findSkillMdFiles(dirPath);
+  const seen = /* @__PURE__ */ new Set();
+  for (const file of files) {
+    if (seen.has(file.id)) {
+      result.errors.push(`Skipped duplicate id "${file.id}" at ${file.filePath}`);
+      continue;
+    }
+    try {
+      const { skill } = await importSkillMdFile(file.filePath, bank, {
+        ...options,
+        id: file.id
+      });
+      seen.add(skill.id);
+      result.imported++;
+      result.skills.push(skill);
+    } catch (err) {
+      result.failed++;
+      result.errors.push(`Failed to import ${file.filePath}: ${err.message}`);
+    }
+  }
+  return result;
+}
+
 // src/index.ts
-var VERSION = "0.2.0";
+var VERSION = "0.3.0";
 
 // src/cli/commands/list.ts
-init_cjs_shims();
 var import_commander = require("commander");
 
-// src/cli/utils/skillbank.ts
-init_cjs_shims();
-
 // src/cli/utils/paths.ts
-init_cjs_shims();
-var fs13 = __toESM(require("fs"));
-var path13 = __toESM(require("path"));
+var fs14 = __toESM(require("fs"));
+var path14 = __toESM(require("path"));
 var os2 = __toESM(require("os"));
 var DEFAULT_PATHS = [
   ".claude/skills",
@@ -9087,13 +9870,13 @@ var DEFAULT_PATHS = [
 ];
 function expandHome(p) {
   if (p.startsWith("~/")) {
-    return path13.join(os2.homedir(), p.slice(2));
+    return path14.join(os2.homedir(), p.slice(2));
   }
   return p;
 }
 function dirExists(p) {
   try {
-    return fs13.statSync(p).isDirectory();
+    return fs14.statSync(p).isDirectory();
   } catch {
     return false;
   }
@@ -9101,23 +9884,23 @@ function dirExists(p) {
 function resolveSkillPath(explicitPath) {
   if (explicitPath) {
     const resolved = expandHome(explicitPath);
-    return path13.resolve(resolved);
+    return path14.resolve(resolved);
   }
   const envPath = process.env.SKILL_TREE_PATH;
   if (envPath) {
-    return path13.resolve(expandHome(envPath));
+    return path14.resolve(expandHome(envPath));
   }
   for (const defaultPath of DEFAULT_PATHS) {
-    const resolved = path13.resolve(expandHome(defaultPath));
+    const resolved = path14.resolve(expandHome(defaultPath));
     if (dirExists(resolved)) {
       return resolved;
     }
   }
-  return path13.resolve(".claude/skills");
+  return path14.resolve(".claude/skills");
 }
 function ensureDir(dir) {
   if (!dirExists(dir)) {
-    fs13.mkdirSync(dir, { recursive: true });
+    fs14.mkdirSync(dir, { recursive: true });
   }
 }
 
@@ -9154,7 +9937,6 @@ function getSkillPath(options) {
 var getSkillBank = createSkillBankFromOptions;
 
 // src/cli/utils/output.ts
-init_cjs_shims();
 var import_chalk = __toESM(require("chalk"));
 function formatSkillLine(skill) {
   const status = formatStatus(skill.status);
@@ -9336,7 +10118,6 @@ var listCommand = new import_commander.Command("list").description("List all ski
 });
 
 // src/cli/commands/show.ts
-init_cjs_shims();
 var import_commander2 = require("commander");
 var showCommand = new import_commander2.Command("show").description("Show skill details").argument("<id>", "Skill ID").option("-v, --version <version>", "Show specific version").action(async (id, options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -9359,7 +10140,6 @@ var showCommand = new import_commander2.Command("show").description("Show skill
 });
 
 // src/cli/commands/search.ts
-init_cjs_shims();
 var import_commander3 = require("commander");
 var searchCommand = new import_commander3.Command("search").description("Search skills by text").argument("<query>", "Search query").action(async (query, options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -9392,7 +10172,6 @@ var searchCommand = new import_commander3.Command("search").description("Search
 });
 
 // src/cli/commands/stats.ts
-init_cjs_shims();
 var import_commander4 = require("commander");
 var statsCommand = new import_commander4.Command("stats").description("Show skill bank statistics").action(async (options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -9411,7 +10190,6 @@ var statsCommand = new import_commander4.Command("stats").description("Show skil
 });
 
 // src/cli/commands/versions.ts
-init_cjs_shims();
 var import_commander5 = require("commander");
 var versionsCommand = new import_commander5.Command("versions").description("Show version history for a skill").argument("<id>", "Skill ID").action(async (id, options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -9434,7 +10212,6 @@ var versionsCommand = new import_commander5.Command("versions").description("Sho
 });
 
 // src/cli/commands/diff.ts
-init_cjs_shims();
 var import_commander6 = require("commander");
 var diffCommand = new import_commander6.Command("diff").description("Compare two versions of a skill").argument("<id>", "Skill ID").argument("<version-a>", "First version").argument("<version-b>", "Second version").action(async (id, versionA, versionB, options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -9453,7 +10230,6 @@ var diffCommand = new import_commander6.Command("diff").description("Compare two
 });
 
 // src/cli/commands/rollback.ts
-init_cjs_shims();
 var import_commander7 = require("commander");
 var rollbackCommand = new import_commander7.Command("rollback").description("Rollback a skill to a previous version").argument("<id>", "Skill ID").requiredOption("--to <version>", "Version to rollback to").action(async (id, options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -9472,7 +10248,6 @@ var rollbackCommand = new import_commander7.Command("rollback").description("Rol
 });
 
 // src/cli/commands/fork.ts
-init_cjs_shims();
 var import_commander8 = require("commander");
 var forkCommand = new import_commander8.Command("fork").description("Fork a skill to create a variant").argument("<id>", "Skill ID to fork from").requiredOption("--new-id <id>", "ID for the new forked skill").requiredOption("--reason <reason>", "Reason for forking").option("--name <name>", "Name for the forked skill").option("--from-version <version>", "Version to fork from (defaults to latest)").action(async (id, options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -9496,7 +10271,6 @@ var forkCommand = new import_commander8.Command("fork").description("Fork a skil
 });
 
 // src/cli/commands/deprecate.ts
-init_cjs_shims();
 var import_commander9 = require("commander");
 var deprecateCommand = new import_commander9.Command("deprecate").description("Mark a skill as deprecated").argument("<id>", "Skill ID").action(async (id, options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -9515,7 +10289,6 @@ var deprecateCommand = new import_commander9.Command("deprecate").description("M
 });
 
 // src/cli/commands/activate.ts
-init_cjs_shims();
 var import_commander10 = require("commander");
 var activateCommand = new import_commander10.Command("activate").description("Mark a skill as active").argument("<id>", "Skill ID").action(async (id, options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -9541,7 +10314,6 @@ var activateCommand = new import_commander10.Command("activate").description("Ma
 });
 
 // src/cli/commands/delete.ts
-init_cjs_shims();
 var import_commander11 = require("commander");
 var deleteCommand = new import_commander11.Command("delete").description("Delete a skill").argument("<id>", "Skill ID").option("-f, --force", "Skip confirmation").option("-v, --version <version>", "Delete specific version only").action(async (id, options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -9574,9 +10346,8 @@ var deleteCommand = new import_commander11.Command("delete").description("Delete
 });
 
 // src/cli/commands/export.ts
-init_cjs_shims();
 var import_commander12 = require("commander");
-var fs14 = __toESM(require("fs"));
+var fs15 = __toESM(require("fs"));
 var exportCommand = new import_commander12.Command("export").description("Export all skills to JSON").option("-o, --output <file>", "Output file path (defaults to stdout)").action(async (options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
@@ -9584,7 +10355,7 @@ var exportCommand = new import_commander12.Command("export").description("Export
     const skills = await skillBank.exportAll();
     const json = JSON.stringify(skills, null, 2);
     if (options.output) {
-      fs14.writeFileSync(options.output, json, "utf-8");
+      fs15.writeFileSync(options.output, json, "utf-8");
       if (!globalOpts.quiet) {
         printSuccess(`Exported ${skills.length} skill(s) to ${options.output}`);
       }
@@ -9598,15 +10369,10 @@ var exportCommand = new import_commander12.Command("export").description("Export
 });
 
 // src/cli/commands/import.ts
-init_cjs_shims();
 var import_commander13 = require("commander");
-var fs15 = __toESM(require("fs"));
-
-// src/import/index.ts
-init_cjs_shims();
+var fs16 = __toESM(require("fs"));
 
 // src/import/detect.ts
-init_cjs_shims();
 function isSkillTreeSkill(obj) {
   if (typeof obj !== "object" || obj === null) return false;
   const skill = obj;
@@ -9663,14 +10429,38 @@ function isLikelyIndexerFormat(content) {
 }
 
 // src/cli/commands/import.ts
-var importCommand = new import_commander13.Command("import").description("Import skills from JSON file").argument("<file>", "JSON file to import").option("--from-indexer", "Import from skill-indexer export format").option("--auto-detect", "Auto-detect format (default: true)", true).action(async (file, options, command) => {
+var importCommand = new import_commander13.Command("import").description("Import skills from a JSON file, a SKILL.md file, or a directory of skills").argument("<path>", "JSON file, SKILL.md file, or directory to import").option("--from-indexer", "Import from skill-indexer export format").option("--skill-md", "Treat input as SKILL.md (auto-detected for directories and .md files)").option("--auto-detect", "Auto-detect format (default: true)", true).action(async (file, options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
-    if (!fs15.existsSync(file)) {
-      printError(`File not found: ${file}`);
+    if (!fs16.existsSync(file)) {
+      printError(`Path not found: ${file}`);
       process.exit(1);
     }
-    const content = fs15.readFileSync(file, "utf-8");
+    const stat = fs16.statSync(file);
+    const isMarkdown = options.skillMd || stat.isDirectory() || /\.md$/i.test(file);
+    if (isMarkdown) {
+      const bank = await createSkillBankFromOptions(globalOpts);
+      if (stat.isDirectory()) {
+        const result2 = await importLocalSkillDir(file, bank);
+        if (globalOpts.json) {
+          console.log(JSON.stringify(result2, null, 2));
+          return;
+        }
+        printSuccess(`Imported ${result2.imported} skill(s) from ${file}`);
+        if (result2.failed > 0) printWarning(`Failed to import ${result2.failed} skill(s)`);
+        for (const e of result2.errors) printInfo(`  - ${e}`);
+      } else {
+        const { skill, warnings } = await importSkillMdFile(file, bank);
+        if (globalOpts.json) {
+          console.log(JSON.stringify({ imported: 1, skill: skill.id, warnings }, null, 2));
+          return;
+        }
+        printSuccess(`Imported "${skill.id}"`);
+        for (const w of warnings) printWarning(w);
+      }
+      return;
+    }
+    const content = fs16.readFileSync(file, "utf-8");
     let skills;
     const isIndexerFormat = options.fromIndexer || options.autoDetect !== false && isLikelyIndexerFormat(content);
     if (isIndexerFormat) {
@@ -9729,11 +10519,9 @@ var importCommand = new import_commander13.Command("import").description("Import
 });
 
 // src/cli/commands/indexer/index.ts
-init_cjs_shims();
 var import_commander20 = require("commander");
 
 // src/cli/commands/indexer/scrape.ts
-init_cjs_shims();
 var import_commander14 = require("commander");
 var import_child_process2 = require("child_process");
 var scrapeCommand = new import_commander14.Command("scrape").description("Scrape skills from GitHub sources").argument("[url]", "Repository or awesome-list URL").option("-d, --discover", "Discover from default sources").option("-f, --force", "Force scrape even if no changes detected").option("--standalone", "Use standalone skillindexer CLI (fallback)").option("--import", "Auto-import scraped skills into skill-tree", true).action(async (url, options, command) => {
@@ -9858,7 +10646,6 @@ async function runSkillIndexer(args, quiet) {
 }
 
 // src/cli/commands/indexer/classify.ts
-init_cjs_shims();
 var import_commander15 = require("commander");
 var import_child_process3 = require("child_process");
 var classifyCommand = new import_commander15.Command("classify").description("Classify unindexed skills using AI").option("-s, --skill <id>", "Classify specific skill by ID").option("--all", "Re-classify all skills (including already indexed)").option("--standalone", "Use standalone skillindexer CLI (fallback)").action(async (options, command) => {
@@ -9953,7 +10740,6 @@ async function runSkillIndexer2(args, quiet) {
 }
 
 // src/cli/commands/indexer/taxonomy.ts
-init_cjs_shims();
 var import_commander16 = require("commander");
 var import_child_process4 = require("child_process");
 var taxonomyCommand = new import_commander16.Command("taxonomy").description("Browse the taxonomy tree").argument("[path]", 'Subtree path (e.g., "Development/Python")').option("-i, --interactive", "Interactive browsing mode").option("--standalone", "Use standalone skillindexer CLI (fallback)").action(async (pathArg, options, command) => {
@@ -10034,7 +10820,6 @@ async function runSkillIndexer3(args, quiet) {
 }
 
 // src/cli/commands/indexer/relationships.ts
-init_cjs_shims();
 var import_commander17 = require("commander");
 var import_child_process5 = require("child_process");
 var relationshipsCommand = new import_commander17.Command("relationships").description("Detect relationships between indexed skills").option("-s, --skill <id>", "Detect relationships for specific skill").option("--use-ai", "Use AI for relationship reasoning (slower, more accurate)").option("--clear", "Clear existing relationships before detection").option("--standalone", "Use standalone skillindexer CLI (fallback)").action(async (options, command) => {
@@ -10121,7 +10906,6 @@ async function runSkillIndexer4(args, quiet) {
 }
 
 // src/cli/commands/indexer/stats.ts
-init_cjs_shims();
 var import_commander18 = require("commander");
 var import_child_process6 = require("child_process");
 var indexerStatsCommand = new import_commander18.Command("stats").description("Show indexer database statistics").option("--standalone", "Use standalone skillindexer CLI (fallback)").action(async (options, command) => {
@@ -10201,15 +10985,13 @@ async function runSkillIndexer5(args, quiet) {
 }
 
 // src/cli/commands/indexer/sync.ts
-init_cjs_shims();
 var import_commander19 = require("commander");
-var fs16 = __toESM(require("fs"));
-var path14 = __toESM(require("path"));
+var fs17 = __toESM(require("fs"));
+var path15 = __toESM(require("path"));
 var os3 = __toESM(require("os"));
 var import_child_process7 = require("child_process");
 
 // src/services/sync.ts
-init_cjs_shims();
 var SyncService = class {
   constructor(skillBank, config2 = {}) {
     this.syncStates = /* @__PURE__ */ new Map();
@@ -10666,11 +11448,11 @@ async function runLegacyImport(options, globalOpts) {
     if (!globalOpts.quiet) {
       printInfo("Exporting skills from indexer...");
     }
-    exportPath = path14.join(os3.tmpdir(), `skill-tree-sync-${Date.now()}.json`);
+    exportPath = path15.join(os3.tmpdir(), `skill-tree-sync-${Date.now()}.json`);
     const args = ["export-skilltree", "-o", exportPath, "-f", "json"];
     if (options.indexedOnly) args.push("--indexed-only");
     await runSkillIndexer6(args, true);
-    if (!fs16.existsSync(exportPath)) {
+    if (!fs17.existsSync(exportPath)) {
       printError("Failed to export skills from indexer");
       process.exit(1);
     }
@@ -10678,7 +11460,7 @@ async function runLegacyImport(options, globalOpts) {
   if (!globalOpts.quiet) {
     printInfo(`Reading export from ${exportPath}...`);
   }
-  const content = fs16.readFileSync(exportPath, "utf-8");
+  const content = fs17.readFileSync(exportPath, "utf-8");
   const { skills, stats } = parseIndexerExport(content);
   if (!globalOpts.quiet) {
     printInfo(`Found ${stats.total} skills (${stats.withStructuredContent} with structured content)`);
@@ -10698,7 +11480,7 @@ async function runLegacyImport(options, globalOpts) {
   const result = await skillBank.importSkills(skills);
   if (!options.exportPath && exportPath) {
     try {
-      fs16.unlinkSync(exportPath);
+      fs17.unlinkSync(exportPath);
     } catch {
     }
   }
@@ -10734,9 +11516,8 @@ async function runSkillIndexer6(args, quiet) {
 var indexerCommand = new import_commander20.Command("index").description("Skill indexer - discover and classify skills from GitHub").addCommand(scrapeCommand).addCommand(classifyCommand).addCommand(taxonomyCommand).addCommand(relationshipsCommand).addCommand(indexerStatsCommand).addCommand(syncCommand);
 
 // src/cli/commands/config.ts
-init_cjs_shims();
 var import_commander21 = require("commander");
-var fs17 = __toESM(require("fs"));
+var fs18 = __toESM(require("fs"));
 var configCommand = new import_commander21.Command("config").description("View and manage configuration");
 configCommand.command("show").description("Show current configuration").option("--path <path>", "Path to specific config value (e.g., storage.path)").action((options) => {
   const globalOpts = configCommand.parent?.opts() || {};
@@ -10769,7 +11550,7 @@ configCommand.command("show").description("Show current configuration").option("
 configCommand.command("init").description("Create default configuration file").option("-f, --force", "Overwrite existing config file").action((options) => {
   const globalOpts = configCommand.parent?.opts() || {};
   const configPath = expandPath(globalOpts.config || getConfigPath());
-  if (fs17.existsSync(configPath) && !options.force) {
+  if (fs18.existsSync(configPath) && !options.force) {
     console.error(`Config file already exists: ${configPath}`);
     console.error("Use --force to overwrite");
     process.exit(1);
@@ -10788,7 +11569,7 @@ configCommand.command("path").description("Show configuration file path").action
 configCommand.command("edit").description("Open configuration file in editor").action(() => {
   const globalOpts = configCommand.parent?.opts() || {};
   const configPath = expandPath(globalOpts.config || getConfigPath());
-  if (!fs17.existsSync(configPath)) {
+  if (!fs18.existsSync(configPath)) {
     const loader = new ConfigLoader(configPath);
     loader.createDefaultConfigFile();
   }
@@ -10819,7 +11600,7 @@ configCommand.command("defaults").description("Show default configuration values
 configCommand.command("validate").description("Validate configuration file").action(() => {
   const globalOpts = configCommand.parent?.opts() || {};
   const configPath = expandPath(globalOpts.config || getConfigPath());
-  if (!fs17.existsSync(configPath)) {
+  if (!fs18.existsSync(configPath)) {
     console.error(`Config file not found: ${configPath}`);
     process.exit(1);
   }
@@ -10885,17 +11666,16 @@ function printConfig(obj, indent) {
 }
 
 // src/cli/commands/sync.ts
-init_cjs_shims();
 var import_commander22 = require("commander");
-var path15 = __toESM(require("path"));
-var fs18 = __toESM(require("fs"));
+var path16 = __toESM(require("path"));
+var fs19 = __toESM(require("fs"));
 function getSyncConfigPath(basePath) {
-  return path15.join(basePath, ".skillbank", "sync-config.json");
+  return path16.join(basePath, ".skillbank", "sync-config.json");
 }
 async function loadSyncConfig(basePath) {
   const configPath = getSyncConfigPath(basePath);
   try {
-    const content = await fs18.promises.readFile(configPath, "utf-8");
+    const content = await fs19.promises.readFile(configPath, "utf-8");
     return JSON.parse(content);
   } catch {
     return null;
@@ -10903,8 +11683,8 @@ async function loadSyncConfig(basePath) {
 }
 async function saveSyncConfig(basePath, config2) {
   const configPath = getSyncConfigPath(basePath);
-  await fs18.promises.mkdir(path15.dirname(configPath), { recursive: true });
-  await fs18.promises.writeFile(configPath, JSON.stringify(config2, null, 2), "utf-8");
+  await fs19.promises.mkdir(path16.dirname(configPath), { recursive: true });
+  await fs19.promises.writeFile(configPath, JSON.stringify(config2, null, 2), "utf-8");
 }
 async function createSyncAdapter(basePath, globalOpts) {
   const config2 = await loadSyncConfig(basePath);
@@ -10934,8 +11714,8 @@ function initCommand() {
         agentName: options.name,
         environment: options.env
       });
-      const gitDir = path15.join(basePath, ".git");
-      if (!fs18.existsSync(gitDir)) {
+      const gitDir = path16.join(basePath, ".git");
+      if (!fs19.existsSync(gitDir)) {
         printError(`Not a git repository: ${basePath}`);
         printInfo("Initialize a git repository first with: git init");
         process.exit(1);
@@ -11210,9 +11990,8 @@ function resolveCommand() {
 }
 
 // src/cli/commands/read.ts
-init_cjs_shims();
 var import_commander23 = require("commander");
-var path16 = __toESM(require("path"));
+var path17 = __toESM(require("path"));
 function serializeSkillMd(skill) {
   const lines = [];
   lines.push("---");
@@ -11258,7 +12037,7 @@ var readCommand = new import_commander23.Command("read").description("Read skill
       } else {
         console.log(`Reading: ${skill.name}`);
       }
-      const skillDir = path16.join(basePath, ".skilltree", "skills", skill.id);
+      const skillDir = path17.join(basePath, ".skilltree", "skills", skill.id);
       console.log(`Base directory: ${skillDir}`);
       console.log("");
       console.log(serializeSkillMd(skill));
@@ -11275,7 +12054,6 @@ var readCommand = new import_commander23.Command("read").description("Read skill
 });
 
 // src/cli/commands/materialize.ts
-init_cjs_shims();
 var import_commander24 = require("commander");
 var materializeCommand = new import_commander24.Command("materialize").description("Materialize skills to agent-discoverable paths").option("--paths <dirs>", "Comma-separated target directories (e.g. .claude/skills,.agent/skills)").option("--agents-md <path>", "Path to write AGENTS.md").option("--format <format>", "AGENTS.md format: xml, markdown, json", "xml").option("--mode <mode>", "Materialization mode: symlink or copy", "symlink").option("-w, --watch", "Watch for changes and re-materialize").action(async (options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -11336,25 +12114,19 @@ var materializeCommand = new import_commander24.Command("materialize").descripti
 });
 
 // src/cli/commands/loadout/index.ts
-init_cjs_shims();
 var import_commander37 = require("commander");
 
 // src/cli/commands/loadout/list.ts
-init_cjs_shims();
 var import_commander25 = require("commander");
 
-// src/cli/utils/loadout-server.ts
-init_cjs_shims();
-
 // src/serving/state-persistence.ts
-init_cjs_shims();
-var fs19 = __toESM(require("fs"));
-var path17 = __toESM(require("path"));
+var fs20 = __toESM(require("fs"));
+var path18 = __toESM(require("path"));
 var STATE_FILENAME = ".loadout-state.json";
 function loadState(skillPath) {
-  const filePath = path17.join(skillPath, STATE_FILENAME);
+  const filePath = path18.join(skillPath, STATE_FILENAME);
   try {
-    const raw = fs19.readFileSync(filePath, "utf-8");
+    const raw = fs20.readFileSync(filePath, "utf-8");
     const data = JSON.parse(raw);
     return {
       available: new Map(data.available),
@@ -11368,7 +12140,7 @@ function loadState(skillPath) {
   }
 }
 function saveState(skillPath, state) {
-  const filePath = path17.join(skillPath, STATE_FILENAME);
+  const filePath = path18.join(skillPath, STATE_FILENAME);
   const data = {
     available: Array.from(state.available.entries()),
     expanded: Array.from(state.expanded),
@@ -11376,12 +12148,12 @@ function saveState(skillPath, state) {
     source: state.source,
     updatedAt: state.updatedAt.toISOString()
   };
-  fs19.writeFileSync(filePath, JSON.stringify(data, null, 2));
+  fs20.writeFileSync(filePath, JSON.stringify(data, null, 2));
 }
 function clearState(skillPath) {
-  const filePath = path17.join(skillPath, STATE_FILENAME);
+  const filePath = path18.join(skillPath, STATE_FILENAME);
   try {
-    fs19.unlinkSync(filePath);
+    fs20.unlinkSync(filePath);
     return true;
   } catch {
     return false;
@@ -11455,7 +12227,6 @@ var listSubcommand = new import_commander25.Command("list").description("List sk
 });
 
 // src/cli/commands/loadout/search.ts
-init_cjs_shims();
 var import_commander26 = require("commander");
 var searchSubcommand = new import_commander26.Command("search").description("Search for skills to add to the loadout").argument("<query>", "Search query").option("-l, --limit <n>", "Maximum results", "10").action(async (query, options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -11487,7 +12258,6 @@ var searchSubcommand = new import_commander26.Command("search").description("Sea
 });
 
 // src/cli/commands/loadout/add.ts
-init_cjs_shims();
 var import_commander27 = require("commander");
 var addSubcommand = new import_commander27.Command("add").description("Add skills to the loadout").argument("<ids...>", "Skill IDs to add").action(async (ids, _options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -11507,7 +12277,6 @@ var addSubcommand = new import_commander27.Command("add").description("Add skill
 });
 
 // src/cli/commands/loadout/remove.ts
-init_cjs_shims();
 var import_commander28 = require("commander");
 var removeSubcommand = new import_commander28.Command("remove").description("Remove skills from the loadout").argument("<ids...>", "Skill IDs to remove").action(async (ids, _options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -11527,7 +12296,6 @@ var removeSubcommand = new import_commander28.Command("remove").description("Rem
 });
 
 // src/cli/commands/loadout/profile.ts
-init_cjs_shims();
 var import_commander29 = require("commander");
 var profileSubcommand = new import_commander29.Command("profile").description("Switch to a named skill profile").argument("[name]", "Profile name (e.g. debugging, security, code-review)").option("--list", "List available profiles").action(async (name, options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -11560,7 +12328,6 @@ var profileSubcommand = new import_commander29.Command("profile").description("S
 });
 
 // src/cli/commands/loadout/set.ts
-init_cjs_shims();
 var import_commander30 = require("commander");
 var setSubcommand = new import_commander30.Command("set").description("Set loadout from criteria (tags, task description, etc.)").option("--tags <tags>", "Comma-separated tags to match").option("--task <description>", "Task description for semantic matching").option("--max-skills <n>", "Maximum number of skills").action(async (options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -11591,7 +12358,6 @@ var setSubcommand = new import_commander30.Command("set").description("Set loado
 });
 
 // src/cli/commands/loadout/expand.ts
-init_cjs_shims();
 var import_commander31 = require("commander");
 var expandSubcommand = new import_commander31.Command("expand").description("Expand a skill to see its full content").argument("<id>", "Skill ID to expand").action(async (id, _options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -11618,7 +12384,6 @@ var expandSubcommand = new import_commander31.Command("expand").description("Exp
 });
 
 // src/cli/commands/loadout/collapse.ts
-init_cjs_shims();
 var import_commander32 = require("commander");
 var collapseSubcommand = new import_commander32.Command("collapse").description("Collapse an expanded skill back to summary").argument("<id>", "Skill ID to collapse").action(async (id, _options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -11642,7 +12407,6 @@ var collapseSubcommand = new import_commander32.Command("collapse").description(
 });
 
 // src/cli/commands/loadout/get.ts
-init_cjs_shims();
 var import_commander33 = require("commander");
 var getSubcommand = new import_commander33.Command("get").description("Get details about a skill in the loadout").argument("<id>", "Skill ID").action(async (id, _options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -11666,7 +12430,6 @@ var getSubcommand = new import_commander33.Command("get").description("Get detai
 });
 
 // src/cli/commands/loadout/render.ts
-init_cjs_shims();
 var import_commander34 = require("commander");
 var renderSubcommand = new import_commander34.Command("render").description("Render the current loadout as a system prompt (XML or Markdown)").option("--format <format>", "Output format: xml or markdown", "xml").action(async (options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -11686,7 +12449,6 @@ var renderSubcommand = new import_commander34.Command("render").description("Ren
 });
 
 // src/cli/commands/loadout/clear.ts
-init_cjs_shims();
 var import_commander35 = require("commander");
 var clearSubcommand = new import_commander35.Command("clear").description("Clear the current loadout state").action(async (_options, command) => {
   const globalOpts = command.optsWithGlobals();
@@ -11709,16 +12471,15 @@ var clearSubcommand = new import_commander35.Command("clear").description("Clear
 });
 
 // src/cli/commands/loadout/browse.ts
-init_cjs_shims();
 var import_commander36 = require("commander");
 var browseSubcommand = new import_commander36.Command("browse").description("Browse the skill catalog by category").argument("[path]", "Category path to browse (e.g., Development/Python)").action(async (pathArg, _options, command) => {
   const globalOpts = command.optsWithGlobals();
   try {
     const { server } = await createLoadoutServer(globalOpts);
-    const path18 = pathArg ? pathArg.split("/").filter(Boolean) : void 0;
-    const output = await server.agentBrowseCatalog(path18);
+    const path19 = pathArg ? pathArg.split("/").filter(Boolean) : void 0;
+    const output = await server.agentBrowseCatalog(path19);
     if (globalOpts.json) {
-      console.log(JSON.stringify({ path: path18 ?? [], output }, null, 2));
+      console.log(JSON.stringify({ path: path19 ?? [], output }, null, 2));
       return;
     }
     if (!output) {
@@ -11735,8 +12496,95 @@ var browseSubcommand = new import_commander36.Command("browse").description("Bro
 // src/cli/commands/loadout/index.ts
 var loadoutCommand = new import_commander37.Command("loadout").description("Manage skill loadouts for agent sessions").addCommand(listSubcommand).addCommand(searchSubcommand).addCommand(addSubcommand).addCommand(removeSubcommand).addCommand(profileSubcommand).addCommand(setSubcommand).addCommand(expandSubcommand).addCommand(collapseSubcommand).addCommand(getSubcommand).addCommand(renderSubcommand).addCommand(clearSubcommand).addCommand(browseSubcommand);
 
+// src/cli/commands/skillnet.ts
+var import_commander38 = require("commander");
+function buildClient() {
+  return createSkillNetClient({
+    apiBaseUrl: process.env.SKILLNET_API_URL,
+    githubToken: process.env.GITHUB_TOKEN,
+    githubMirror: process.env.GITHUB_MIRROR
+  });
+}
+var searchSubcommand2 = new import_commander38.Command("search").description("Search the SkillNet index (free, no API key)").argument("<query>", "Search query (keywords or natural language)").option("-m, --mode <mode>", "Search mode: keyword or vector", "keyword").option("-c, --category <category>", "Category filter (Development, Research, ...)").option("-l, --limit <n>", "Results per page (max 50)", (v) => parseInt(v, 10)).option("--min-stars <n>", "Minimum star count (keyword mode)", (v) => parseInt(v, 10)).option("--sort-by <field>", "Sort by stars or recent (keyword mode)").option("--threshold <n>", "Similarity threshold 0-1 (vector mode)", (v) => parseFloat(v)).action(async (query, options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  try {
+    const client = buildClient();
+    const searchOpts = {
+      mode: options.mode,
+      category: options.category,
+      limit: options.limit,
+      minStars: options.minStars,
+      sortBy: options.sortBy,
+      threshold: options.threshold
+    };
+    const results = await client.search(query, searchOpts);
+    if (globalOpts.json) {
+      console.log(JSON.stringify(results, null, 2));
+      return;
+    }
+    if (results.length === 0) {
+      printInfo("No skills found.");
+      return;
+    }
+    printInfo(`Found ${results.length} skill(s):
+`);
+    for (const r of results) {
+      console.log(`  ${r.skillName} \u2B50${r.stars}${r.category ? ` [${r.category}]` : ""}`);
+      if (r.skillDescription) console.log(`    ${r.skillDescription}`);
+      console.log(`    ${r.skillUrl}`);
+    }
+  } catch (err) {
+    printError(err.message);
+    process.exit(1);
+  }
+});
+var importSubcommand = new import_commander38.Command("import").description("Import skills from SkillNet into the local skill bank").argument("[query]", "Search query to import matching skills").option("-u, --url <url>", "Import a single skill by its GitHub/SkillNet URL").option("-m, --mode <mode>", "Search mode: keyword or vector", "keyword").option("-c, --category <category>", "Category filter").option("-l, --limit <n>", "Max skills to import", (v) => parseInt(v, 10), 5).option("--min-stars <n>", "Minimum star count", (v) => parseInt(v, 10)).option("--threshold <n>", "Similarity threshold 0-1 (vector mode)", (v) => parseFloat(v)).action(async (query, options, command) => {
+  const globalOpts = command.optsWithGlobals();
+  if (!query && !options.url) {
+    printError("Provide a search query or --url to import a single skill");
+    process.exit(1);
+  }
+  try {
+    const client = buildClient();
+    const bank = await createSkillBankFromOptions(globalOpts);
+    if (options.url) {
+      const converted = await client.importSkill(options.url, bank);
+      if (globalOpts.json) {
+        console.log(JSON.stringify({ imported: 1, skill: converted.skill.id }, null, 2));
+      } else {
+        printSuccess(`Imported "${converted.skill.id}"`);
+        for (const w of converted.warnings) printWarning(w);
+      }
+      return;
+    }
+    if (!globalOpts.quiet) {
+      printInfo(`Searching SkillNet for "${query}"...`);
+    }
+    const result = await client.importFromSearch(query, bank, {
+      mode: options.mode,
+      category: options.category,
+      limit: options.limit,
+      minStars: options.minStars,
+      threshold: options.threshold
+    });
+    if (globalOpts.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    printSuccess(`Imported ${result.imported} skill(s)`);
+    if (result.failed > 0) {
+      printWarning(`Failed to import ${result.failed} skill(s)`);
+      for (const e of result.errors) printInfo(`  - ${e}`);
+    }
+  } catch (err) {
+    printError(err.message);
+    process.exit(1);
+  }
+});
+var skillnetCommand = new import_commander38.Command("skillnet").description("Search and import skills from the SkillNet ecosystem").addCommand(searchSubcommand2).addCommand(importSubcommand);
+
 // src/cli/index.ts
-var program = new import_commander38.Command();
+var program = new import_commander39.Command();
 var config = loadConfig();
 program.name("skill-tree").description("Management CLI for agent skills").version(VERSION).option("-p, --path <dir>", "Skills directory path", config.storage.path).option("-c, --config <file>", "Config file path", getConfigPath()).option("--json", "Output as JSON", config.cli.output_format === "json").option("-q, --quiet", "Suppress non-essential output", config.cli.quiet).option("--no-color", "Disable colored output", !config.cli.color);
 program.addCommand(listCommand);
@@ -11758,4 +12606,5 @@ program.addCommand(syncCommand2);
 program.addCommand(readCommand);
 program.addCommand(materializeCommand);
 program.addCommand(loadoutCommand);
+program.addCommand(skillnetCommand);
 program.parse();