skild 0.10.3 → 0.10.5

package/dist/index.js

@@ -580,6 +580,17 @@ function discoverSkillDirsWithHeuristics(rootDir, options) {
     path.join(".windsurf", "skills"),
     path.join(".github", "skills")
   ];
+  const results = [];
+  const seen = /* @__PURE__ */ new Set();
+  const addResults = (entries, prefix) => {
+    for (const entry of entries) {
+      const absKey = path.resolve(entry.absDir);
+      if (seen.has(absKey)) continue;
+      seen.add(absKey);
+      const relPath = prefix ? normalizeRelPath(path.join(prefix, entry.relPath)) : normalizeRelPath(entry.relPath);
+      results.push({ relPath, absDir: entry.absDir });
+    }
+  };
   for (const rel of candidates) {
     const candidateDir = path.join(root, rel);
     if (!fs.existsSync(candidateDir)) continue;
@@ -588,13 +599,12 @@ function discoverSkillDirsWithHeuristics(rootDir, options) {
     } catch {
       continue;
     }
-    const found = discoverSkillDirs(candidateDir, options).map((s) => ({
-      relPath: normalizeRelPath(path.join(rel, s.relPath)),
-      absDir: s.absDir
-    }));
-    if (found.length) return found;
+    const found = discoverSkillDirs(candidateDir, options);
+    addResults(found, rel);
   }
-  return discoverSkillDirs(root, options);
+  const fullScan = discoverSkillDirs(root, options);
+  addResults(fullScan);
+  return results;
 }
 
 // src/commands/markdown-discovery.ts
@@ -1296,8 +1306,8 @@ async function discoverSkills(ctx) {
     const maybeLocalRoot = path3.resolve(resolvedSource);
     const isLocal = fs3.existsSync(maybeLocalRoot);
     if (isLocal) {
-      const hasSkillMd2 = fs3.existsSync(path3.join(maybeLocalRoot, "SKILL.md"));
-      if (hasSkillMd2) {
+      const hasSkillMd = fs3.existsSync(path3.join(maybeLocalRoot, "SKILL.md"));
+      if (hasSkillMd) {
         const metadata = readSkillMetadata(maybeLocalRoot);
         ctx.isSingleSkill = true;
         ctx.selectedSkills = [{
@@ -1308,26 +1318,57 @@ async function discoverSkills(ctx) {
         }];
         return true;
       }
-      const discovered2 = discoverSkillDirsWithHeuristics(maybeLocalRoot, { maxDepth: scanDepth, maxSkills });
-      if (discovered2.length === 0) {
-        const message = `No SKILL.md found at ${maybeLocalRoot} (or within subdirectories).`;
+      const discovered = discoverSkillDirsWithHeuristics(maybeLocalRoot, { maxDepth: scanDepth, maxSkills });
+      if (discovered.length === 0) {
+        const message2 = `No SKILL.md found at ${maybeLocalRoot} (or within subdirectories).`;
         if (jsonOnly) {
-          printJson({ ok: false, error: "SKILL_MD_NOT_FOUND", message, source: ctx.source, resolvedSource });
+          printJson({ ok: false, error: "SKILL_MD_NOT_FOUND", message: message2, source: ctx.source, resolvedSource });
         } else {
           if (ctx.spinner) ctx.spinner.stop();
-          console.error(chalk3.red(message));
+          console.error(chalk3.red(message2));
         }
         process.exitCode = 1;
         return false;
       }
       ctx.discoveredSkills = asDiscoveredSkills(
-        discovered2,
+        discovered,
         (d) => path3.join(maybeLocalRoot, d.relPath),
         void 0,
         (d) => d.absDir
       );
       return true;
     }
+    let materializeError = null;
+    try {
+      const materialized = await materializeSourceToTemp2(resolvedSource);
+      ctx.materializedDir = materialized.dir;
+      ctx.cleanupMaterialized = appendCleanup(ctx.cleanupMaterialized, materialized.cleanup);
+      const hasSkillMd = fs3.existsSync(path3.join(ctx.materializedDir, "SKILL.md"));
+      if (hasSkillMd) {
+        const metadata = readSkillMetadata(ctx.materializedDir);
+        ctx.isSingleSkill = true;
+        ctx.selectedSkills = [{
+          relPath: ".",
+          suggestedSource: resolvedSource,
+          materializedDir: ctx.materializedDir,
+          displayName: metadata?.name,
+          description: metadata?.description
+        }];
+        return true;
+      }
+      const discovered = discoverSkillDirsWithHeuristics(ctx.materializedDir, { maxDepth: scanDepth, maxSkills });
+      if (discovered.length > 0) {
+        ctx.discoveredSkills = asDiscoveredSkills(
+          discovered,
+          (d) => deriveChildSource2(resolvedSource, d.relPath),
+          (d) => d.absDir,
+          (d) => d.absDir
+        );
+        return true;
+      }
+    } catch (error) {
+      materializeError = error;
+    }
     const markdownResult = await discoverMarkdownSkillsFromSource({
       source: resolvedSource,
       maxDocDepth: markdownDepth,
@@ -1349,41 +1390,15 @@ async function discoverSkills(ctx) {
       ctx.cleanupMaterialized = appendCleanup(ctx.cleanupMaterialized, markdownResult.cleanup);
       return true;
     }
-    const materialized = await materializeSourceToTemp2(resolvedSource);
-    ctx.materializedDir = materialized.dir;
-    ctx.cleanupMaterialized = appendCleanup(ctx.cleanupMaterialized, materialized.cleanup);
-    const hasSkillMd = fs3.existsSync(path3.join(ctx.materializedDir, "SKILL.md"));
-    if (hasSkillMd) {
-      const metadata = readSkillMetadata(ctx.materializedDir);
-      ctx.isSingleSkill = true;
-      ctx.selectedSkills = [{
-        relPath: ".",
-        suggestedSource: resolvedSource,
-        materializedDir: ctx.materializedDir,
-        displayName: metadata?.name,
-        description: metadata?.description
-      }];
-      return true;
-    }
-    const discovered = discoverSkillDirsWithHeuristics(ctx.materializedDir, { maxDepth: scanDepth, maxSkills });
-    if (discovered.length === 0) {
-      const message = `No SKILL.md found in source "${resolvedSource}".`;
-      if (jsonOnly) {
-        printJson({ ok: false, error: "SKILL_MD_NOT_FOUND", message, source: ctx.source, resolvedSource });
-      } else {
-        if (ctx.spinner) ctx.spinner.stop();
-        console.error(chalk3.red(message));
-      }
-      process.exitCode = 1;
-      return false;
+    const message = `No SKILL.md found in source "${resolvedSource}".` + (materializeError ? " (materialize failed, markdown fallback empty)" : "");
+    if (jsonOnly) {
+      printJson({ ok: false, error: "SKILL_MD_NOT_FOUND", message, source: ctx.source, resolvedSource });
+    } else {
+      if (ctx.spinner) ctx.spinner.stop();
+      console.error(chalk3.red(message));
     }
-    ctx.discoveredSkills = asDiscoveredSkills(
-      discovered,
-      (d) => deriveChildSource2(resolvedSource, d.relPath),
-      (d) => d.absDir,
-      (d) => d.absDir
-    );
-    return true;
+    process.exitCode = 1;
+    return false;
   } catch (error) {
     const message = error instanceof SkildError ? error.message : error instanceof Error ? error.message : String(error);
     if (jsonOnly) printJson({ ok: false, error: message });
@@ -1663,6 +1678,8 @@ async function install(source, options = {}) {
   }
 }
 async function reportDownload(record, registryOverride) {
+  const enableStats = process.env.SKILD_ENABLE_STATS === "1" || process.env.SKILD_ENABLE_DOWNLOAD_STATS === "1" || process.env.SKILD_ENABLE_TELEMETRY === "1";
+  if (!enableStats) return;
   try {
     if (record.sourceType === "local") return;
     const registryUrl = resolveRegistryUrl(record.registryUrl || registryOverride);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skild",
-  "version": "0.10.3",
+  "version": "0.10.5",
   "description": "The npm for Agent Skills — Discover, install, manage, and publish AI Agent Skills with ease.",
   "type": "module",
   "main": "./dist/index.js",