ht-skills 0.1.1 → 0.1.3

package/README.md

@@ -5,7 +5,7 @@ CLI for installing and submitting skills from HT Skills Marketplace.
 ## Usage
 
 ```powershell
-npx ht-skills install repo-bug-analyze --registry http://skills.ic.aeroht.local
+npx ht-skills add http://skills.ic.aeroht.local --skill repo-bug-analyze
 ```
 
 ## Commands
@@ -14,4 +14,5 @@ npx ht-skills install repo-bug-analyze --registry http://skills.ic.aeroht.local
 ht-skills search <query> [--registry <url>] [--limit <n>]
 ht-skills submit <skillDir> [--registry <url>] [--submitter <name>] [--visibility public|private|shared] [--shared-with a@b.com,c@d.com] [--publish-now]
 ht-skills install <slug[@version]> [--registry <url>] [--target <dir>] [--tool codex|claude|vscode]
+ht-skills add <registry> --skill <slug[@version]> [--tool codex|claude|vscode]
 ```

package/bin/ht-skills.js

@@ -3,6 +3,10 @@
 const cli = require("../lib/cli");
 
 cli.main().catch((error) => {
+  if (error && error.reported) {
+    process.exitCode = 1;
+    return;
+  }
   // eslint-disable-next-line no-console
   console.error(`error: ${error.message}`);
   process.exitCode = 1;

package/lib/cli.js

@@ -41,13 +41,15 @@ function printHelp() {
   ht-skills search <query> [--registry <url>] [--limit <n>]
   ht-skills submit <skillDir> [--registry <url>] [--submitter <name>] [--visibility public|private|shared] [--shared-with a@b.com,c@d.com] [--publish-now]
   ht-skills install <slug[@version]> [--registry <url>] [--target <dir>] [--tool codex|claude|vscode]
+  ht-skills add <registry> --skill <slug[@version]> [--tool codex|claude|vscode]
 
 Examples:
   ht-skills search openai --registry http://localhost:8787
   ht-skills submit ./examples/hello-skill --registry http://localhost:8787
   ht-skills install hello-skill@1.0.0 --registry http://localhost:8787 --tool codex
   ht-skills install hello-skill@1.0.0 --registry http://localhost:8787 --tool codex,claude,vscode
-  ht-skills install hello-skill --registry http://localhost:8787`);
+  ht-skills install hello-skill --registry http://localhost:8787
+  ht-skills add http://localhost:8787 --skill hello-skill`);
 }
 
 function parseArgs(argv) {
@@ -91,11 +93,37 @@ async function requestJson(url, options = {}) {
   }
   if (!res.ok) {
     const message = payload.error || text || `HTTP ${res.status}`;
-    throw new Error(message);
+    const error = new Error(message);
+    error.status = res.status;
+    error.url = url;
+    throw error;
   }
   return payload;
 }
 
+function formatInstallError(error, { slug, version = null, registry, stage = "resolve" }) {
+  const rawMessage = String(error?.message || "Install failed").trim();
+  const status = Number(error?.status || 0);
+  const lowerMessage = rawMessage.toLowerCase();
+  const isNotFound = status === 404 || lowerMessage === "not found";
+
+  if (isNotFound && stage === "resolve") {
+    return `Skill "${slug}" was not found in registry ${registry}.`;
+  }
+  if (isNotFound && stage === "metadata") {
+    return version
+      ? `Skill "${slug}@${version}" metadata was not found in registry ${registry}.`
+      : `Skill "${slug}" metadata was not found in registry ${registry}.`;
+  }
+  if (isNotFound && stage === "bundle") {
+    return version
+      ? `Skill bundle "${slug}@${version}" was not found in registry ${registry}.`
+      : `Skill bundle for "${slug}" was not found in registry ${registry}.`;
+  }
+
+  return rawMessage;
+}
+
 async function walkFiles(baseDir) {
   const results = [];
   const ignored = new Set([".git", "node_modules", ".DS_Store"]);
@@ -448,15 +476,31 @@ async function cmdInstall(flags, deps = {}) {
   const parsed = parseSpec(spec);
 
   const resolveSpinner = ui ? ui.spinner() : null;
-  if (resolveSpinner) {
-    // eslint-disable-next-line no-console
-    console.log(`\n${renderGradientBanner()}\n`);
-    ui.intro(ui.pc.bgCyan(ui.pc.black(" ht-skills ")));
-    resolveSpinner.start(`Resolving ${parsed.slug}`);
-  }
-  const version = await fetchResolvedVersion(registry, parsed, requestJsonImpl);
-  if (resolveSpinner) {
-    resolveSpinner.stop(`Resolved ${parsed.slug}@${version}`);
+  let version;
+  try {
+    if (resolveSpinner) {
+      // eslint-disable-next-line no-console
+      console.log(`\n${renderGradientBanner()}\n`);
+      ui.intro(ui.pc.bgCyan(ui.pc.black(" ht-skills ")));
+      resolveSpinner.start(`Resolving ${parsed.slug}`);
+    }
+    version = await fetchResolvedVersion(registry, parsed, requestJsonImpl);
+    if (resolveSpinner) {
+      resolveSpinner.stop(`Resolved ${parsed.slug}@${version}`);
+    }
+  } catch (error) {
+    const friendlyMessage = formatInstallError(error, {
+      slug: parsed.slug,
+      registry,
+      stage: "resolve",
+    });
+    if (resolveSpinner) {
+      resolveSpinner.stop(ui.pc.red(`Unable to resolve ${parsed.slug}`));
+      ui.outro(ui.pc.red(friendlyMessage));
+      error.reported = true;
+    }
+    error.message = friendlyMessage;
+    throw error;
   }
 
   let toolIds = normalizeToolIds(flags.tool);
@@ -467,7 +511,15 @@ async function cmdInstall(flags, deps = {}) {
     metadata = await requestJsonImpl(
       `${registry}/api/skills/${encodeURIComponent(parsed.slug)}/${encodeURIComponent(version)}`,
     );
-  } catch {
+  } catch (error) {
+    if (Number(error?.status || 0) !== 404 && String(error?.message || "").toLowerCase() !== "not found") {
+      throw new Error(formatInstallError(error, {
+        slug: parsed.slug,
+        version,
+        registry,
+        stage: "metadata",
+      }));
+    }
     metadata = null;
   }
 
@@ -540,7 +592,16 @@ async function cmdInstall(flags, deps = {}) {
   }
   const bundle = await requestJsonImpl(
     `${registry}/api/skills/${encodeURIComponent(parsed.slug)}/${encodeURIComponent(version)}/bundle`,
-  );
+  ).catch((error) => {
+    const friendlyError = new Error(formatInstallError(error, {
+      slug: parsed.slug,
+      version,
+      registry,
+      stage: "bundle",
+    }));
+    friendlyError.status = error?.status;
+    throw friendlyError;
+  });
   if (bundleSpinner) {
     bundleSpinner.stop(`Downloaded ${parsed.slug}@${version}`);
   }
@@ -644,6 +705,26 @@ async function cmdSubmit(flags, deps = {}) {
   log(JSON.stringify(result, null, 2));
 }
 
+async function cmdAdd(flags, deps = {}) {
+  const source = String(flags._[0] || "").trim();
+  const skill = String(flags.skill || "").trim();
+
+  if (!source) {
+    throw new Error("add requires a registry URL, for example ht-skills add http://localhost:8787 --skill hello-skill");
+  }
+  if (!skill) {
+    throw new Error("add requires --skill <slug> or --skill <slug@version>");
+  }
+
+  const installFlags = {
+    ...flags,
+    _: [skill],
+    registry: source,
+  };
+
+  return cmdInstall(installFlags, deps);
+}
+
 async function main(argv = process.argv) {
   const [, , command, ...rest] = argv;
   const flags = parseArgs(rest);
@@ -660,6 +741,10 @@ async function main(argv = process.argv) {
     await cmdInstall(flags);
     return;
   }
+  if (command === "add") {
+    await cmdAdd(flags);
+    return;
+  }
   if (command === "submit") {
     await cmdSubmit(flags);
     return;
@@ -678,6 +763,7 @@ module.exports = {
   resolveInstallTargets,
   fetchResolvedVersion,
   cmdInstall,
+  cmdAdd,
   cmdSearch,
   cmdSubmit,
   main,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ht-skills",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "CLI for installing and submitting skills from HT Skills Marketplace.",
   "type": "commonjs",
   "bin": {