skild 0.3.1 → 0.4.0

package/dist/index.js

@@ -6,10 +6,10 @@ import chalk15 from "chalk";
 import { createRequire } from "module";
 
 // src/commands/install.ts
-import fs from "fs";
-import path from "path";
+import fs2 from "fs";
+import path2 from "path";
 import chalk2 from "chalk";
-import { fetchWithTimeout, installRegistrySkill, installSkill, isValidAlias, loadRegistryAuth, resolveRegistryAlias, resolveRegistryUrl, SkildError, PLATFORMS } from "@skild/core";
+import { fetchWithTimeout, installRegistrySkill, installSkill, isValidAlias, loadRegistryAuth, materializeSourceToTemp, resolveRegistryAlias, resolveRegistryUrl, SkildError, PLATFORMS } from "@skild/core";
 
 // src/utils/logger.ts
 import chalk from "chalk";
@@ -57,10 +57,10 @@ var logger = {
   /**
    * Log a skill entry with status indicator.
    */
-  skillEntry: (name, path3, hasSkillMd) => {
+  skillEntry: (name, path4, hasSkillMd) => {
     const status = hasSkillMd ? chalk.green("\u2713") : chalk.yellow("\u26A0");
     console.log(`  ${status} ${chalk.cyan(name)}`);
-    console.log(chalk.dim(`    \u2514\u2500 ${path3}`));
+    console.log(chalk.dim(`    \u2514\u2500 ${path4}`));
   },
   /**
    * Log installation result details.
@@ -71,6 +71,159 @@ var logger = {
   }
 };
 
+// src/utils/prompt.ts
+import readline from "readline";
+async function promptLine(question, defaultValue) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
+  try {
+    const suffix = defaultValue ? ` (${defaultValue})` : "";
+    const answer = await new Promise((resolve) => rl.question(`${question}${suffix}: `, resolve));
+    const trimmed = answer.trim();
+    return trimmed || defaultValue || "";
+  } finally {
+    rl.close();
+  }
+}
+async function promptPassword(question) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return promptLine(question);
+  }
+  const stdin = process.stdin;
+  const stdout = process.stdout;
+  stdout.write(`${question}: `);
+  const wasRaw = Boolean(stdin.isRaw);
+  stdin.setRawMode(true);
+  stdin.resume();
+  readline.emitKeypressEvents(stdin);
+  const buf = [];
+  return await new Promise((resolve, reject) => {
+    function cleanup() {
+      stdin.off("keypress", onKeypress);
+      stdin.setRawMode(wasRaw);
+      stdin.pause();
+    }
+    function onKeypress(str, key) {
+      if (key?.ctrl && key?.name === "c") {
+        stdout.write("\n");
+        cleanup();
+        const err = new Error("Prompt cancelled");
+        err.code = "PROMPT_CANCELLED";
+        reject(err);
+        return;
+      }
+      if (key?.name === "return" || key?.name === "enter") {
+        stdout.write("\n");
+        cleanup();
+        resolve(buf.join(""));
+        return;
+      }
+      if (key?.name === "backspace" || key?.name === "delete") {
+        if (buf.length) buf.pop();
+        return;
+      }
+      if (!str) return;
+      if (key?.ctrl || key?.meta) return;
+      buf.push(str);
+    }
+    stdin.on("keypress", onKeypress);
+  });
+}
+async function promptConfirm(question, options = {}) {
+  const defaultValue = options.defaultValue ?? false;
+  const suffix = defaultValue ? " (Y/n)" : " (y/N)";
+  const answer = await promptLine(`${question}${suffix}`);
+  const v = answer.trim().toLowerCase();
+  if (!v) return defaultValue;
+  if (v === "y" || v === "yes") return true;
+  if (v === "n" || v === "no") return false;
+  return defaultValue;
+}
+
+// src/commands/install-discovery.ts
+import fs from "fs";
+import path from "path";
+function parsePositiveInt(input, fallback) {
+  if (input == null) return fallback;
+  const n = typeof input === "number" ? input : Number(String(input).trim());
+  if (!Number.isFinite(n) || n <= 0) return fallback;
+  return Math.floor(n);
+}
+function normalizeRelPath(relPath) {
+  return relPath.split(path.sep).join("/").replace(/^\/+/, "").replace(/\/+$/, "");
+}
+function shouldSkipDir(name) {
+  if (!name) return true;
+  if (name === ".git") return true;
+  if (name === ".skild") return true;
+  if (name === "node_modules") return true;
+  if (name === "dist") return true;
+  if (name === "build") return true;
+  if (name === ".wrangler") return true;
+  return false;
+}
+function discoverSkillDirs(rootDir, options) {
+  const root = path.resolve(rootDir);
+  const found = [];
+  const stack = [{ dir: root, depth: 0 }];
+  while (stack.length) {
+    const next = stack.pop();
+    const dir = next.dir;
+    const depth = next.depth;
+    const skillMd = path.join(dir, "SKILL.md");
+    if (fs.existsSync(skillMd)) {
+      const relPath = path.relative(root, dir) || ".";
+      found.push({ relPath: normalizeRelPath(relPath), absDir: dir });
+      if (found.length >= options.maxSkills + 1) return found;
+      continue;
+    }
+    if (depth >= options.maxDepth) continue;
+    let entries;
+    try {
+      entries = fs.readdirSync(dir, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (shouldSkipDir(entry.name)) continue;
+      const child = path.join(dir, entry.name);
+      stack.push({ dir: child, depth: depth + 1 });
+    }
+  }
+  return found;
+}
+function discoverSkillDirsWithHeuristics(rootDir, options) {
+  const root = path.resolve(rootDir);
+  const candidates = [
+    "skills",
+    path.join(".agent", "skills"),
+    path.join(".claude", "skills"),
+    path.join(".codex", "skills"),
+    path.join(".github", "skills")
+  ];
+  for (const rel of candidates) {
+    const candidateDir = path.join(root, rel);
+    if (!fs.existsSync(candidateDir)) continue;
+    try {
+      if (!fs.statSync(candidateDir).isDirectory()) continue;
+    } catch {
+      continue;
+    }
+    const found = discoverSkillDirs(candidateDir, options).map((s) => ({
+      relPath: normalizeRelPath(path.join(rel, s.relPath)),
+      absDir: s.absDir
+    }));
+    if (found.length) return found;
+  }
+  return discoverSkillDirs(root, options);
+}
+function deriveRemoteChildSource(baseSource, relPath) {
+  const [pathPart, ref] = baseSource.split("#", 2);
+  const clean = normalizeRelPath(relPath);
+  const joined = clean ? `${pathPart.replace(/\/+$/, "")}/${clean}` : pathPart;
+  return ref ? `${joined}#${ref}` : joined;
+}
+
 // src/commands/install.ts
 function looksLikeAlias(input) {
   const s = input.trim();
@@ -78,20 +231,39 @@ function looksLikeAlias(input) {
   if (s.startsWith("@")) return false;
   if (s.includes("/") || s.includes("\\")) return false;
   if (/^https?:\/\//i.test(s) || s.includes("github.com")) return false;
-  if (fs.existsSync(path.resolve(s))) return false;
+  if (fs2.existsSync(path2.resolve(s))) return false;
   if (!isValidAlias(s)) return false;
   return true;
 }
+function printJson(value) {
+  process.stdout.write(`${JSON.stringify(value, null, 2)}
+`);
+}
+function previewDiscovered(found, limit = 12) {
+  const preview = found.slice(0, limit).map((s) => `  - ${s.relPath}`).join("\n");
+  return `${preview}${found.length > limit ? "\n  ..." : ""}`;
+}
+function asDiscoveredSkills(discovered, toSuggestedSource, toMaterializedDir) {
+  return discovered.map((d) => ({
+    relPath: d.relPath,
+    suggestedSource: toSuggestedSource(d),
+    materializedDir: toMaterializedDir ? toMaterializedDir(d) : void 0
+  }));
+}
 async function install(source, options = {}) {
   const scope = options.local ? "project" : "global";
   const auth = loadRegistryAuth();
   const registryUrlForDeps = options.registry || auth?.registryUrl;
   const all = Boolean(options.all);
   const jsonOnly = Boolean(options.json);
+  const recursive = Boolean(options.recursive);
+  const yes = Boolean(options.yes);
+  const maxDepth = parsePositiveInt(options.depth, 6);
+  const maxSkills = parsePositiveInt(options.maxSkills, 200);
   const platform = options.target || "claude";
   if (all && options.target) {
     const message = "Invalid options: use either --all or --target, not both.";
-    if (jsonOnly) console.log(JSON.stringify({ ok: false, error: message }, null, 2));
+    if (jsonOnly) printJson({ ok: false, error: message });
     else console.error(chalk2.red(message));
     process.exitCode = 1;
     return;
@@ -106,7 +278,7 @@ async function install(source, options = {}) {
     }
   } catch (error) {
     const message = error instanceof SkildError ? error.message : error instanceof Error ? error.message : String(error);
-    if (jsonOnly) console.log(JSON.stringify({ ok: false, error: message }, null, 2));
+    if (jsonOnly) printJson({ ok: false, error: message });
     else console.error(chalk2.red(message));
     process.exitCode = 1;
     return;
@@ -114,33 +286,148 @@ async function install(source, options = {}) {
   const targets = all ? [...PLATFORMS] : [platform];
   const results = [];
   const errors = [];
-  try {
-    const spinner = jsonOnly ? null : createSpinner(
-      all ? `Installing ${chalk2.cyan(source)} to ${chalk2.dim("all platforms")} (${scope})...` : `Installing ${chalk2.cyan(source)} to ${chalk2.dim(platform)} (${scope})...`
-    );
+  let effectiveRecursive = recursive;
+  let recursiveSkillCount = null;
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY) && !jsonOnly;
+  async function installOne(inputSource, materializedDir) {
     for (const targetPlatform of targets) {
-      if (spinner) spinner.text = `Installing ${chalk2.cyan(source)} to ${chalk2.dim(targetPlatform)} (${scope})...`;
       try {
-        const record = resolvedSource.startsWith("@") && resolvedSource.includes("/") ? await installRegistrySkill(
-          { spec: resolvedSource, registryUrl: registryUrlForDeps },
+        const record = inputSource.startsWith("@") && inputSource.includes("/") ? await installRegistrySkill(
+          { spec: inputSource, registryUrl: registryUrlForDeps },
           { platform: targetPlatform, scope, force: Boolean(options.force) }
         ) : await installSkill(
-          { source: resolvedSource },
+          { source: inputSource, materializedDir },
           { platform: targetPlatform, scope, force: Boolean(options.force), registryUrl: registryUrlForDeps }
         );
         results.push(record);
         void reportDownload(record, registryUrlForDeps);
       } catch (error) {
         const message = error instanceof SkildError ? error.message : error instanceof Error ? error.message : String(error);
-        errors.push({ platform: targetPlatform, error: message });
+        errors.push({ platform: targetPlatform, error: message, inputSource });
+      }
+    }
+  }
+  async function maybeEnableRecursiveAndInstall(found) {
+    if (found.length === 0) return false;
+    if (found.length > maxSkills) {
+      const message = `Found more than ${maxSkills} skills. Increase --max-skills to proceed.`;
+      if (jsonOnly) printJson({ ok: false, error: "TOO_MANY_SKILLS", message, source, resolvedSource, maxSkills });
+      else console.error(chalk2.red(message));
+      process.exitCode = 1;
+      return true;
+    }
+    if (!effectiveRecursive) {
+      if (jsonOnly) {
+        const foundOutput = found.map(({ relPath, suggestedSource }) => ({ relPath, suggestedSource }));
+        printJson({
+          ok: false,
+          error: "MULTI_SKILL_SOURCE",
+          message: "Source is not a skill root (missing SKILL.md). Multiple skills were found.",
+          source,
+          resolvedSource,
+          found: foundOutput
+        });
+        process.exitCode = 1;
+        return true;
+      }
+      const headline = found.length === 1 ? `No SKILL.md found at root. Found 1 skill:
+${previewDiscovered(found)}
+` : `No SKILL.md found at root. Found ${found.length} skills:
+${previewDiscovered(found)}
+`;
+      console.log(chalk2.yellow(headline));
+      const question = found.length === 1 ? "Install the discovered skill?" : "Install all discovered skills?";
+      const confirm = yes || interactive && await promptConfirm(question, { defaultValue: found.length === 1 });
+      if (!confirm) {
+        console.log(chalk2.dim(`Tip: rerun with ${chalk2.cyan("skild install <source> --recursive")} to install all.`));
+        process.exitCode = 1;
+        return true;
       }
+      effectiveRecursive = true;
+    }
+    recursiveSkillCount = found.length;
+    return false;
+  }
+  try {
+    const spinner = jsonOnly ? null : createSpinner(
+      all ? `Installing ${chalk2.cyan(source)} to ${chalk2.dim("all platforms")} (${scope})...` : `Installing ${chalk2.cyan(source)} to ${chalk2.dim(platform)} (${scope})...`
+    );
+    let cleanupMaterialized = null;
+    let materializedRoot = null;
+    try {
+      if (resolvedSource.startsWith("@") && resolvedSource.includes("/")) {
+        await installOne(resolvedSource);
+      } else {
+        const maybeLocalRoot = path2.resolve(resolvedSource);
+        const isLocal = fs2.existsSync(maybeLocalRoot);
+        if (isLocal) {
+          const hasSkillMd = fs2.existsSync(path2.join(maybeLocalRoot, "SKILL.md"));
+          if (hasSkillMd) {
+            await installOne(resolvedSource);
+          } else {
+            const discovered = discoverSkillDirsWithHeuristics(maybeLocalRoot, { maxDepth, maxSkills });
+            if (discovered.length === 0) {
+              const message = `No SKILL.md found at ${maybeLocalRoot} (or within subdirectories).`;
+              if (jsonOnly) {
+                printJson({ ok: false, error: "SKILL_MD_NOT_FOUND", message, source, resolvedSource });
+              } else {
+                console.error(chalk2.red(message));
+              }
+              process.exitCode = 1;
+              return;
+            }
+            const found = asDiscoveredSkills(discovered, (d) => path2.join(maybeLocalRoot, d.relPath));
+            const didReturn = await maybeEnableRecursiveAndInstall(found);
+            if (didReturn) return;
+            if (spinner) spinner.text = `Installing ${chalk2.cyan(source)} \u2014 discovered ${found.length} skills...`;
+            for (const skill of found) {
+              if (spinner) spinner.text = `Installing ${chalk2.cyan(skill.relPath)} (${scope})...`;
+              await installOne(skill.suggestedSource, skill.materializedDir);
+            }
+          }
+        } else {
+          const materialized = await materializeSourceToTemp(resolvedSource);
+          cleanupMaterialized = materialized.cleanup;
+          materializedRoot = materialized.dir;
+          const hasSkillMd = fs2.existsSync(path2.join(materializedRoot, "SKILL.md"));
+          if (hasSkillMd) {
+            await installOne(resolvedSource, materializedRoot);
+          } else {
+            const discovered = discoverSkillDirsWithHeuristics(materializedRoot, { maxDepth, 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, resolvedSource });
+              } else {
+                console.error(chalk2.red(message));
+              }
+              process.exitCode = 1;
+              return;
+            }
+            const found = asDiscoveredSkills(
+              discovered,
+              (d) => deriveRemoteChildSource(resolvedSource, d.relPath),
+              (d) => d.absDir
+            );
+            const didReturn = await maybeEnableRecursiveAndInstall(found);
+            if (didReturn) return;
+            if (spinner) spinner.text = `Installing ${chalk2.cyan(source)} \u2014 discovered ${found.length} skills...`;
+            for (const skill of found) {
+              if (spinner) spinner.text = `Installing ${chalk2.cyan(skill.relPath)} (${scope})...`;
+              await installOne(skill.suggestedSource, skill.materializedDir);
+            }
+          }
+        }
+      }
+    } finally {
+      if (cleanupMaterialized) cleanupMaterialized();
     }
     if (jsonOnly) {
-      if (!all) {
-        if (errors.length) console.log(JSON.stringify({ ok: false, error: errors[0]?.error || "Install failed." }, null, 2));
-        else console.log(JSON.stringify(results[0] ?? null, null, 2));
+      if (!all && !effectiveRecursive) {
+        if (errors.length) printJson({ ok: false, error: errors[0]?.error || "Install failed." });
+        else printJson(results[0] ?? null);
       } else {
-        console.log(JSON.stringify({ ok: errors.length === 0, source, resolvedSource, scope, results, errors }, null, 2));
+        printJson({ ok: errors.length === 0, source, resolvedSource, scope, recursive: effectiveRecursive, all, recursiveSkillCount, results, errors });
       }
       process.exitCode = errors.length ? 1 : 0;
       return;
@@ -148,12 +435,17 @@ async function install(source, options = {}) {
     if (errors.length === 0) {
       const displayName = results[0]?.canonicalName || results[0]?.name || source;
       spinner.succeed(
-        all ? `Installed ${chalk2.green(displayName)} to ${chalk2.dim(`${results.length} platforms`)}` : `Installed ${chalk2.green(displayName)} to ${chalk2.dim(results[0]?.installDir || "")}`
+        effectiveRecursive ? `Installed ${chalk2.green(String(recursiveSkillCount ?? results.length))}${chalk2.dim(" skills")} to ${chalk2.dim(`${targets.length} platforms`)}` : all ? `Installed ${chalk2.green(displayName)} to ${chalk2.dim(`${results.length} platforms`)}` : `Installed ${chalk2.green(displayName)} to ${chalk2.dim(results[0]?.installDir || "")}`
       );
     } else {
-      spinner.fail(`Failed to install ${chalk2.red(source)} to ${errors.length}/${targets.length} platforms`);
+      const attempted = results.length + errors.length;
+      spinner.fail(
+        effectiveRecursive ? `Install had failures (${errors.length}/${attempted} installs failed)` : `Failed to install ${chalk2.red(source)} to ${errors.length}/${targets.length} platforms`
+      );
+      process.exitCode = 1;
+      if (!all && errors[0]) console.error(chalk2.red(errors[0].error));
     }
-    if (!all && results[0]) {
+    if (!effectiveRecursive && !all && results[0]) {
       const record = results[0];
       if (record.hasSkillMd) logger.installDetail("SKILL.md found \u2713");
       else logger.installDetail("Warning: No SKILL.md found", true);
@@ -162,12 +454,13 @@ async function install(source, options = {}) {
       } else if (record.skill?.validation?.ok) {
         logger.installDetail(`Validation: ${chalk2.green("ok")}`);
       }
-    } else if (all) {
-      for (const r of results) {
+    } else if (effectiveRecursive || all) {
+      for (const r of results.slice(0, 60)) {
         const displayName = r.canonicalName || r.name;
         const suffix = r.hasSkillMd ? chalk2.green("\u2713") : chalk2.yellow("\u26A0");
         console.log(`  ${suffix} ${chalk2.cyan(displayName)} \u2192 ${chalk2.dim(r.platform)}`);
       }
+      if (results.length > 60) console.log(chalk2.dim(`  ... and ${results.length - 60} more`));
       if (errors.length) {
         console.log(chalk2.yellow("\nFailures:"));
         for (const e of errors) console.log(chalk2.yellow(`  - ${e.platform}: ${e.error}`));
@@ -176,7 +469,7 @@ async function install(source, options = {}) {
     }
   } catch (error) {
     const message = error instanceof SkildError ? error.message : error instanceof Error ? error.message : String(error);
-    if (jsonOnly) console.log(JSON.stringify({ ok: false, error: message }, null, 2));
+    if (jsonOnly) printJson({ ok: false, error: message });
     else console.error(chalk2.red(message));
     process.exitCode = 1;
   }
@@ -498,66 +791,6 @@ async function init(name, options = {}) {
 // src/commands/signup.ts
 import chalk9 from "chalk";
 import { fetchWithTimeout as fetchWithTimeout2, resolveRegistryUrl as resolveRegistryUrl2, SkildError as SkildError6 } from "@skild/core";
-
-// src/utils/prompt.ts
-import readline from "readline";
-async function promptLine(question, defaultValue) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
-  try {
-    const suffix = defaultValue ? ` (${defaultValue})` : "";
-    const answer = await new Promise((resolve) => rl.question(`${question}${suffix}: `, resolve));
-    const trimmed = answer.trim();
-    return trimmed || defaultValue || "";
-  } finally {
-    rl.close();
-  }
-}
-async function promptPassword(question) {
-  if (!process.stdin.isTTY || !process.stdout.isTTY) {
-    return promptLine(question);
-  }
-  const stdin = process.stdin;
-  const stdout = process.stdout;
-  stdout.write(`${question}: `);
-  const wasRaw = Boolean(stdin.isRaw);
-  stdin.setRawMode(true);
-  stdin.resume();
-  readline.emitKeypressEvents(stdin);
-  const buf = [];
-  return await new Promise((resolve, reject) => {
-    function cleanup() {
-      stdin.off("keypress", onKeypress);
-      stdin.setRawMode(wasRaw);
-      stdin.pause();
-    }
-    function onKeypress(str, key) {
-      if (key?.ctrl && key?.name === "c") {
-        stdout.write("\n");
-        cleanup();
-        const err = new Error("Prompt cancelled");
-        err.code = "PROMPT_CANCELLED";
-        reject(err);
-        return;
-      }
-      if (key?.name === "return" || key?.name === "enter") {
-        stdout.write("\n");
-        cleanup();
-        resolve(buf.join(""));
-        return;
-      }
-      if (key?.name === "backspace" || key?.name === "delete") {
-        if (buf.length) buf.pop();
-        return;
-      }
-      if (!str) return;
-      if (key?.ctrl || key?.meta) return;
-      buf.push(str);
-    }
-    stdin.on("keypress", onKeypress);
-  });
-}
-
-// src/commands/signup.ts
 async function signup(options) {
   const registry = resolveRegistryUrl2(options.registry);
   const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
@@ -750,9 +983,9 @@ async function whoami() {
 }
 
 // src/commands/publish.ts
-import fs2 from "fs";
+import fs3 from "fs";
 import os from "os";
-import path2 from "path";
+import path3 from "path";
 import crypto from "crypto";
 import * as tar from "tar";
 import chalk13 from "chalk";
@@ -775,7 +1008,7 @@ async function publish(options = {}) {
     process.exitCode = 1;
     return;
   }
-  const dir = path2.resolve(options.dir || process.cwd());
+  const dir = path3.resolve(options.dir || process.cwd());
   const validation = validateSkillDir(dir);
   if (!validation.ok) {
     console.error(chalk13.red("Skill validation failed:"));
@@ -845,8 +1078,8 @@ async function publish(options = {}) {
     }
   }
   const spinner = createSpinner(`Publishing ${chalk13.cyan(`${name}@${version2}`)} to ${chalk13.dim(registry)}...`);
-  const tempDir = fs2.mkdtempSync(path2.join(os.tmpdir(), "skild-publish-"));
-  const tarballPath = path2.join(tempDir, "skill.tgz");
+  const tempDir = fs3.mkdtempSync(path3.join(os.tmpdir(), "skild-publish-"));
+  const tarballPath = path3.join(tempDir, "skill.tgz");
   try {
     await tar.c(
       {
@@ -858,7 +1091,7 @@ async function publish(options = {}) {
       },
       ["."]
     );
-    const buf = fs2.readFileSync(tarballPath);
+    const buf = fs3.readFileSync(tarballPath);
     const integrity = sha256Hex(buf);
     const form = new FormData();
     form.set("version", version2);
@@ -925,7 +1158,7 @@ async function publish(options = {}) {
     console.error(chalk13.red(message));
     process.exitCode = 1;
   } finally {
-    fs2.rmSync(tempDir, { recursive: true, force: true });
+    fs3.rmSync(tempDir, { recursive: true, force: true });
   }
 }
 
@@ -967,7 +1200,7 @@ var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
 var program = new Command();
 program.name("skild").description("The npm for Agent Skills \u2014 Discover, install, manage, and publish AI Agent Skills with ease.").version(version);
-program.command("install <source>").alias("i").description("Install a Skill from a Git URL, degit shorthand, or local directory").option("-t, --target <platform>", `Target platform: ${PLATFORMS3.join(", ")}`).option("--all", `Install to all platforms: ${PLATFORMS3.join(", ")}`).option("-l, --local", "Install to project-level directory instead of global").option("-f, --force", "Overwrite existing installation").option("--registry <url>", "Registry base URL (default: https://registry.skild.sh)").option("--json", "Output JSON").action(async (source, options) => {
+program.command("install <source>").alias("i").description("Install a Skill from a Git URL, degit shorthand, or local directory").option("-t, --target <platform>", `Target platform: ${PLATFORMS3.join(", ")}`).option("--all", `Install to all platforms: ${PLATFORMS3.join(", ")}`).option("--recursive", "If source is a multi-skill directory/repo, install all discovered skills").option("-y, --yes", "Skip confirmation prompts (assume yes)").option("--depth <n>", "Max directory depth to scan for SKILL.md (default: 6)", "6").option("--max-skills <n>", "Max discovered skills to install (default: 200)", "200").option("-l, --local", "Install to project-level directory instead of global").option("-f, --force", "Overwrite existing installation").option("--registry <url>", "Registry base URL (default: https://registry.skild.sh)").option("--json", "Output JSON").action(async (source, options) => {
   await install(source, options);
 });
 program.command("list").alias("ls").description("List installed Skills").option("-t, --target <platform>", `Target platform: ${PLATFORMS3.join(", ")} (optional; omit to list all)`).option("-l, --local", "List project-level directory instead of global").option("--paths", "Show install paths").option("--verbose", "Show skillset dependency details").option("--json", "Output JSON").action(async (options) => list(options));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skild",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "The npm for Agent Skills — Discover, install, manage, and publish AI Agent Skills with ease.",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
     "commander": "^12.1.0",
     "ora": "^8.0.1",
     "tar": "^7.4.3",
-    "@skild/core": "^0.2.9"
+    "@skild/core": "^0.4.0"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",