skild 0.1.3 → 0.2.0

package/README.md

@@ -33,3 +33,8 @@ skild uninstall pdf -t codex --local
 # Create a new Skill
 skild init my-skill
 ```
+
+Full user guide (CLI + registry + console):
+
+- `docs/usage.md`
+- `docs/usage.zh-CN.md`

package/dist/index.js

@@ -2,12 +2,12 @@
 
 // src/index.ts
 import { Command } from "commander";
-import chalk9 from "chalk";
+import chalk15 from "chalk";
 import { createRequire } from "module";
 
 // src/commands/install.ts
 import chalk2 from "chalk";
-import { installSkill, SkildError } from "@skild/core";
+import { fetchWithTimeout, installRegistrySkill, installSkill, resolveRegistryUrl, SkildError } from "@skild/core";
 
 // src/utils/logger.ts
 import chalk from "chalk";
@@ -55,10 +55,10 @@ var logger = {
   /**
    * Log a skill entry with status indicator.
    */
-  skillEntry: (name, path, hasSkillMd) => {
+  skillEntry: (name, path2, hasSkillMd) => {
     const status = hasSkillMd ? chalk.green("\u2713") : chalk.yellow("\u26A0");
     console.log(`  ${status} ${chalk.cyan(name)}`);
-    console.log(chalk.dim(`    \u2514\u2500 ${path}`));
+    console.log(chalk.dim(`    \u2514\u2500 ${path2}`));
   },
   /**
    * Log installation result details.
@@ -75,15 +75,12 @@ async function install(source, options = {}) {
   const scope = options.local ? "project" : "global";
   const spinner = createSpinner(`Installing ${chalk2.cyan(source)} to ${chalk2.dim(platform)} (${scope})...`);
   try {
-    const record = await installSkill(
-      { source },
-      {
-        platform,
-        scope,
-        force: Boolean(options.force)
-      }
-    );
-    spinner.succeed(`Installed ${chalk2.green(record.name)} to ${chalk2.dim(record.installDir)}`);
+    const record = source.trim().startsWith("@") && source.includes("/") ? await installRegistrySkill(
+      { spec: source, registryUrl: options.registry },
+      { platform, scope, force: Boolean(options.force) }
+    ) : await installSkill({ source }, { platform, scope, force: Boolean(options.force) });
+    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;
@@ -98,6 +95,7 @@ async function install(source, options = {}) {
     } else if (record.skill?.validation?.ok) {
       logger.installDetail(`Validation: ${chalk2.green("ok")}`);
     }
+    void reportDownload(record, options.registry);
   } catch (error) {
     spinner.fail(`Failed to install ${chalk2.red(source)}`);
     const message = error instanceof SkildError ? error.message : error instanceof Error ? error.message : String(error);
@@ -105,6 +103,36 @@ async function install(source, options = {}) {
     process.exitCode = 1;
   }
 }
+async function reportDownload(record, registryOverride) {
+  try {
+    if (record.sourceType === "local") return;
+    const registryUrl = resolveRegistryUrl(record.registryUrl || registryOverride);
+    const endpoint = `${registryUrl}/stats/downloads`;
+    const payload = { source: "cli" };
+    if (record.sourceType === "registry") {
+      payload.entityType = "registry";
+      payload.entityId = record.canonicalName || record.source;
+    } else if (record.sourceType === "github-url") {
+      payload.entityType = "linked";
+      payload.sourceInput = { provider: "github", url: record.source };
+    } else if (record.sourceType === "degit-shorthand") {
+      payload.entityType = "linked";
+      payload.sourceInput = { provider: "github", spec: record.source };
+    } else {
+      return;
+    }
+    await fetchWithTimeout(
+      endpoint,
+      {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(payload)
+      },
+      3e3
+    );
+  } catch {
+  }
+}
 
 // src/commands/list.ts
 import chalk3 from "chalk";
@@ -128,7 +156,8 @@ async function list(options = {}) {
 `));
     for (const s of skills) {
       const status = s.hasSkillMd ? chalk3.green("\u2713") : chalk3.yellow("\u26A0");
-      console.log(`  ${status} ${chalk3.cyan(s.name)}`);
+      const displayName = s.record?.canonicalName || s.name;
+      console.log(`  ${status} ${chalk3.cyan(displayName)}`);
       console.log(chalk3.dim(`    \u2514\u2500 ${s.installDir}`));
     }
     console.log("");
@@ -157,7 +186,8 @@ async function list(options = {}) {
     }
     for (const s of platformSkills) {
       const status = s.hasSkillMd ? chalk3.green("\u2713") : chalk3.yellow("\u26A0");
-      console.log(`    ${status} ${chalk3.cyan(s.name)}`);
+      const displayName = s.record?.canonicalName || s.name;
+      console.log(`    ${status} ${chalk3.cyan(displayName)}`);
       console.log(chalk3.dim(`      \u2514\u2500 ${s.installDir}`));
     }
   }
@@ -166,18 +196,20 @@ async function list(options = {}) {
 
 // src/commands/info.ts
 import chalk4 from "chalk";
-import { getSkillInfo, SkildError as SkildError2 } from "@skild/core";
+import { canonicalNameToInstallDirName, getSkillInfo, SkildError as SkildError2 } from "@skild/core";
 async function info(skill, options = {}) {
   const platform = options.target || "claude";
   const scope = options.local ? "project" : "global";
   try {
-    const record = getSkillInfo(skill, { platform, scope });
+    const resolvedName = skill.trim().startsWith("@") && skill.includes("/") ? canonicalNameToInstallDirName(skill.trim()) : skill;
+    const record = getSkillInfo(resolvedName, { platform, scope });
     if (options.json) {
       console.log(JSON.stringify(record, null, 2));
       return;
     }
+    const displayName = record.canonicalName || record.name;
     console.log(chalk4.bold(`
-${chalk4.cyan(record.name)}
+${chalk4.cyan(displayName)}
 `));
     console.log(`  ${chalk4.dim("Path:")} ${record.installDir}`);
     console.log(`  ${chalk4.dim("Source:")} ${record.source}`);
@@ -206,16 +238,18 @@ ${chalk4.cyan(record.name)}
 
 // src/commands/uninstall.ts
 import chalk5 from "chalk";
-import { uninstallSkill, SkildError as SkildError3 } from "@skild/core";
+import { canonicalNameToInstallDirName as canonicalNameToInstallDirName2, uninstallSkill, SkildError as SkildError3 } from "@skild/core";
 async function uninstall(skill, options = {}) {
   const platform = options.target || "claude";
   const scope = options.local ? "project" : "global";
-  const spinner = createSpinner(`Uninstalling ${chalk5.cyan(skill)} from ${chalk5.dim(platform)} (${scope})...`);
+  const canonical = skill.trim();
+  const resolvedName = canonical.startsWith("@") && canonical.includes("/") ? canonicalNameToInstallDirName2(canonical) : canonical;
+  const spinner = createSpinner(`Uninstalling ${chalk5.cyan(canonical)} from ${chalk5.dim(platform)} (${scope})...`);
   try {
-    uninstallSkill(skill, { platform, scope, allowMissingMetadata: Boolean(options.force) });
-    spinner.succeed(`Uninstalled ${chalk5.green(skill)}`);
+    uninstallSkill(resolvedName, { platform, scope, allowMissingMetadata: Boolean(options.force) });
+    spinner.succeed(`Uninstalled ${chalk5.green(canonical)}`);
   } catch (error) {
-    spinner.fail(`Failed to uninstall ${chalk5.red(skill)}`);
+    spinner.fail(`Failed to uninstall ${chalk5.red(canonical)}`);
     const message = error instanceof SkildError3 ? error.message : error instanceof Error ? error.message : String(error);
     console.error(chalk5.red(message));
     process.exitCode = 1;
@@ -224,14 +258,15 @@ async function uninstall(skill, options = {}) {
 
 // src/commands/update.ts
 import chalk6 from "chalk";
-import { updateSkill, SkildError as SkildError4 } from "@skild/core";
+import { canonicalNameToInstallDirName as canonicalNameToInstallDirName3, updateSkill, SkildError as SkildError4 } from "@skild/core";
 async function update(skill, options = {}) {
   const platform = options.target || "claude";
   const scope = options.local ? "project" : "global";
   const label = skill ? skill : "all skills";
+  const resolvedName = skill && skill.trim().startsWith("@") && skill.includes("/") ? canonicalNameToInstallDirName3(skill.trim()) : skill;
   const spinner = createSpinner(`Updating ${chalk6.cyan(label)} on ${chalk6.dim(platform)} (${scope})...`);
   try {
-    const results = await updateSkill(skill, { platform, scope });
+    const results = await updateSkill(resolvedName, { platform, scope });
     spinner.succeed(`Updated ${chalk6.green(results.length.toString())} skill(s).`);
     if (options.json) {
       console.log(JSON.stringify(results, null, 2));
@@ -246,12 +281,13 @@ async function update(skill, options = {}) {
 
 // src/commands/validate.ts
 import chalk7 from "chalk";
-import { validateSkill } from "@skild/core";
+import { canonicalNameToInstallDirName as canonicalNameToInstallDirName4, validateSkill } from "@skild/core";
 async function validate(target, options = {}) {
   const platform = options.target || "claude";
   const scope = options.local ? "project" : "global";
   const value = target || ".";
-  const result = validateSkill(value, { platform, scope });
+  const resolvedValue = value.trim().startsWith("@") && value.includes("/") ? canonicalNameToInstallDirName4(value.trim()) : value;
+  const result = validateSkill(resolvedValue, { platform, scope });
   if (options.json) {
     console.log(JSON.stringify(result, null, 2));
     process.exitCode = result.ok ? 0 : 1;
@@ -291,13 +327,391 @@ 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) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
+  rl.stdoutMuted = true;
+  rl._writeToOutput = function _writeToOutput(stringToWrite) {
+    if (this.stdoutMuted) return;
+    this.output.write(stringToWrite);
+  };
+  try {
+    const answer = await new Promise((resolve) => rl.question(`${question}: `, resolve));
+    return String(answer || "");
+  } finally {
+    rl.stdoutMuted = false;
+    rl.close();
+    process.stdout.write("\n");
+  }
+}
+
+// src/commands/signup.ts
+async function signup(options) {
+  const registry = resolveRegistryUrl2(options.registry);
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  const email = options.email?.trim() || "";
+  const handle = options.handle?.trim() || "";
+  const password = options.password || "";
+  if ((!email || !handle || !password) && (!interactive || options.json)) {
+    console.error(chalk9.red("Missing signup fields. Use --email/--handle/--password, or run `skild signup` interactively."));
+    process.exitCode = 1;
+    return;
+  }
+  const finalEmail = email || await promptLine("Email");
+  const finalHandle = handle || (await promptLine("Handle (publisher scope)", void 0)).toLowerCase();
+  const finalPassword = password || await promptPassword("Password");
+  let text = "";
+  try {
+    const res = await fetchWithTimeout2(
+      `${registry}/auth/signup`,
+      {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+          email: finalEmail,
+          handle: finalHandle,
+          password: finalPassword
+        })
+      },
+      1e4
+    );
+    text = await res.text();
+    if (!res.ok) {
+      console.error(chalk9.red(`Signup failed (${res.status}): ${text}`));
+      process.exitCode = 1;
+      return;
+    }
+  } catch (error) {
+    const message = error instanceof SkildError6 ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk9.red(`Signup failed: ${message}`));
+    process.exitCode = 1;
+    return;
+  }
+  if (options.json) {
+    console.log(text || JSON.stringify({ ok: true }, null, 2));
+    return;
+  }
+  console.log(chalk9.green("Signup successful."));
+  try {
+    const parsed = JSON.parse(text);
+    if (parsed.verification?.requiredForPublish) {
+      if (parsed.verification.mode === "log") {
+        console.log(chalk9.dim("Dev mode: email sending is disabled. Check the registry dev logs for the verification link."));
+      } else if (parsed.verification.sent) {
+        console.log(chalk9.dim("Verification email sent. Check your inbox (and spam)."));
+      } else {
+        console.log(chalk9.yellow("Verification email was not sent. You may need to resend from the Console."));
+      }
+      console.log(chalk9.dim(`Verify/resend in Console: ${(parsed.verification.consoleUrl || "https://console.skild.sh").replace(/\/+$/, "")}/verify-email/request`));
+    } else if (parsed.verification) {
+      console.log(chalk9.dim("Email verification is recommended. Publishing may be restricted in the future."));
+      console.log(chalk9.dim(`Verify/resend in Console: ${(parsed.verification.consoleUrl || "https://console.skild.sh").replace(/\/+$/, "")}/verify-email/request`));
+    }
+  } catch {
+  }
+  console.log(chalk9.dim("Next: run `skild login`"));
+}
+
+// src/commands/login.ts
+import chalk10 from "chalk";
+import { fetchWithTimeout as fetchWithTimeout3, resolveRegistryUrl as resolveRegistryUrl3, saveRegistryAuth, SkildError as SkildError7 } from "@skild/core";
+async function login(options) {
+  const registry = resolveRegistryUrl3(options.registry);
+  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+  const handleOrEmail = options.handleOrEmail?.trim() || "";
+  const password = options.password || "";
+  if ((!handleOrEmail || !password) && (!interactive || options.json)) {
+    console.error(chalk10.red("Missing credentials. Use --handle-or-email and --password, or run `skild login` interactively."));
+    process.exitCode = 1;
+    return;
+  }
+  const finalHandleOrEmail = handleOrEmail || await promptLine("Handle or email");
+  const finalPassword = password || await promptPassword("Password");
+  const finalTokenName = options.tokenName?.trim() || void 0;
+  let text = "";
+  try {
+    const res = await fetchWithTimeout3(
+      `${registry}/auth/login`,
+      {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+          handleOrEmail: finalHandleOrEmail,
+          password: finalPassword,
+          tokenName: finalTokenName
+        })
+      },
+      1e4
+    );
+    text = await res.text();
+    if (!res.ok) {
+      console.error(chalk10.red(`Login failed (${res.status}): ${text}`));
+      process.exitCode = 1;
+      return;
+    }
+  } catch (error) {
+    const message = error instanceof SkildError7 ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk10.red(`Login failed: ${message}`));
+    process.exitCode = 1;
+    return;
+  }
+  const json = JSON.parse(text);
+  saveRegistryAuth({
+    schemaVersion: 1,
+    registryUrl: registry,
+    token: json.token,
+    publisher: json.publisher,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  if (options.json) {
+    console.log(JSON.stringify({ ok: true, publisher: json.publisher }, null, 2));
+    return;
+  }
+  console.log(chalk10.green(`Logged in as ${chalk10.cyan(json.publisher.handle)}.`));
+  if (json.publisher.emailVerified === false) {
+    console.log(chalk10.yellow("Email not verified. Publishing may be restricted by server policy."));
+    console.log(chalk10.dim("Open the Publisher Console to verify: https://console.skild.sh/verify-email/request"));
+  }
+}
+
+// src/commands/logout.ts
+import chalk11 from "chalk";
+import { clearRegistryAuth } from "@skild/core";
+async function logout() {
+  clearRegistryAuth();
+  console.log(chalk11.green("Logged out."));
+}
+
+// src/commands/whoami.ts
+import chalk12 from "chalk";
+import { fetchWithTimeout as fetchWithTimeout4, loadRegistryAuth, resolveRegistryUrl as resolveRegistryUrl4, SkildError as SkildError8 } from "@skild/core";
+async function whoami() {
+  const auth = loadRegistryAuth();
+  if (!auth) {
+    console.error(chalk12.red("Not logged in. Run `skild login` first."));
+    process.exitCode = 1;
+    return;
+  }
+  const registryUrl = resolveRegistryUrl4(auth.registryUrl);
+  try {
+    const res = await fetchWithTimeout4(
+      `${registryUrl}/auth/me`,
+      { headers: { authorization: `Bearer ${auth.token}`, accept: "application/json" } },
+      5e3
+    );
+    const text = await res.text();
+    if (!res.ok) {
+      console.error(chalk12.red(`whoami failed (${res.status}): ${text}`));
+      process.exitCode = 1;
+      return;
+    }
+    const json = JSON.parse(text);
+    console.log(chalk12.cyan(json.publisher.handle));
+  } catch (error) {
+    const message = error instanceof SkildError8 ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk12.red(`whoami failed: ${message}`));
+    console.error(chalk12.dim("Tip: if you previously logged into a local registry, run `skild logout` then `skild login`."));
+    process.exitCode = 1;
+  }
+}
+
+// src/commands/publish.ts
+import fs from "fs";
+import os from "os";
+import path from "path";
+import crypto from "crypto";
+import * as tar from "tar";
+import chalk13 from "chalk";
+import { fetchWithTimeout as fetchWithTimeout5, loadRegistryAuth as loadRegistryAuth2, resolveRegistryUrl as resolveRegistryUrl5, SkildError as SkildError9, splitCanonicalName, validateSkillDir } from "@skild/core";
+function sha256Hex(buf) {
+  const h = crypto.createHash("sha256");
+  h.update(buf);
+  return h.digest("hex");
+}
+function parseTargets(raw) {
+  if (!raw?.trim()) return [];
+  return raw.split(",").map((s) => s.trim()).filter(Boolean);
+}
+async function publish(options = {}) {
+  const auth = loadRegistryAuth2();
+  const registry = resolveRegistryUrl5(options.registry || auth?.registryUrl);
+  const token = auth?.token;
+  if (!token) {
+    console.error(chalk13.red("Not logged in. Run `skild login` first."));
+    process.exitCode = 1;
+    return;
+  }
+  const dir = path.resolve(options.dir || process.cwd());
+  const validation = validateSkillDir(dir);
+  if (!validation.ok) {
+    console.error(chalk13.red("Skill validation failed:"));
+    for (const issue of validation.issues) console.error(chalk13.red(`- ${issue.message}`));
+    process.exitCode = 1;
+    return;
+  }
+  const fm = validation.frontmatter;
+  let name = (options.name || fm.name || "").trim();
+  const version2 = (options.skillVersion || fm.version || "").trim();
+  const description = (options.description || fm.description || "").trim();
+  const tag = (options.tag || "latest").trim() || "latest";
+  const targets = parseTargets(options.targets);
+  if (!name) {
+    console.error(chalk13.red("Missing name. Provide SKILL.md frontmatter.name or --name."));
+    process.exitCode = 1;
+    return;
+  }
+  if (!name.startsWith("@")) {
+    const seg = name.trim();
+    if (!/^[a-z0-9][a-z0-9-]{1,63}$/.test(seg)) {
+      console.error(chalk13.red("Invalid name. Use @publisher/skill or a simple skill name (lowercase letters/digits/dashes)."));
+      process.exitCode = 1;
+      return;
+    }
+    const meRes = await fetchWithTimeout5(
+      `${registry}/auth/me`,
+      { headers: { authorization: `Bearer ${token}` } },
+      1e4
+    );
+    const meText = await meRes.text();
+    if (!meRes.ok) {
+      console.error(chalk13.red(`Failed to infer publisher scope (${meRes.status}): ${meText}`));
+      process.exitCode = 1;
+      return;
+    }
+    const meJson = JSON.parse(meText);
+    const handle = String(meJson?.publisher?.handle || "").trim().toLowerCase();
+    if (!handle) {
+      console.error(chalk13.red("Failed to infer publisher scope from registry response."));
+      process.exitCode = 1;
+      return;
+    }
+    name = `@${handle}/${seg}`;
+  }
+  if (!/^@[a-z0-9][a-z0-9-]{1,31}\/[a-z0-9][a-z0-9-]{1,63}$/.test(name)) {
+    console.error(chalk13.red("Invalid publish name. Expected @publisher/skill (lowercase letters/digits/dashes)."));
+    process.exitCode = 1;
+    return;
+  }
+  if (!version2) {
+    console.error(chalk13.red("Missing version. Provide semver like 1.2.3 via SKILL.md frontmatter or --skill-version."));
+    process.exitCode = 1;
+    return;
+  }
+  const spinner = createSpinner(`Publishing ${chalk13.cyan(`${name}@${version2}`)} to ${chalk13.dim(registry)}...`);
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "skild-publish-"));
+  const tarballPath = path.join(tempDir, "skill.tgz");
+  try {
+    await tar.c(
+      {
+        gzip: true,
+        file: tarballPath,
+        cwd: dir,
+        portable: true,
+        filter: (p) => !p.startsWith(".skild") && !p.startsWith(".git")
+      },
+      ["."]
+    );
+    const buf = fs.readFileSync(tarballPath);
+    const integrity = sha256Hex(buf);
+    const form = new FormData();
+    form.set("version", version2);
+    form.set("description", description);
+    form.set("targets", JSON.stringify(targets));
+    form.set("tag", tag);
+    form.append("tarball", new Blob([buf], { type: "application/gzip" }), "skill.tgz");
+    const { scope, name: skillName } = splitCanonicalName(name);
+    const res = await fetchWithTimeout5(
+      `${registry}/skills/${encodeURIComponent(scope)}/${encodeURIComponent(skillName)}/publish`,
+      {
+        method: "POST",
+        headers: { authorization: `Bearer ${token}` },
+        body: form
+      },
+      3e4
+    );
+    const text = await res.text();
+    if (!res.ok) {
+      spinner.fail(`Publish failed (${res.status})`);
+      console.error(chalk13.red(text));
+      process.exitCode = 1;
+      return;
+    }
+    if (options.json) {
+      console.log(text);
+      return;
+    }
+    spinner.succeed(`Published ${chalk13.green(`${name}@${version2}`)} (sha256:${integrity.slice(0, 12)}\u2026)`);
+    try {
+      const parsed = JSON.parse(text);
+      const warnings = Array.isArray(parsed.warnings) ? parsed.warnings.map(String).filter(Boolean) : [];
+      for (const w of warnings) console.warn(chalk13.yellow(`Warning: ${w}`));
+    } catch {
+    }
+  } catch (error) {
+    spinner.fail("Publish failed");
+    const message = error instanceof SkildError9 ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk13.red(message));
+    process.exitCode = 1;
+  } finally {
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  }
+}
+
+// src/commands/search.ts
+import chalk14 from "chalk";
+import { resolveRegistryUrl as resolveRegistryUrl6, searchRegistrySkills, SkildError as SkildError10 } from "@skild/core";
+async function search(query, options = {}) {
+  const registryUrl = resolveRegistryUrl6(options.registry);
+  const limit = Math.min(Math.max(Number.parseInt(options.limit || "50", 10) || 50, 1), 100);
+  try {
+    const skills = await searchRegistrySkills(registryUrl, query, limit);
+    if (options.json) {
+      console.log(JSON.stringify({ ok: true, registryUrl, skills }, null, 2));
+      return;
+    }
+    if (!skills.length) {
+      console.log(chalk14.dim("No results."));
+      return;
+    }
+    console.log(chalk14.bold(`
+\u{1F50E} Results (${skills.length}) \u2014 ${chalk14.dim(registryUrl)}
+`));
+    for (const s of skills) {
+      const name = String(s.name || "").trim();
+      const desc = String(s.description || "").trim();
+      if (!name) continue;
+      console.log(`  ${chalk14.cyan(name)}${desc ? chalk14.dim(` \u2014 ${desc}`) : ""}`);
+    }
+  } catch (error) {
+    const message = error instanceof SkildError10 ? error.message : error instanceof Error ? error.message : String(error);
+    console.error(chalk14.red(message));
+    process.exitCode = 1;
+  }
+}
+
 // src/index.ts
 import { PLATFORMS as PLATFORMS2 } 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("--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: ${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));
@@ -306,8 +720,14 @@ program.command("uninstall <skill>").alias("rm").description("Uninstall a Skill"
 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("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("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(chalk9.bold("\n\u{1F6E1}\uFE0F skild \u2014 Get your agents skilled.\n"));
+  console.log(chalk15.bold("\n\u{1F6E1}\uFE0F skild \u2014 Get your agents skilled.\n"));
   program.outputHelp();
 });
 var argv = process.argv.slice();

package/package.json

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