skild 0.2.8 → 0.3.0

package/dist/index.js

@@ -9,7 +9,7 @@ import { createRequire } from "module";
 import fs from "fs";
 import path from "path";
 import chalk2 from "chalk";
-import { fetchWithTimeout, installRegistrySkill, installSkill, loadRegistryAuth, resolveRegistryAlias, resolveRegistryUrl, SkildError } from "@skild/core";
+import { fetchWithTimeout, installRegistrySkill, installSkill, isValidAlias, loadRegistryAuth, resolveRegistryAlias, resolveRegistryUrl, SkildError, PLATFORMS } from "@skild/core";
 
 // src/utils/logger.ts
 import chalk from "chalk";
@@ -79,16 +79,20 @@ function looksLikeAlias(input) {
   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 (s.length < 3 || s.length > 64) return false;
-  if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$/.test(s)) return false;
-  if (s.includes("--")) return false;
+  if (!isValidAlias(s)) return false;
   return true;
 }
 async function install(source, options = {}) {
-  const platform = options.target || "claude";
   const scope = options.local ? "project" : "global";
   const auth = loadRegistryAuth();
   const registryUrlForDeps = options.registry || auth?.registryUrl;
+  const all = Boolean(options.all);
+  const platform = options.target || "claude";
+  if (all && options.target) {
+    console.error(chalk2.red("Invalid options: use either --all or --target, not both."));
+    process.exitCode = 1;
+    return;
+  }
   let resolvedSource = source.trim();
   try {
     if (looksLikeAlias(resolvedSource)) {
@@ -103,29 +107,68 @@ async function install(source, options = {}) {
     process.exitCode = 1;
     return;
   }
-  const spinner = createSpinner(`Installing ${chalk2.cyan(source)} to ${chalk2.dim(platform)} (${scope})...`);
+  const targets = all ? [...PLATFORMS] : [platform];
+  const results = [];
+  const errors = [];
+  const spinner = createSpinner(
+    all ? `Installing ${chalk2.cyan(source)} to ${chalk2.dim("all platforms")} (${scope})...` : `Installing ${chalk2.cyan(source)} to ${chalk2.dim(platform)} (${scope})...`
+  );
   try {
-    const record = resolvedSource.startsWith("@") && resolvedSource.includes("/") ? await installRegistrySkill(
-      { spec: resolvedSource, registryUrl: registryUrlForDeps },
-      { platform, scope, force: Boolean(options.force) }
-    ) : await installSkill({ source: resolvedSource }, { platform, scope, force: Boolean(options.force), registryUrl: registryUrlForDeps });
-    const displayName = record.canonicalName || record.name;
-    spinner.succeed(`Installed ${chalk2.green(displayName)} to ${chalk2.dim(record.installDir)}`);
-    if (options.json) {
-      console.log(JSON.stringify(record, null, 2));
-      return;
+    for (const targetPlatform of targets) {
+      spinner.text = `Installing ${chalk2.cyan(source)} to ${chalk2.dim(targetPlatform)} (${scope})...`;
+      try {
+        const record = resolvedSource.startsWith("@") && resolvedSource.includes("/") ? await installRegistrySkill(
+          { spec: resolvedSource, registryUrl: registryUrlForDeps },
+          { platform: targetPlatform, scope, force: Boolean(options.force) }
+        ) : await installSkill(
+          { source: resolvedSource },
+          { 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 });
+      }
     }
-    if (record.hasSkillMd) {
-      logger.installDetail("SKILL.md found \u2713");
+    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 || "")}`
+      );
     } else {
-      logger.installDetail("Warning: No SKILL.md found", true);
+      spinner.fail(`Failed to install ${chalk2.red(source)} to ${errors.length}/${targets.length} platforms`);
     }
-    if (record.skill?.validation && !record.skill.validation.ok) {
-      logger.installDetail(`Validation: ${chalk2.yellow("failed")} (${record.skill.validation.issues.length} issues)`, true);
-    } else if (record.skill?.validation?.ok) {
-      logger.installDetail(`Validation: ${chalk2.green("ok")}`);
+    if (options.json) {
+      if (!all) {
+        console.log(JSON.stringify(results[0] ?? null, null, 2));
+      } else {
+        console.log(JSON.stringify({ ok: errors.length === 0, source, resolvedSource, scope, results, errors }, null, 2));
+      }
+      process.exitCode = errors.length ? 1 : 0;
+      return;
+    }
+    if (!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);
+      if (record.skill?.validation && !record.skill.validation.ok) {
+        logger.installDetail(`Validation: ${chalk2.yellow("failed")} (${record.skill.validation.issues.length} issues)`, true);
+      } else if (record.skill?.validation?.ok) {
+        logger.installDetail(`Validation: ${chalk2.green("ok")}`);
+      }
+    } else if (all) {
+      for (const r of results) {
+        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 (errors.length) {
+        console.log(chalk2.yellow("\nFailures:"));
+        for (const e of errors) console.log(chalk2.yellow(`  - ${e.platform}: ${e.error}`));
+      }
+      process.exitCode = errors.length ? 1 : 0;
     }
-    void reportDownload(record, registryUrlForDeps);
   } catch (error) {
     spinner.fail(`Failed to install ${chalk2.red(source)}`);
     const message = error instanceof SkildError ? error.message : error instanceof Error ? error.message : String(error);
@@ -166,7 +209,7 @@ async function reportDownload(record, registryOverride) {
 
 // src/commands/list.ts
 import chalk3 from "chalk";
-import { PLATFORMS, listAllSkills, listSkills } from "@skild/core";
+import { PLATFORMS as PLATFORMS2, listAllSkills, listSkills } from "@skild/core";
 function isSkillset(skill) {
   return Boolean(skill.record?.skillset || skill.record?.skill?.frontmatter?.skillset);
 }
@@ -302,7 +345,7 @@ async function list(options = {}) {
     console.log(chalk3.dim(`Use ${chalk3.cyan("skild install <source>")} to install a skill.`));
     return;
   }
-  for (const p of PLATFORMS) {
+  for (const p of PLATFORMS2) {
     const platformSkills = allSkills.filter((s) => s.platform === p).sort((a, b) => a.name.localeCompare(b.name));
     if (platformSkills.length === 0) continue;
     printPlatform(platformSkills, p, scope, { paths, verbose });
@@ -708,7 +751,7 @@ import path2 from "path";
 import crypto from "crypto";
 import * as tar from "tar";
 import chalk13 from "chalk";
-import { fetchWithTimeout as fetchWithTimeout5, loadRegistryAuth as loadRegistryAuth3, resolveRegistryUrl as resolveRegistryUrl5, SkildError as SkildError9, splitCanonicalName, validateSkillDir } from "@skild/core";
+import { assertValidAlias, fetchWithTimeout as fetchWithTimeout5, loadRegistryAuth as loadRegistryAuth3, normalizeAlias, resolveRegistryUrl as resolveRegistryUrl5, SkildError as SkildError9, splitCanonicalName, validateSkillDir } from "@skild/core";
 function sha256Hex(buf) {
   const h = crypto.createHash("sha256");
   h.update(buf);
@@ -738,6 +781,7 @@ async function publish(options = {}) {
   const fm = validation.frontmatter;
   let name = (options.name || fm.name || "").trim();
   const version2 = (options.skillVersion || fm.version || "").trim();
+  const alias = normalizeAlias(options.alias);
   const description = (options.description || fm.description || "").trim();
   const tag = (options.tag || "latest").trim() || "latest";
   const targets = parseTargets(options.targets);
@@ -785,6 +829,16 @@ async function publish(options = {}) {
     process.exitCode = 1;
     return;
   }
+  if (alias) {
+    try {
+      assertValidAlias(alias);
+    } catch (error) {
+      const message = error instanceof SkildError9 ? error.message : error instanceof Error ? error.message : String(error);
+      console.error(chalk13.red(message));
+      process.exitCode = 1;
+      return;
+    }
+  }
   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");
@@ -826,11 +880,34 @@ async function publish(options = {}) {
       process.exitCode = 1;
       return;
     }
+    if (alias) {
+      spinner.text = `Publishing ${chalk13.cyan(`${name}@${version2}`)} \u2014 setting alias ${chalk13.cyan(alias)}...`;
+      const aliasRes = await fetchWithTimeout5(
+        `${registry}/publisher/skills/${encodeURIComponent(scope)}/${encodeURIComponent(skillName)}/alias`,
+        {
+          method: "POST",
+          headers: {
+            authorization: `Bearer ${token}`,
+            "content-type": "application/json"
+          },
+          body: JSON.stringify({ alias })
+        },
+        1e4
+      );
+      const aliasText = await aliasRes.text();
+      if (!aliasRes.ok) {
+        spinner.fail(`Failed to set alias (${aliasRes.status})`);
+        console.error(chalk13.red(aliasText));
+        process.exitCode = 1;
+        return;
+      }
+    }
     if (options.json) {
       console.log(text);
       return;
     }
-    spinner.succeed(`Published ${chalk13.green(`${name}@${version2}`)} (sha256:${integrity.slice(0, 12)}\u2026)`);
+    const suffix = alias ? ` (alias: ${chalk13.cyan(alias)})` : "";
+    spinner.succeed(`Published ${chalk13.green(`${name}@${version2}`)}${suffix} (sha256:${integrity.slice(0, 12)}\u2026)`);
     try {
       const parsed = JSON.parse(text);
       const warnings = Array.isArray(parsed.warnings) ? parsed.warnings.map(String).filter(Boolean) : [];
@@ -880,25 +957,25 @@ async function search(query, options = {}) {
 }
 
 // src/index.ts
-import { PLATFORMS as PLATFORMS2 } from "@skild/core";
+import { PLATFORMS as PLATFORMS3 } from "@skild/core";
 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: ${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) => {
+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) => {
   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("--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));
-program.command("validate [target]").alias("v").description("Validate a Skill folder (path) or an installed Skill name").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 (target, options) => validate(target, 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));
+program.command("info <skill>").description("Show installed Skill details").option("-t, --target <platform>", `Target platform: ${PLATFORMS3.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: ${PLATFORMS3.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: ${PLATFORMS3.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("--json", "Output JSON").action(async (skill, options) => update(skill, options));
+program.command("validate [target]").alias("v").description("Validate a Skill folder (path) or an installed Skill name").option("-t, --target <platform>", `Target platform: ${PLATFORMS3.join(", ")}`, "claude").option("-l, --local", "Use project-level directory instead of global").option("--json", "Output JSON").action(async (target, options) => validate(target, options));
 program.command("init <name>").description("Create a new Skill project").option("--dir <path>", "Target directory (defaults to <name>)").option("--description <text>", "Skill description").option("-f, --force", "Overwrite target directory if it exists").action(async (name, options) => init(name, options));
 program.command("signup").description("Create a publisher account in the registry (no GitHub required)").option("--registry <url>", "Registry base URL (default: https://registry.skild.sh)").option("--email <email>", "Email (optional; will prompt)").option("--handle <handle>", "Publisher handle (owns @handle/* scope) (optional; will prompt)").option("--password <password>", "Password (optional; will prompt)").option("--json", "Output JSON").action(async (options) => signup(options));
 program.command("login").description("Login to a registry and store an access token locally").option("--registry <url>", "Registry base URL (default: https://registry.skild.sh)").option("--handle-or-email <value>", "Handle or email (optional; will prompt)").option("--password <password>", "Password (optional; will prompt)").option("--token-name <name>", "Token label").option("--json", "Output JSON").action(async (options) => login(options));
 program.command("logout").description("Remove stored registry credentials").action(async () => logout());
 program.command("whoami").description("Show current registry identity").action(async () => whoami());
-program.command("publish").description("Publish a Skill directory to the registry (hosted tarball)").option("--dir <path>", "Skill directory (defaults to cwd)").option("--name <@publisher/skill>", "Override skill name (defaults to SKILL.md frontmatter)").option("--skill-version <semver>", "Override version (defaults to SKILL.md frontmatter)").option("--description <text>", "Override description (defaults to SKILL.md frontmatter)").option("--targets <list>", "Comma-separated target platforms metadata (optional)").option("--tag <tag>", "Dist-tag (default: latest)", "latest").option("--registry <url>", "Registry base URL (defaults to saved login)").option("--json", "Output JSON").action(async (options) => publish(options));
+program.command("publish").description("Publish a Skill directory to the registry (hosted tarball)").option("--dir <path>", "Skill directory (defaults to cwd)").option("--name <@publisher/skill>", "Override skill name (defaults to SKILL.md frontmatter)").option("--skill-version <semver>", "Override version (defaults to SKILL.md frontmatter)").option("--alias <alias>", "Optional short identifier (global unique) for `skild install <alias>`").option("--description <text>", "Override description (defaults to SKILL.md frontmatter)").option("--targets <list>", "Comma-separated target platforms metadata (optional)").option("--tag <tag>", "Dist-tag (default: latest)", "latest").option("--registry <url>", "Registry base URL (defaults to saved login)").option("--json", "Output JSON").action(async (options) => publish(options));
 program.command("search <query>").description("Search Skills in the registry").option("--registry <url>", "Registry base URL (default: https://registry.skild.sh)").option("--limit <n>", "Max results (default: 50)", "50").option("--json", "Output JSON").action(async (query, options) => search(query, options));
 program.action(() => {
   console.log(chalk15.bold("\n\u{1F6E1}\uFE0F skild \u2014 Get your agents skilled.\n"));

package/package.json

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