skillhub 0.1.12 → 0.1.13

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SkillHub Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -26,11 +26,13 @@ import https from "https";
 import http from "http";
 var API_BASE_URL = process.env.SKILLHUB_API_URL || "https://skills.palebluedot.live/api";
 var API_TIMEOUT = parseInt(process.env.SKILLHUB_API_TIMEOUT || "10000");
+var API_FILES_TIMEOUT = parseInt(process.env.SKILLHUB_API_FILES_TIMEOUT || "45000");
 function httpsRequest(url, options = {}) {
   return new Promise((resolve, reject) => {
     const parsedUrl = new URL(url);
     const isHttps = parsedUrl.protocol === "https:";
     const lib = isHttps ? https : http;
+    const requestTimeout = options.timeout || API_TIMEOUT;
     const reqOptions = {
       hostname: parsedUrl.hostname,
       port: parsedUrl.port || (isHttps ? 443 : 80),
@@ -41,7 +43,7 @@ function httpsRequest(url, options = {}) {
         "Accept": "application/json",
         ...options.headers
       },
-      timeout: API_TIMEOUT
+      timeout: requestTimeout
     };
     const req = lib.request(reqOptions, (res) => {
       const chunks = [];
@@ -74,10 +76,10 @@ function httpsRequest(url, options = {}) {
           });
         }
       });
-      res.setTimeout(API_TIMEOUT, () => {
+      res.setTimeout(requestTimeout, () => {
         if (!resolved) {
           res.destroy();
-          reject(new Error(`Response timeout after ${API_TIMEOUT / 1e3}s`));
+          reject(new Error(`Response timeout after ${requestTimeout / 1e3}s`));
         }
       });
     });
@@ -87,7 +89,7 @@ function httpsRequest(url, options = {}) {
     });
     req.on("timeout", () => {
       req.destroy();
-      reject(new Error(`Request timeout after ${API_TIMEOUT / 1e3}s`));
+      reject(new Error(`Request timeout after ${requestTimeout / 1e3}s`));
     });
     if (options.body) {
       req.write(options.body);
@@ -131,6 +133,23 @@ async function trackInstall(skillId, platform, method = "cli") {
   } catch {
   }
 }
+async function getSkillFiles(id) {
+  try {
+    const response = await httpsRequest(
+      `${API_BASE_URL}/skill-files?id=${encodeURIComponent(id)}`,
+      { timeout: API_FILES_TIMEOUT }
+    );
+    if (response.statusCode === 404) {
+      return null;
+    }
+    if (response.statusCode !== 200) {
+      return null;
+    }
+    return JSON.parse(response.data);
+  } catch {
+    return null;
+  }
+}
 
 // src/utils/github.ts
 import { Octokit } from "@octokit/rest";
@@ -343,20 +362,49 @@ async function install(skillId, options) {
       process.exit(1);
     }
     await ensureSkillsDir(options.platform, options.project);
-    spinner.text = `Downloading from ${owner}/${repo}/${skillPath || ""}...`;
+    spinner.text = `Downloading ${skillInfo?.name || skillId}...`;
     let content;
-    try {
-      content = await fetchSkillContent(owner, repo, skillPath, branch);
-      spinner.text = `Downloaded ${content.scripts.length} scripts, ${content.references.length} references`;
-    } catch (error) {
-      spinner.fail("Failed to download skill files");
-      console.error(chalk.red(error.message));
-      console.log();
-      console.log(chalk.yellow("Troubleshooting tips:"));
-      console.log(chalk.dim("  1. Check your internet connection"));
-      console.log(chalk.dim("  2. If behind a proxy, configure HTTP_PROXY/HTTPS_PROXY environment variables"));
-      console.log(chalk.dim("  3. Try again in a few minutes (GitHub API might be rate-limited)"));
-      console.log(chalk.dim("  4. Set GITHUB_TOKEN environment variable for higher rate limits"));
+    let apiWasReachable = false;
+    if (!options.noApi && skillInfo) {
+      apiWasReachable = true;
+      try {
+        spinner.text = "Downloading skill files...";
+        const cachedFiles = await getSkillFiles(skillInfo.id);
+        if (cachedFiles && cachedFiles.files.length > 0) {
+          content = convertCachedFilesToSkillContent(cachedFiles);
+          spinner.text = cachedFiles.fromCache ? `Using cached files (${cachedFiles.files.length} files)` : `Downloaded ${cachedFiles.files.length} files via API`;
+        }
+      } catch {
+        spinner.text = "API file fetch failed, falling back to GitHub...";
+      }
+    }
+    if (!content) {
+      if (apiWasReachable) {
+        spinner.text = `Falling back to GitHub: ${owner}/${repo}/${skillPath || ""}...`;
+      } else {
+        spinner.text = `Downloading from GitHub: ${owner}/${repo}/${skillPath || ""}...`;
+      }
+      try {
+        content = await fetchSkillContent(owner, repo, skillPath, branch);
+        spinner.text = `Downloaded ${content.scripts.length} scripts, ${content.references.length} references`;
+      } catch (error) {
+        spinner.fail("Failed to download skill files");
+        console.error(chalk.red(error.message));
+        console.log();
+        console.log(chalk.yellow("Troubleshooting tips:"));
+        console.log(chalk.dim("  1. Check your internet connection"));
+        if (apiWasReachable) {
+          console.log(chalk.dim("  2. The API server could not fetch files either - try again in a minute"));
+          console.log(chalk.dim("  3. The server may be caching the files now - retry shortly"));
+        } else {
+          console.log(chalk.dim("  2. If behind a proxy, configure HTTP_PROXY/HTTPS_PROXY environment variables"));
+        }
+        console.log(chalk.dim(`  ${apiWasReachable ? "4" : "3"}. Set GITHUB_TOKEN environment variable for higher rate limits`));
+        process.exit(1);
+      }
+    }
+    if (!content) {
+      spinner.fail("Failed to download skill content");
       process.exit(1);
     }
     const parsed = parseSkillMd(content.skillMd);
@@ -453,6 +501,37 @@ function getPlatformName(platform) {
   };
   return names[platform];
 }
+function convertCachedFilesToSkillContent(response) {
+  let skillMd = "";
+  const scripts = [];
+  const references = [];
+  for (const file of response.files) {
+    if (!file.content) continue;
+    if (file.name === "SKILL.md" && (file.path === "SKILL.md" || file.path === file.name)) {
+      skillMd = file.content;
+      continue;
+    }
+    if (file.path.startsWith("scripts/")) {
+      scripts.push({
+        name: file.name,
+        content: file.content
+      });
+      continue;
+    }
+    if (file.path.startsWith("references/")) {
+      references.push({
+        name: file.name,
+        content: file.content
+      });
+    }
+  }
+  return {
+    skillMd,
+    scripts,
+    references,
+    assets: []
+  };
+}
 
 // src/commands/search.ts
 import chalk2 from "chalk";

package/package.json

@@ -1,59 +1,59 @@
-{
-  "name": "skillhub",
-  "version": "0.1.12",
-  "description": "CLI tool for managing AI Agent skills - search, install, and update skills for Claude, Codex, Copilot, and more",
-  "author": "SkillHub Contributors",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/anthropics/skillhub.git",
-    "directory": "apps/cli"
-  },
-  "homepage": "https://skills.palebluedot.live",
-  "type": "module",
-  "bin": {
-    "skillhub": "./dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --target node20 --clean",
-    "dev": "tsx src/index.ts",
-    "start": "node dist/index.js",
-    "lint": "eslint src/",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest",
-    "test:run": "vitest run"
-  },
-  "dependencies": {
-    "skillhub-core": "^0.1.0",
-    "@octokit/rest": "^20.0.2",
-    "chalk": "^5.3.0",
-    "commander": "^11.1.0",
-    "fs-extra": "^11.2.0",
-    "ora": "^8.0.1",
-    "prompts": "^2.4.2"
-  },
-  "devDependencies": {
-    "@types/fs-extra": "^11.0.4",
-    "@types/node": "^20.10.0",
-    "@types/prompts": "^2.4.9",
-    "tsup": "^8.0.1",
-    "tsx": "^4.7.0",
-    "typescript": "^5.3.0",
-    "vitest": "^1.2.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "keywords": [
-    "ai",
-    "agent",
-    "skills",
-    "cli",
-    "claude",
-    "codex",
-    "copilot"
-  ]
-}
+{
+  "name": "skillhub",
+  "version": "0.1.13",
+  "description": "CLI tool for managing AI Agent skills - search, install, and update skills for Claude, Codex, Copilot, and more",
+  "author": "SkillHub Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropics/skillhub.git",
+    "directory": "apps/cli"
+  },
+  "homepage": "https://skills.palebluedot.live",
+  "type": "module",
+  "bin": {
+    "skillhub": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "skillhub-core": "^0.1.0",
+    "@octokit/rest": "^20.0.2",
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "fs-extra": "^11.2.0",
+    "ora": "^8.0.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.10.0",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.0.1",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "skills",
+    "cli",
+    "claude",
+    "codex",
+    "copilot"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --target node20 --clean",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run"
+  }
+}