skild 0.2.7 → 0.2.8

package/dist/index.js

@@ -57,10 +57,10 @@ var logger = {
   /**
    * Log a skill entry with status indicator.
    */
-  skillEntry: (name, path4, hasSkillMd) => {
+  skillEntry: (name, path3, hasSkillMd) => {
     const status = hasSkillMd ? chalk.green("\u2713") : chalk.yellow("\u26A0");
     console.log(`  ${status} ${chalk.cyan(name)}`);
-    console.log(chalk.dim(`    \u2514\u2500 ${path4}`));
+    console.log(chalk.dim(`    \u2514\u2500 ${path3}`));
   },
   /**
    * Log installation result details.
@@ -166,54 +166,122 @@ async function reportDownload(record, registryOverride) {
 
 // src/commands/list.ts
 import chalk3 from "chalk";
-import fs2 from "fs";
-import path2 from "path";
 import { PLATFORMS, listAllSkills, listSkills } from "@skild/core";
-function toDisplayName(name, mapping) {
-  return mapping.get(name) || name;
+function isSkillset(skill) {
+  return Boolean(skill.record?.skillset || skill.record?.skill?.frontmatter?.skillset);
 }
-function buildDisplayEntries(skills) {
-  const nameToDisplay = /* @__PURE__ */ new Map();
-  for (const skill of skills) {
-    const displayName = skill.record?.canonicalName || skill.name;
-    nameToDisplay.set(skill.name, displayName);
-  }
-  const entries = skills.map((skill) => {
-    const displayName = toDisplayName(skill.name, nameToDisplay);
-    const flags = [];
-    if (skill.record?.skillset || skill.record?.skill?.frontmatter?.skillset) {
-      flags.push("skillset");
-    }
-    if (skill.record?.dependedBy?.length) {
-      const dependedBy = skill.record.dependedBy.map((name) => toDisplayName(name, nameToDisplay));
-      flags.push(`dep of: ${dependedBy.join(", ")}`);
-    }
-    return {
-      name: displayName,
-      installDir: skill.installDir,
-      status: skill.hasSkillMd ? "ok" : "warn",
-      flags
-    };
-  });
+function getDisplayName(skill) {
+  return skill.record?.canonicalName || skill.record?.skill?.frontmatter?.name || skill.name;
+}
+function buildNameToDisplay(skills) {
+  const mapping = /* @__PURE__ */ new Map();
   for (const skill of skills) {
-    const inlineDeps = skill.record?.installedDependencies?.filter((dep) => dep.sourceType === "inline") || [];
-    if (!inlineDeps.length) continue;
-    const ownerName = toDisplayName(skill.name, nameToDisplay);
-    for (const dep of inlineDeps) {
-      const inlineDir = dep.inlinePath ? path2.join(skill.installDir, dep.inlinePath) : path2.join(skill.installDir, dep.name);
-      const hasSkillMd = fs2.existsSync(path2.join(inlineDir, "SKILL.md"));
-      entries.push({
-        name: dep.name,
-        installDir: inlineDir,
-        status: hasSkillMd ? "ok" : "warn",
-        flags: [`dep of: ${ownerName}`]
-      });
+    mapping.set(skill.name, getDisplayName(skill));
+  }
+  return mapping;
+}
+function statusIcon(skill) {
+  return skill.hasSkillMd ? chalk3.green("\u2713") : chalk3.yellow("\u26A0");
+}
+function missingSkillMdLabel(skill) {
+  return skill.hasSkillMd ? "" : chalk3.yellow(" (missing SKILL.md)");
+}
+function formatDepName(dep, nameToDisplay) {
+  return dep.canonicalName || nameToDisplay.get(dep.name) || dep.name;
+}
+function summarizeDeps(record) {
+  const deps = record?.installedDependencies || [];
+  if (deps.length === 0) return null;
+  const byType = deps.reduce(
+    (acc, d) => {
+      acc.total += 1;
+      if (d.sourceType === "inline") acc.inline += 1;
+      else acc.external += 1;
+      acc.bySourceType[d.sourceType] = (acc.bySourceType[d.sourceType] || 0) + 1;
+      return acc;
+    },
+    { total: 0, inline: 0, external: 0, bySourceType: {} }
+  );
+  const parts = [];
+  if (byType.inline) parts.push(`${byType.inline} inline`);
+  const externalParts = Object.entries(byType.bySourceType).filter(([t]) => t !== "inline").sort(([a], [b]) => a.localeCompare(b)).map(([t, c2]) => `${c2} ${t}`);
+  if (externalParts.length) parts.push(...externalParts);
+  return `deps: ${byType.total}${parts.length ? ` (${parts.join(", ")})` : ""}`;
+}
+function printSkillsetSection(skills, nameToDisplay, options) {
+  console.log(chalk3.bold(`  Skillsets (${skills.length})`));
+  if (skills.length === 0) {
+    console.log(chalk3.dim("    (none)"));
+    return;
+  }
+  for (const s of skills) {
+    const label = `${chalk3.cyan(getDisplayName(s))}${chalk3.dim(" (skillset)")}${missingSkillMdLabel(s)}`;
+    console.log(`    ${statusIcon(s)} ${label}`);
+    const summary = summarizeDeps(s.record);
+    if (summary) console.log(chalk3.dim(`      ${summary}`));
+    if (options.verbose) {
+      const deps = (s.record?.installedDependencies || []).slice().sort((a, b) => a.name.localeCompare(b.name));
+      if (deps.length) {
+        console.log(chalk3.dim(`      includes (${deps.length}):`));
+        for (const dep of deps) {
+          const depName = formatDepName(dep, nameToDisplay);
+          console.log(chalk3.dim(`        - ${depName} [${dep.sourceType}]`));
+        }
+      }
     }
+    if (options.paths || !s.hasSkillMd) console.log(chalk3.dim(`      path: ${s.installDir}`));
   }
-  return entries;
+}
+function printSkillsSection(skills, options) {
+  console.log(chalk3.bold(`  Skills (${skills.length})`));
+  if (skills.length === 0) {
+    console.log(chalk3.dim("    (none)"));
+    return;
+  }
+  for (const s of skills) {
+    const label = `${chalk3.cyan(getDisplayName(s))}${missingSkillMdLabel(s)}`;
+    console.log(`    ${statusIcon(s)} ${label}`);
+    if (options.paths || !s.hasSkillMd) console.log(chalk3.dim(`      path: ${s.installDir}`));
+  }
+}
+function printDependenciesSection(skills, nameToDisplay, options) {
+  console.log(chalk3.bold(`  Dependencies (${skills.length})`));
+  if (skills.length === 0) {
+    console.log(chalk3.dim("    (none)"));
+    return;
+  }
+  for (const s of skills) {
+    const dependedBy = (s.record?.dependedBy || []).map((name) => nameToDisplay.get(name) || name).sort((a, b) => a.localeCompare(b));
+    const requiredBy = dependedBy.length ? chalk3.dim(`  \u2190 required by: ${dependedBy.join(", ")}`) : "";
+    const label = `${chalk3.cyan(getDisplayName(s))}${missingSkillMdLabel(s)}${requiredBy}`;
+    console.log(`    ${statusIcon(s)} ${label}`);
+    if (options.paths || !s.hasSkillMd) console.log(chalk3.dim(`      path: ${s.installDir}`));
+  }
+}
+function printPlatform(skills, platform, scope, options) {
+  console.log(chalk3.bold(`
+\u{1F4E6} Installed Skills \u2014 ${platform} (${scope})
+`));
+  if (skills.length === 0) {
+    console.log(chalk3.dim("  No skills installed."));
+    console.log(chalk3.dim(`  Use ${chalk3.cyan("skild install <source>")} to install a skill.`));
+    return;
+  }
+  const nameToDisplay = buildNameToDisplay(skills);
+  const skillsets = skills.filter(isSkillset).sort((a, b) => getDisplayName(a).localeCompare(getDisplayName(b)));
+  const dependencies = skills.filter((s) => !isSkillset(s) && Boolean(s.record?.dependedBy?.length)).sort((a, b) => getDisplayName(a).localeCompare(getDisplayName(b)));
+  const regular = skills.filter((s) => !isSkillset(s) && !Boolean(s.record?.dependedBy?.length)).sort((a, b) => getDisplayName(a).localeCompare(getDisplayName(b)));
+  printSkillsetSection(skillsets, nameToDisplay, options);
+  console.log("");
+  printSkillsSection(regular, options);
+  console.log("");
+  printDependenciesSection(dependencies, nameToDisplay, options);
+  console.log("");
 }
 async function list(options = {}) {
   const scope = options.local ? "project" : "global";
+  const paths = Boolean(options.paths);
+  const verbose = Boolean(options.verbose);
   const platform = options.target;
   if (platform) {
     const skills = listSkills({ platform, scope });
@@ -221,22 +289,7 @@ async function list(options = {}) {
       console.log(JSON.stringify(skills, null, 2));
       return;
     }
-    if (skills.length === 0) {
-      console.log(chalk3.dim("No skills installed."));
-      console.log(chalk3.dim(`Use ${chalk3.cyan("skild install <source>")} to install a skill.`));
-      return;
-    }
-    const entries = buildDisplayEntries(skills);
-    console.log(chalk3.bold(`
-\u{1F4E6} Installed Skills (${entries.length}) \u2014 ${platform} (${scope}):
-`));
-    for (const entry of entries) {
-      const status = entry.status === "ok" ? chalk3.green("\u2713") : chalk3.yellow("\u26A0");
-      const label = entry.flags.length ? `${entry.name} (${entry.flags.join("; ")})` : entry.name;
-      console.log(`  ${status} ${chalk3.cyan(label)}`);
-      console.log(chalk3.dim(`    \u2514\u2500 ${entry.installDir}`));
-    }
-    console.log("");
+    printPlatform(skills, platform, scope, { paths, verbose });
     return;
   }
   const allSkills = listAllSkills({ scope });
@@ -249,26 +302,11 @@ async function list(options = {}) {
     console.log(chalk3.dim(`Use ${chalk3.cyan("skild install <source>")} to install a skill.`));
     return;
   }
-  console.log(chalk3.bold(`
-\u{1F4E6} Installed Skills \u2014 all platforms (${scope}):
-`));
   for (const p of PLATFORMS) {
     const platformSkills = allSkills.filter((s) => s.platform === p).sort((a, b) => a.name.localeCompare(b.name));
-    const entries = buildDisplayEntries(platformSkills);
-    const header = `${p} (${entries.length})`;
-    console.log(chalk3.bold(`  ${header}`));
-    if (entries.length === 0) {
-      console.log(chalk3.dim("    (none)"));
-      continue;
-    }
-    for (const entry of entries) {
-      const status = entry.status === "ok" ? chalk3.green("\u2713") : chalk3.yellow("\u26A0");
-      const label = entry.flags.length ? `${entry.name} (${entry.flags.join("; ")})` : entry.name;
-      console.log(`    ${status} ${chalk3.cyan(label)}`);
-      console.log(chalk3.dim(`      \u2514\u2500 ${entry.installDir}`));
-    }
+    if (platformSkills.length === 0) continue;
+    printPlatform(platformSkills, p, scope, { paths, verbose });
   }
-  console.log("");
 }
 
 // src/commands/info.ts
@@ -664,9 +702,9 @@ async function whoami() {
 }
 
 // src/commands/publish.ts
-import fs3 from "fs";
+import fs2 from "fs";
 import os from "os";
-import path3 from "path";
+import path2 from "path";
 import crypto from "crypto";
 import * as tar from "tar";
 import chalk13 from "chalk";
@@ -689,7 +727,7 @@ async function publish(options = {}) {
     process.exitCode = 1;
     return;
   }
-  const dir = path3.resolve(options.dir || process.cwd());
+  const dir = path2.resolve(options.dir || process.cwd());
   const validation = validateSkillDir(dir);
   if (!validation.ok) {
     console.error(chalk13.red("Skill validation failed:"));
@@ -748,8 +786,8 @@ async function publish(options = {}) {
     return;
   }
   const spinner = createSpinner(`Publishing ${chalk13.cyan(`${name}@${version2}`)} to ${chalk13.dim(registry)}...`);
-  const tempDir = fs3.mkdtempSync(path3.join(os.tmpdir(), "skild-publish-"));
-  const tarballPath = path3.join(tempDir, "skill.tgz");
+  const tempDir = fs2.mkdtempSync(path2.join(os.tmpdir(), "skild-publish-"));
+  const tarballPath = path2.join(tempDir, "skill.tgz");
   try {
     await tar.c(
       {
@@ -761,7 +799,7 @@ async function publish(options = {}) {
       },
       ["."]
     );
-    const buf = fs3.readFileSync(tarballPath);
+    const buf = fs2.readFileSync(tarballPath);
     const integrity = sha256Hex(buf);
     const form = new FormData();
     form.set("version", version2);
@@ -805,7 +843,7 @@ async function publish(options = {}) {
     console.error(chalk13.red(message));
     process.exitCode = 1;
   } finally {
-    fs3.rmSync(tempDir, { recursive: true, force: true });
+    fs2.rmSync(tempDir, { recursive: true, force: true });
   }
 }
 
@@ -850,7 +888,7 @@ program.name("skild").description("The npm for Agent Skills \u2014 Discover, ins
 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: ${PLATFORMS2.join(", ")}`, "claude").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: ${PLATFORMS2.join(", ")} (optional; omit to list all)`).option("-l, --local", "List project-level directory instead of global").option("--json", "Output JSON").action(async (options) => list(options));
+program.command("list").alias("ls").description("List installed Skills").option("-t, --target <platform>", `Target platform: ${PLATFORMS2.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));
 program.command("info <skill>").description("Show installed Skill details").option("-t, --target <platform>", `Target platform: ${PLATFORMS2.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("--json", "Output JSON").action(async (skill, options) => info(skill, options));
 program.command("uninstall <skill>").alias("rm").description("Uninstall a Skill").option("-t, --target <platform>", `Target platform: ${PLATFORMS2.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("-f, --force", "Uninstall even if metadata is missing").option("--with-deps", "Uninstall dependencies that are only required by this skill").action(async (skill, options) => uninstall(skill, options));
 program.command("update [skill]").alias("up").description("Update one or all installed Skills").option("-t, --target <platform>", `Target platform: ${PLATFORMS2.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("--json", "Output JSON").action(async (skill, options) => update(skill, options));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skild",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "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.7"
+    "@skild/core": "^0.2.8"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",