@neta-art/neta-search-cli 0.2.14 → 0.2.18

package/README.md

@@ -3,17 +3,23 @@
 Command-line client for **neta-search**, the skill registry of the Cohub / Neta platform: search the ecosystem for a ready-made skill, try it without installing, or install it into your space.
 
 ```bash
-npx -y @neta-art/neta-search-cli@0.2 skills find "generate video"     # search (Chinese or English)
-npx -y @neta-art/neta-search-cli@0.2 skills find "browser automation" --json
-npx -y @neta-art/neta-search-cli@0.2 skills use  <id>                 # print the SKILL.md (pulled into a temp dir; no project files written)
-npx -y @neta-art/neta-search-cli@0.2 skills add  <id>                 # install into .agents/skills/
-npx -y @neta-art/neta-search-cli@0.2 skills init <name>               # scaffold your own skill
+npx -y @neta-art/neta-search-cli@latest skills find "generate video"     # search (Chinese or English)
+npx -y @neta-art/neta-search-cli@latest skills find "browser automation" --json
+npx -y @neta-art/neta-search-cli@latest skills use  <id>                 # print the SKILL.md (pulled into a temp dir; no project files written)
+npx -y @neta-art/neta-search-cli@latest skills add  <id>                 # install into .agents/skills/
+npx -y @neta-art/neta-search-cli@latest skills list                      # what's in .agents/skills/, and which installed ones have updates
+npx -y @neta-art/neta-search-cli@latest skills update                    # update installed skills to their current release (or name some: handle, id or directory)
+npx -y @neta-art/neta-search-cli@latest skills init <name>               # scaffold your own skill
 ```
 
-`<id>` comes from `find` results, e.g. `cohub:<spaceId>/<name>`.
+`<id>` is what `find` prints: a handle such as `neta-skills/holo-pack-opening` or `cohub/agent-browser`. Skills without a handle are listed as `cohub:<spaceId>/<name>`, which works everywhere a handle does. `update` and `remove` also accept the directory name under `.agents/skills/`.
+
+`remove` deletes installed skills only. Skills you wrote yourself (no install record) are left alone unless you pass `--force`.
 
 `use` prints the skill directory and the full SKILL.md, so an agent can follow it right away; relative paths in SKILL.md resolve against that directory. If the local entry is a pointer (frontmatter `metadata.neta-skill-id`), `use` fetches the full skill it points to.
 
+Use `@latest` (or an exact version): with a range such as `@0.2`, npx keeps running whatever matching version it cached earlier and never checks for a newer one.
+
 Inside a Cohub sandbox the CLI picks up the sandbox identity automatically; elsewhere it runs anonymously.
 
 Single file, no runtime dependencies. Node.js 20+.

package/neta-search.mjs

@@ -2660,7 +2660,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         const negativeNumberArg = (arg) => {
           if (!/^-(\d+|\d*\.\d+)(e[+-]?\d+)?$/.test(arg)) return false;
           return !this._getCommandAndAncestors().some(
-            (cmd) => cmd.options.map((opt) => opt.short).some((short) => /^-\d$/.test(short))
+            (cmd) => cmd.options.map((opt) => opt.short).some((short2) => /^-\d$/.test(short2))
           );
         };
         let activeVariadicOption = null;
@@ -27075,7 +27075,21 @@ async function fetchArchive(env, id) {
   const files = untarGz(body);
   const got = digestOf(new Map(files.map((f) => [f.path, f.data])));
   if (got !== digest) throw new Error(`\u4E0B\u8F7D\u7684 ${id} \u5185\u5BB9\u6821\u9A8C\u5931\u8D25\uFF08\u671F\u671B ${digest}\uFF0C\u5B9E\u9645 ${got}\uFF09`);
-  return { id, name, digest, files };
+  const handle = res.headers.get("x-skill-handle") || void 0;
+  return { id, handle, name, digest, files };
+}
+async function archiveHead(env, id) {
+  const url = `${env.apiBase}${ARCHIVE_PATH}?id=${encodeURIComponent(id)}`;
+  const res = await fetch(url, { method: "HEAD", redirect: "manual", signal: AbortSignal.timeout(1e4) });
+  if (res.status === 404) return null;
+  const digest = res.headers.get("x-skill-digest") ?? "";
+  if (res.status < 300 || res.status >= 400 || !digest) throw new Error(`\u67E5\u8BE2 ${id} \u5931\u8D25\uFF1AHTTP ${res.status}`);
+  return {
+    id: res.headers.get("x-skill-id") ?? id,
+    handle: res.headers.get("x-skill-handle") || void 0,
+    name: res.headers.get("x-skill-name") ?? id.split("/").pop(),
+    digest
+  };
 }
 async function download(url, id) {
   for (let attempt = 1; ; attempt++) {
@@ -27156,6 +27170,21 @@ function parseId(s) {
   const m = ID_RE.exec(s);
   return m ? { spaceId: m[1], name: m[2] } : null;
 }
+var HANDLE_RE = /^(@[a-z0-9_.-]{1,64}|[a-z0-9][a-z0-9-]{0,31})\/[a-z0-9][a-z0-9-]{0,63}$/i;
+function isHandle(s) {
+  return !parseId(s) && HANDLE_RE.test(s);
+}
+async function resolveRef(env, input) {
+  if (!isHandle(input)) return input;
+  try {
+    const r = await fetch(`${env.apiBase}/v1/skills/resolve?handle=${encodeURIComponent(input)}`, { signal: AbortSignal.timeout(5e3) });
+    if (!r.ok) return input;
+    const out = await r.json();
+    return typeof out.id === "string" && parseId(out.id) ? out.id : input;
+  } catch {
+    return input;
+  }
+}
 function ownId(env, name) {
   return `cohub:${env.spaceId}/${name}`;
 }
@@ -27165,11 +27194,20 @@ function skillDirExists(p) {
 function readSource(dir) {
   try {
     const r = JSON.parse(readFileSync2(join2(dir, SOURCE_FILE), "utf8"));
-    return typeof r?.id === "string" && parseId(r.id) ? { id: r.id, digest: String(r.digest ?? "") } : null;
+    if (typeof r?.id !== "string" || !parseId(r.id)) return null;
+    const rec = { id: r.id, digest: String(r.digest ?? "") };
+    if (typeof r.handle === "string" && HANDLE_RE.test(r.handle)) rec.handle = r.handle;
+    return rec;
   } catch {
     return null;
   }
 }
+function writeSource(dir, rec) {
+  writeFileSync(join2(dir, SOURCE_FILE), JSON.stringify(rec, null, 2) + "\n");
+}
+function displayRef(rec, fallback2 = "") {
+  return rec?.handle || rec?.id || fallback2;
+}
 function writeSkill(target, files, source) {
   const staging = join2(dirname(target), `.staging-${target.split("/").pop()}-${process.pid}`);
   rmSync(staging, { recursive: true, force: true });
@@ -27228,6 +27266,7 @@ function shareNotice(id, dir, draft, reported) {
 // cli/src/skills/add.ts
 async function cmdAdd(idOrName, opts) {
   const env = detectEnv();
+  idOrName = await resolveRef(env, idOrName);
   const parsed = parseId(idOrName);
   const name = parsed?.name ?? idOrName;
   const target = join3(opts.dir, name);
@@ -27251,10 +27290,10 @@ async function cmdAdd(idOrName, opts) {
     return 1;
   }
   mkdirSync2(opts.dir, { recursive: true });
-  writeSkill(target, archive.files, { id: archive.id, digest: archive.digest });
+  writeSkill(target, archive.files, { id: archive.id, digest: archive.digest, handle: archive.handle });
   const report = reportSkillEvent(env, "install", archive.id, archive.digest, name);
-  if (opts.json) console.log(JSON.stringify({ installed: archive.id, path: target, digest: archive.digest }));
-  else console.log(`\u5DF2\u5B89\u88C5 ${archive.id} \u2192 ${target}`);
+  if (opts.json) console.log(JSON.stringify({ installed: archive.id, handle: archive.handle, path: target, digest: archive.digest }));
+  else console.log(`\u5DF2\u5B89\u88C5 ${displayRef(archive)} \u2192 ${target}`);
   await report;
   return 0;
 }
@@ -27279,19 +27318,11 @@ import { existsSync as existsSync3, readdirSync as readdirSync2, readFileSync as
 import { randomUUID } from "node:crypto";
 import { join as join4 } from "node:path";
 var FETCH_ROOT = process.env["NETASEARCH_FETCH_ROOT"] ?? join4("/tmp", "neta-skills");
-var HANDLE_RE = /^(@[a-z0-9_.-]{1,64}|[a-z0-9][a-z0-9-]{0,31})\/[a-z0-9][a-z0-9-]{0,63}$/i;
-async function resolveHandle(env, input) {
-  const r = await fetch(`${env.apiBase}/v1/skills/resolve?handle=${encodeURIComponent(input)}`, { signal: AbortSignal.timeout(5e3) });
-  if (!r.ok) return null;
-  const out = await r.json();
-  return typeof out.id === "string" && parseId(out.id) ? out.id : null;
-}
 async function cmdUse(idOrName, opts) {
   const env = detectEnv();
-  if (!parseId(idOrName) && HANDLE_RE.test(idOrName)) {
-    const resolved = await resolveHandle(env, idOrName).catch(() => null);
-    if (resolved) idOrName = resolved;
-  }
+  const input = idOrName;
+  idOrName = await resolveRef(env, idOrName);
+  let handle = isHandle(input) && parseId(idOrName) ? input.toLowerCase() : void 0;
   const parsed = parseId(idOrName);
   const name = parsed?.name ?? idOrName;
   const mine = !parsed || parsed.spaceId === env.spaceId;
@@ -27308,6 +27339,7 @@ async function cmdUse(idOrName, opts) {
     if (src && (!parsed || src.id === idOrName)) {
       path = installed;
       reportId = src.id;
+      handle = handle ?? src.handle;
     } else if (!src && mine) {
       path = installed;
       reportId = ownId(env, name);
@@ -27351,8 +27383,9 @@ async function cmdUse(idOrName, opts) {
       const p = parseId(a.id);
       path = join4(FETCH_ROOT, p.spaceId, p.name);
       const have = readSource(path);
-      if (!skillDirExists(path) || have?.digest !== a.digest) writeSkill(path, a.files, { id: a.id, digest: a.digest });
+      if (!skillDirExists(path) || have?.digest !== a.digest) writeSkill(path, a.files, { id: a.id, digest: a.digest, handle: a.handle });
       reportId = a.id;
+      handle = a.handle ?? handle;
       where = "fetched";
     } catch (e) {
       console.error(e instanceof ArchiveNotFound ? `${e.message}\u3002` : String(e instanceof Error ? e.message : e));
@@ -27369,10 +27402,10 @@ async function cmdUse(idOrName, opts) {
   const reported = reportId ? await reportSkillEvent(env, "use", reportId, skillDirDigest(path), name, extra) : false;
   const skillMd = readFileSync3(join4(path, "SKILL.md"), "utf8");
   if (opts.json) {
-    console.log(JSON.stringify({ skill: reportId ?? name, path, where, use_id: reportId ? useId : void 0, skill_md: skillMd }));
+    console.log(JSON.stringify({ skill: reportId ?? name, handle, path, where, use_id: reportId ? useId : void 0, skill_md: skillMd }));
   } else {
     const label = { local: "\u672C\u5730", mod: "\u5E73\u53F0 mod", fetched: "\u5DF2\u4E0B\u8F7D\u5230\u4E34\u65F6\u76EE\u5F55" }[where];
-    console.log(`${reportId ?? name} \u5C31\u7EEA\uFF08${label}${via === "pointer" ? "\uFF0C\u7ECF\u6307\u9488" : ""}\uFF09`);
+    console.log(`${handle ?? reportId ?? name} \u5C31\u7EEA\uFF08${label}${via === "pointer" ? "\uFF0C\u7ECF\u6307\u9488" : ""}\uFF09`);
     console.log(`skill \u76EE\u5F55\uFF1A${path}`);
     console.log(`SKILL.md \u91CC\u7684\u76F8\u5BF9\u8DEF\u5F84\u90FD\u4ECE\u8FD9\u4E2A\u76EE\u5F55\u7B97\u8D77\u3002\u4E0B\u9762\u5C31\u662F SKILL.md \u7684\u5168\u6587\uFF0C\u7167\u7740\u505A\u5373\u53EF\uFF08\u4E0D\u7528\u518D\u8BFB\u4E00\u6B21\u6587\u4EF6\uFF09\u3002`);
     console.log(`
@@ -27443,6 +27476,169 @@ metadata:
 `;
 }
 
+// cli/src/skills/manage.ts
+import { existsSync as existsSync5, readdirSync as readdirSync3, rmSync as rmSync2 } from "node:fs";
+import { join as join6 } from "node:path";
+function scanLocal(dir) {
+  if (!existsSync5(dir)) return [];
+  const out = [];
+  for (const e of readdirSync3(dir, { withFileTypes: true })) {
+    if (!e.isDirectory() || e.name.startsWith(".")) continue;
+    const path = join6(dir, e.name);
+    if (!skillDirExists(path)) continue;
+    const src = readSource(path);
+    if (src) {
+      out.push({ name: e.name, path, kind: "installed", id: src.id, handle: src.handle, digest: src.digest });
+      continue;
+    }
+    const ptr = pointerTarget(path);
+    out.push(ptr ? { name: e.name, path, kind: "pointer", id: ptr } : { name: e.name, path, kind: "own" });
+  }
+  return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+async function findLocal(env, local, input) {
+  if (!input.includes("/") && !input.startsWith(".")) {
+    const s = local.find((x) => x.name === input);
+    if (s) return [s];
+  }
+  const ref = parseId(input) ? input : await resolveRef(env, input);
+  const lower = input.toLowerCase();
+  return local.filter((x) => x.id !== void 0 && x.id === ref || x.handle !== void 0 && x.handle.toLowerCase() === lower);
+}
+async function statusOf(env, s) {
+  if (s.kind !== "installed" || !s.id) return { status: "unknown" };
+  try {
+    const head = await archiveHead(env, s.id);
+    if (!head) return { status: "unavailable" };
+    return { status: head.digest === s.digest ? "latest" : "outdated", latest: head.digest, handle: head.handle };
+  } catch (e) {
+    return { status: "unknown", error: e instanceof Error ? e.message : String(e) };
+  }
+}
+var KIND_LABEL = { installed: "\u88C5\u6765\u7684", pointer: "\u6307\u9488", own: "\u81EA\u5DF1\u5199\u7684" };
+var STATUS_LABEL = { latest: "\u6700\u65B0", outdated: "\u6709\u66F4\u65B0", unavailable: "\u5DF2\u4E0B\u67B6", unknown: "" };
+async function cmdList(opts) {
+  const env = detectEnv();
+  const local = scanLocal(opts.dir);
+  const rows = await Promise.all(
+    local.map(async (s) => {
+      const st = opts.offline ? { status: "unknown", handle: void 0 } : await statusOf(env, s);
+      return { ...s, ...st, handle: s.handle ?? st.handle };
+    })
+  );
+  if (opts.json) {
+    console.log(JSON.stringify({ dir: opts.dir, count: rows.length, skills: rows }));
+    return 0;
+  }
+  if (rows.length === 0) {
+    console.log(`${opts.dir}/ \u91CC\u6CA1\u6709 skill\u3002\u7528 neta-search skills find <\u610F\u56FE> \u627E\uFF0C\u518D add \u5B89\u88C5\u3002`);
+    return 0;
+  }
+  console.log(`${opts.dir}/\uFF08${rows.length} \u4E2A\uFF09\uFF1A`);
+  for (const r of rows) {
+    const st = STATUS_LABEL[r.status] ? `  [${STATUS_LABEL[r.status]}]` : "";
+    const from = r.id ? `  ${displayRef(r)}` : "";
+    console.log(`  ${r.name.padEnd(28)} ${KIND_LABEL[r.kind]}${st}${from}`);
+  }
+  const outdated = rows.filter((r) => r.status === "outdated").length;
+  if (outdated > 0) console.log(`
+${outdated} \u4E2A\u6709\u66F4\u65B0\uFF1Aneta-search skills update`);
+  return 0;
+}
+async function cmdUpdate(names, opts) {
+  const env = detectEnv();
+  const local = scanLocal(opts.dir);
+  const targets = [];
+  const results = [];
+  let failed = 0;
+  if (names.length === 0) {
+    targets.push(...local.filter((s) => s.kind === "installed"));
+  } else {
+    for (const n of names) {
+      const found = await findLocal(env, local, n);
+      if (found.length === 0) {
+        results.push({ name: n, result: "not_found" });
+        failed++;
+      }
+      for (const s of found) {
+        if (s.kind !== "installed") results.push({ name: s.name, result: s.kind === "own" ? "own_skipped" : "pointer_skipped" });
+        else if (!targets.includes(s)) targets.push(s);
+      }
+    }
+  }
+  for (const s of targets) {
+    const st = await statusOf(env, s);
+    if (st.status === "latest") {
+      if (st.handle && st.handle !== s.handle) writeSource(s.path, { id: s.id, digest: s.digest, handle: st.handle });
+      results.push({ name: s.name, result: "latest" });
+      continue;
+    }
+    if (st.status === "unavailable") {
+      results.push({ name: s.name, result: "unavailable" });
+      continue;
+    }
+    if (st.status === "unknown") {
+      results.push({ name: s.name, result: "error", from: st.error });
+      failed++;
+      continue;
+    }
+    try {
+      const a = await fetchArchive(env, s.id);
+      writeSkill(s.path, a.files, { id: s.id, digest: a.digest, handle: a.handle ?? s.handle });
+      await reportSkillEvent(env, "install", s.id, a.digest, s.name);
+      results.push({ name: s.name, result: "updated", from: s.digest, to: a.digest });
+    } catch (e) {
+      results.push({ name: s.name, result: e instanceof ArchiveNotFound ? "unavailable" : "error", from: e instanceof Error ? e.message : String(e) });
+      if (!(e instanceof ArchiveNotFound)) failed++;
+    }
+  }
+  if (opts.json) {
+    console.log(JSON.stringify({ results }));
+    return failed > 0 ? 1 : 0;
+  }
+  if (results.length === 0) console.log(`${opts.dir}/ \u91CC\u6CA1\u6709\u88C5\u6765\u7684 skill\uFF0C\u4E0D\u7528\u66F4\u65B0\u3002`);
+  const say = {
+    updated: (r) => `\u5DF2\u66F4\u65B0 ${r.name}\uFF08${short(r.from)} \u2192 ${short(r.to)}\uFF09`,
+    latest: (r) => `${r.name} \u5DF2\u662F\u6700\u65B0`,
+    unavailable: (r) => `${r.name} \u6765\u6E90\u5DF2\u4E0B\u67B6\u6216\u64A4\u56DE\uFF0C\u4FDD\u7559\u672C\u5730\u526F\u672C`,
+    own_skipped: (r) => `${r.name} \u662F\u4F60\u81EA\u5DF1\u5199\u7684\uFF0C\u4E0D\u7528\u66F4\u65B0`,
+    pointer_skipped: (r) => `${r.name} \u662F\u6307\u9488\uFF0Cuse \u65F6\u603B\u662F\u53D6\u6700\u65B0\uFF0C\u4E0D\u7528\u66F4\u65B0`,
+    not_found: (r) => `${opts.dir}/${r.name} \u4E0D\u5B58\u5728`,
+    error: (r) => `${r.name} \u66F4\u65B0\u5931\u8D25\uFF1A${r.from ?? ""}`
+  };
+  for (const r of results) console.log(say[r.result](r));
+  return failed > 0 ? 1 : 0;
+}
+function short(d) {
+  return (d ?? "").replace(/^sha256:/, "").slice(0, 12) || "?";
+}
+async function cmdRemove(names, opts) {
+  const env = detectEnv();
+  const local = scanLocal(opts.dir);
+  const results = [];
+  for (const n of names) {
+    const found = (await findLocal(env, local, n)).filter((s) => existsSync5(s.path));
+    if (found.length === 0) results.push({ name: n, result: "not_found" });
+    for (const s of found) {
+      if (s.kind === "own" && !opts.force) {
+        results.push({ name: s.name, result: "own_refused" });
+      } else {
+        rmSync2(s.path, { recursive: true, force: true });
+        results.push({ name: s.name, result: "removed" });
+      }
+    }
+  }
+  const failed = results.filter((r) => r.result !== "removed").length;
+  if (opts.json) console.log(JSON.stringify({ results }));
+  else
+    for (const r of results) {
+      if (r.result === "removed") console.log(`\u5DF2\u5220\u9664 ${join6(opts.dir, r.name)}`);
+      else if (r.result === "not_found") console.error(`${join6(opts.dir, r.name)} \u4E0D\u5B58\u5728`);
+      else console.error(`${r.name} \u662F\u4F60\u81EA\u5DF1\u5199\u7684 skill\uFF08\u6CA1\u6709\u5B89\u88C5\u6765\u6E90\uFF09\uFF0C\u6CA1\u5220\u3002\u786E\u5B9A\u8981\u5220\u5C31\u52A0 --force\u3002`);
+    }
+  return failed > 0 ? 1 : 0;
+}
+
 // cli/src/version.ts
 import { createRequire } from "node:module";
 var OUR_NAMES = /* @__PURE__ */ new Set(["@neta-search/cli", "@neta-art/neta-search-cli"]);
@@ -27461,16 +27657,25 @@ function cliVersion() {
 // cli/src/cli.ts
 var program2 = new Command();
 program2.name("neta-search").description("neta-search\u2014\u2014Cohub \u751F\u6001\u68C0\u7D22 CLI\uFF08\u8D44\u6E90\u5B50\u547D\u4EE4\uFF1Askills\uFF1B\u667A\u80FD\u5728 search-api\uFF0CCLI \u662F\u8584\u58F3\uFF09").version(cliVersion());
-var skills = program2.command("skills").description("skill \u57DF\uFF1Afind/add/use/init");
+var skills = program2.command("skills").description("skill \u57DF\uFF1Afind/add/use/list/update/remove/init");
 skills.command("find").description("\u627E skill\uFF08\u751F\u6001\u8D26\u672C+\u5916\u90E8\u6E90\u6DF7\u6392\u68C0\u7D22\uFF09").argument("<query>", "\u68C0\u7D22\u610F\u56FE\uFF08\u81EA\u7136\u8BED\u8A00/\u5173\u952E\u8BCD\uFF09").option("-n, --limit <n>", "\u5019\u9009\u6570\u4E0A\u9650", "20").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (query, opts) => {
   await run(cmdFind(query, { limit: Number(opts.limit) || 20, json: opts.json }));
 });
-skills.command("add").description("\u88C5 skill\uFF08find \u7ED3\u679C\u7684 id\uFF1A\u4E0B\u8F7D\u4F5C\u8005\u7528\u8FC7\u7684\u90A3\u4E00\u7248\uFF1B\u6216\u81EA\u5DF1\u8349\u7A3F\u533A\u7684\u540D\u5B57\uFF1A\u79FB\u5230 .agents/skills/\uFF09").argument("<id-or-name>", "find \u8FD4\u56DE\u7684 skill id\uFF0C\u6216\u81EA\u5DF1\u8349\u7A3F\u533A\u7684 skill \u540D").option("--dir <dir>", "\u5B89\u88C5\u76EE\u5F55\uFF08\u9ED8\u8BA4 .agents/skills/\uFF09", ".agents/skills").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (idOrName, opts) => {
+skills.command("add").description("\u88C5 skill\uFF08find \u7ED3\u679C\u7684 id \u6216 handle\uFF1A\u4E0B\u8F7D\u5F53\u524D\u4E0A\u67B6\u7684\u7248\u672C\uFF1B\u6216\u81EA\u5DF1\u8349\u7A3F\u533A\u7684\u540D\u5B57\uFF1A\u79FB\u5230 .agents/skills/\uFF09").argument("<id-or-name>", "find \u8FD4\u56DE\u7684 skill id \u6216 handle\uFF08\u5982 neta-skills/holo-pack-opening\uFF09\uFF0C\u6216\u81EA\u5DF1\u8349\u7A3F\u533A\u7684 skill \u540D").option("--dir <dir>", "\u5B89\u88C5\u76EE\u5F55\uFF08\u9ED8\u8BA4 .agents/skills/\uFF09", ".agents/skills").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (idOrName, opts) => {
   await run(cmdAdd(idOrName, opts));
 });
-skills.command("use").description("\u7528 skill\uFF08\u4E0D\u88C5\uFF1A\u6253\u5370 SKILL.md \u5168\u6587\u548C skill \u76EE\u5F55\uFF1B\u672C\u5730\u6709\u2192\u7528\u672C\u5730\u7684\uFF1B\u672C\u5730\u662F\u6307\u9488\u6216\u6CA1\u6709\u2192\u6309 id \u4E0B\u8F7D\u5230\u4E34\u65F6\u76EE\u5F55\uFF09").argument("<id-or-name>", "skill id \u6216 name").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").option("--via <channel>", "\u4ECE\u54EA\u4E2A\u6E20\u9053\u6765\u7684\uFF08\u8BB0\u8FDB\u4F7F\u7528\u8BB0\u5F55\uFF1Bhub mod \u7684\u6307\u9488\u5199 pointer\uFF09").action(async (idOrName, opts) => {
+skills.command("use").description("\u7528 skill\uFF08\u4E0D\u88C5\uFF1A\u6253\u5370 SKILL.md \u5168\u6587\u548C skill \u76EE\u5F55\uFF1B\u672C\u5730\u6709\u2192\u7528\u672C\u5730\u7684\uFF1B\u672C\u5730\u662F\u6307\u9488\u6216\u6CA1\u6709\u2192\u6309 id \u4E0B\u8F7D\u5230\u4E34\u65F6\u76EE\u5F55\uFF09").argument("<id-or-name>", "skill id\u3001handle\uFF08\u5982 neta-skills/holo-pack-opening\uFF09\u6216\u672C\u5730 skill \u540D").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").option("--via <channel>", "\u4ECE\u54EA\u4E2A\u6E20\u9053\u6765\u7684\uFF08\u8BB0\u8FDB\u4F7F\u7528\u8BB0\u5F55\uFF1Bhub mod \u7684\u6307\u9488\u5199 pointer\uFF09").action(async (idOrName, opts) => {
   await run(cmdUse(idOrName, opts));
 });
+skills.command("list").alias("ls").description("\u5217\u51FA\u672C\u5730\u7684 skill\uFF08\u88C5\u6765\u7684 / \u6307\u9488 / \u81EA\u5DF1\u5199\u7684\uFF09\uFF0C\u88C5\u6765\u7684\u987A\u5E26\u67E5\u6709\u6CA1\u6709\u66F4\u65B0").option("--dir <dir>", "\u76EE\u5F55\uFF08\u9ED8\u8BA4 .agents/skills/\uFF09", ".agents/skills").option("--offline", "\u4E0D\u8054\u7F51\u67E5\u66F4\u65B0").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (opts) => {
+  await run(cmdList({ dir: opts.dir, offline: !!opts.offline, json: !!opts.json }));
+});
+skills.command("update").description("\u66F4\u65B0\u88C5\u6765\u7684 skill \u5230\u5F53\u524D\u4E0A\u67B6\u7684\u7248\u672C\uFF08\u4E0D\u7ED9\u540D\u5B57 = \u5168\u90E8\uFF1B\u81EA\u5DF1\u5199\u7684\u548C\u6307\u9488\u4E0D\u78B0\uFF09").argument("[names...]", "\u8981\u66F4\u65B0\u7684 skill\uFF1A\u76EE\u5F55\u540D\u3001handle\uFF08\u5982 neta-skills/holo-pack-opening\uFF09\u6216\u5B9A\u4F4D\u7B26").option("--dir <dir>", "\u76EE\u5F55\uFF08\u9ED8\u8BA4 .agents/skills/\uFF09", ".agents/skills").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (names, opts) => {
+  await run(cmdUpdate(names, { dir: opts.dir, json: !!opts.json }));
+});
+skills.command("remove").alias("rm").description("\u5220\u9664\u672C\u5730 skill\uFF08\u88C5\u6765\u7684 / \u6307\u9488\uFF1B\u81EA\u5DF1\u5199\u7684\u8981 --force\uFF09").argument("<names...>", "\u8981\u5220\u7684 skill\uFF1A\u76EE\u5F55\u540D\u3001handle \u6216\u5B9A\u4F4D\u7B26").option("--dir <dir>", "\u76EE\u5F55\uFF08\u9ED8\u8BA4 .agents/skills/\uFF09", ".agents/skills").option("--force", "\u8FDE\u81EA\u5DF1\u5199\u7684\u4E5F\u5220").option("--json", "\u7D27\u51D1 JSON \u8F93\u51FA\uFF08agent \u6D88\u8D39\uFF09").action(async (names, opts) => {
+  await run(cmdRemove(names, { dir: opts.dir, force: !!opts.force, json: !!opts.json }));
+});
 skills.command("init").description("\u521B\u5EFA skill \u811A\u624B\u67B6\uFF08SKILL.md + frontmatter \u89C4\u8303\uFF09").argument("[name]", "skill \u540D\uFF08kebab-case\uFF09").option("--here", "\u5728\u5F53\u524D\u76EE\u5F55\u751F\u6210\uFF08\u9ED8\u8BA4\u751F\u6210\u5230 ./<name>/ \u5B50\u76EE\u5F55\uFF09").action(async (name, opts) => {
   await run(cmdInit(name, opts));
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/neta-search-cli",
-  "version": "0.2.14",
+  "version": "0.2.18",
   "description": "neta-search CLI — find, try and install skills from the Cohub / Neta skill registry",
   "type": "module",
   "bin": {