skillhub 0.1.3 → 0.1.5

package/dist/index.js

@@ -111,7 +111,8 @@ async function searchSkills(query, options = {}) {
   return JSON.parse(response.data);
 }
 async function getSkill(id) {
-  const response = await httpsRequest(`${API_BASE_URL}/skills/${encodeURIComponent(id)}`);
+  const encodedPath = id.split("/").map(encodeURIComponent).join("/");
+  const response = await httpsRequest(`${API_BASE_URL}/skills/${encodedPath}`);
   if (response.statusCode === 404) {
     return null;
   }
@@ -122,7 +123,8 @@ async function getSkill(id) {
 }
 async function trackInstall(skillId, platform, method = "cli") {
   try {
-    await httpsRequest(`${API_BASE_URL}/skills/${encodeURIComponent(skillId)}/install`, {
+    const encodedPath = skillId.split("/").map(encodeURIComponent).join("/");
+    await httpsRequest(`${API_BASE_URL}/skills/${encodedPath}/install`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ platform, method })
@@ -138,7 +140,11 @@ function getOctokit() {
   if (!octokit) {
     octokit = new Octokit({
       auth: process.env.GITHUB_TOKEN,
-      userAgent: "SkillHub-CLI/1.0"
+      userAgent: "SkillHub-CLI/1.0",
+      request: {
+        timeout: 3e4
+        // 30 second timeout
+      }
     });
   }
   return octokit;
@@ -146,12 +152,23 @@ function getOctokit() {
 async function fetchSkillContent(owner, repo, skillPath, branch = "main") {
   const client = getOctokit();
   const skillMdPath = skillPath ? `${skillPath}/SKILL.md` : "SKILL.md";
-  const skillMdResponse = await client.repos.getContent({
-    owner,
-    repo,
-    path: skillMdPath,
-    ref: branch
-  });
+  let skillMdResponse;
+  try {
+    skillMdResponse = await client.repos.getContent({
+      owner,
+      repo,
+      path: skillMdPath,
+      ref: branch
+    });
+  } catch (error) {
+    if (error.status === 404) {
+      throw new Error(`SKILL.md not found at ${owner}/${repo}/${skillMdPath}`);
+    }
+    if (error.message?.includes("timeout")) {
+      throw new Error(`GitHub request timeout. Check your internet connection or try again later.`);
+    }
+    throw new Error(`Failed to fetch from GitHub: ${error.message}`);
+  }
   if (!("content" in skillMdResponse.data)) {
     throw new Error("SKILL.md not found");
   }
@@ -239,7 +256,13 @@ async function install(skillId, options) {
     }
     const [owner, repo, ...rest] = parts;
     const skillPath = rest.join("/");
-    const skillInfo = await getSkill(skillId);
+    let skillInfo;
+    try {
+      skillInfo = await getSkill(skillId);
+    } catch (error) {
+      spinner.warn(`API error: ${error.message}`);
+      spinner.start("Falling back to direct GitHub fetch...");
+    }
     let skillName;
     let branch = "main";
     if (skillInfo) {
@@ -247,8 +270,13 @@ async function install(skillId, options) {
       spinner.text = `Found skill: ${chalk.cyan(skillName)}`;
     } else {
       spinner.text = "Skill not in registry, fetching from GitHub...";
-      branch = await getDefaultBranch(owner, repo);
-      skillName = skillPath || repo;
+      try {
+        branch = await getDefaultBranch(owner, repo);
+        skillName = skillPath || repo;
+      } catch (error) {
+        spinner.fail("Failed to connect to GitHub");
+        throw error;
+      }
     }
     const installed = await isSkillInstalled(options.platform, skillName, options.project);
     if (installed && !options.force) {
@@ -258,8 +286,22 @@ async function install(skillId, options) {
       process.exit(1);
     }
     await ensureSkillsDir(options.platform, options.project);
-    spinner.text = "Downloading skill files...";
-    const content = await fetchSkillContent(owner, repo, skillPath, branch);
+    spinner.text = `Downloading from ${owner}/${repo}/${skillPath || ""}...`;
+    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"));
+      process.exit(1);
+    }
     const parsed = parseSkillMd(content.skillMd);
     if (!parsed.validation.isValid) {
       spinner.warn("Skill has validation issues:");
@@ -357,7 +399,7 @@ async function search(query, options) {
       const verified = skill.isVerified ? chalk2.green("\u2713") : " ";
       const security = getSecurityBadge(skill.securityScore);
       console.log(
-        `${verified} ${chalk2.cyan(skill.name.padEnd(25))} ${security}  \u2B50 ${formatNumber(skill.githubStars).padStart(6)}  \u2B07 ${formatNumber(skill.downloadCount).padStart(6)}`
+        `${verified} ${chalk2.cyan(skill.id.padEnd(40))} ${security}  \u2B50 ${formatNumber(skill.githubStars).padStart(6)}  \u2B07 ${formatNumber(skill.downloadCount).padStart(6)}`
       );
       console.log(
         `  ${chalk2.dim(skill.description.slice(0, 70))}${skill.description.length > 70 ? "..." : ""}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillhub",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "CLI tool for managing AI Agent skills - search, install, and update skills for Claude, Codex, Copilot, and more",
   "author": "SkillHub Contributors",
   "license": "MIT",
@@ -14,7 +14,9 @@
   "bin": {
     "skillhub": "./dist/index.js"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup src/index.ts --format esm --target node20 --clean",
     "dev": "tsx src/index.ts",
@@ -45,5 +47,13 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "keywords": ["ai", "agent", "skills", "cli", "claude", "codex", "copilot"]
+  "keywords": [
+    "ai",
+    "agent",
+    "skills",
+    "cli",
+    "claude",
+    "codex",
+    "copilot"
+  ]
 }