skillhub 0.2.4 → 0.2.6

package/dist/index.js

@@ -3516,6 +3516,12 @@ var VALID_PLATFORMS = ["claude", "codex", "copilot", "cursor", "windsurf"];
 var NAME_PATTERN = /^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/;
 var MAX_DESCRIPTION_LENGTH = 1024;
 var MAX_NAME_LENGTH = 64;
+function sanitizeUtf8(input) {
+  let result = input.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, "");
+  result = Buffer.from(result, "utf8").toString("utf8");
+  result = result.replace(/[\uD800-\uDFFF]/g, "");
+  return result;
+}
 var INSTRUCTION_FILE_PATTERNS = [
   {
     format: "skill.md",
@@ -3600,8 +3606,8 @@ function parseSkillMd(content) {
     validateTriggers(frontmatter.triggers, warnings);
   }
   const metadata = {
-    name: String(frontmatter.name || ""),
-    description: String(frontmatter.description || ""),
+    name: sanitizeUtf8(String(frontmatter.name || "")),
+    description: sanitizeUtf8(String(frontmatter.description || "")),
     version: frontmatter.version ? String(frontmatter.version) : void 0,
     license: frontmatter.license ? String(frontmatter.license) : void 0,
     author: frontmatter.author ? String(frontmatter.author) : void 0,
@@ -3784,8 +3790,8 @@ function parseGenericInstructionFile(content, format, repoMeta) {
   const derivedDescription = frontmatter.description || repoMeta.description || extractFirstParagraph(body) || `${FORMAT_LABELS[format]} from ${repoMeta.owner}/${repoMeta.name}`;
   const inferredPlatform = pattern?.inferredPlatform || "claude";
   const metadata = {
-    name: derivedName,
-    description: derivedDescription.slice(0, MAX_DESCRIPTION_LENGTH),
+    name: sanitizeUtf8(derivedName),
+    description: sanitizeUtf8(derivedDescription.slice(0, MAX_DESCRIPTION_LENGTH)),
     version: frontmatter.version ? String(frontmatter.version) : void 0,
     license: frontmatter.license ? String(frontmatter.license) : void 0,
     author: frontmatter.author ? String(frontmatter.author) : repoMeta.owner,
@@ -3828,6 +3834,21 @@ function extractFirstParagraph(content) {
   }
   return null;
 }
+var TAG_KEYS = [
+  "RATIONALE",
+  "USE-CASES",
+  "AUDIENCE",
+  "COMPLEMENTS",
+  "SEO-EN",
+  "BUNDLE-FIT",
+  "FRAMEWORK-LOCK",
+  "CONTRIBUTING-REPO",
+  "MATURITY",
+  "COMPLEXITY",
+  "DEPENDENCIES",
+  "PLATFORM"
+];
+var TAG_REGEX = new RegExp(`(${TAG_KEYS.join("|")}):\\s*`, "g");
 
 // src/utils/api.ts
 import https from "https";
@@ -4020,12 +4041,20 @@ async function fetchSkillContent(owner, repo, skillPath, branch = "main", source
       pathsToTry.push(filename);
     }
   } else {
-    pathsToTry = [
-      basePath,
-      ...skillPath && !skillPath.startsWith("skills/") ? [`skills/${skillPath}/SKILL.md`] : [],
-      ...skillPath && !skillPath.startsWith(".claude/") ? [`.claude/skills/${skillPath}/SKILL.md`] : [],
-      ...skillPath && !skillPath.startsWith(".github/") ? [`.github/skills/${skillPath}/SKILL.md`] : []
-    ];
+    const skillName = skillPath ? skillPath.replace(/^(skills|\.claude\/skills|\.github\/skills)\//, "") : "";
+    pathsToTry = [basePath];
+    if (skillName) {
+      const candidates = [
+        `skills/${skillName}/${filename}`,
+        `.claude/skills/${skillName}/${filename}`,
+        `.github/skills/${skillName}/${filename}`
+      ];
+      for (const candidate of candidates) {
+        if (candidate !== basePath) {
+          pathsToTry.push(candidate);
+        }
+      }
+    }
   }
   for (const pathToTry of pathsToTry) {
     try {
@@ -4047,18 +4076,45 @@ async function fetchSkillContent(owner, repo, skillPath, branch = "main", source
             }
           };
           break;
-        } catch (rawError) {
-          throw new Error(`GitHub API timeout. Try using --no-api flag or check your network connection.`);
+        } catch {
+          continue;
         }
       }
       if (error.status === 404) {
         continue;
       }
+      if (error.status === 403) {
+        throw new Error(
+          `GitHub API rate limit exceeded. Set GITHUB_TOKEN environment variable for higher rate limits.`
+        );
+      }
       throw new Error(`Failed to fetch from GitHub: ${error.message}`);
     }
   }
   if (!skillMdResponse) {
-    throw new Error(`${filename} not found at ${owner}/${repo} (tried ${pathsToTry.length} paths)`);
+    for (const pathToTry of pathsToTry) {
+      try {
+        const rawContent = await fetchRawFile(owner, repo, pathToTry, branch);
+        skillMdResponse = {
+          data: {
+            content: Buffer.from(rawContent).toString("base64"),
+            encoding: "base64"
+          }
+        };
+        break;
+      } catch {
+        continue;
+      }
+    }
+  }
+  if (!skillMdResponse) {
+    const triedPaths = pathsToTry.map((p) => `  - ${owner}/${repo}/${p}`).join("\n");
+    throw new Error(
+      `${filename} not found at ${owner}/${repo} (tried ${pathsToTry.length} paths):
+${triedPaths}
+
+The skill may have been moved or deleted from the repository.`
+    );
   }
   if (!("content" in skillMdResponse.data)) {
     throw new Error(`${filename} not found`);
@@ -4263,7 +4319,8 @@ async function install(skillId, options2) {
       try {
         skillInfo = await getSkill(skillId);
         if (skillInfo) {
-          spinner.succeed(`Found in registry: ${skillInfo.name}`);
+          const reviewBadge = skillInfo.aiScore && skillInfo.reviewStatus === "ai-reviewed" ? chalk.dim(` | AI: ${skillInfo.aiScore}/100`) : skillInfo.reviewStatus === "verified" ? chalk.green(` | AI: ${skillInfo.aiScore}/100 \u2713`) : "";
+          spinner.succeed(`Found in registry: ${skillInfo.name}${reviewBadge}`);
           spinner.start("Preparing installation...");
         }
       } catch (error) {
@@ -4309,11 +4366,22 @@ async function install(skillId, options2) {
         spinner.text = "Downloading skill files...";
         const cachedFiles = await getSkillFiles(skillInfo.id);
         if (cachedFiles && cachedFiles.files.length > 0) {
+          if (cachedFiles.isStale) {
+            spinner.warn(chalk.yellow(
+              "This skill may have been removed from its GitHub repository.\n  Files were served from the SkillHub cache and may be outdated."
+            ));
+            spinner.start("Installing from cached files...");
+          }
           if (cachedFiles.sourceFormat) {
             sourceFormat = cachedFiles.sourceFormat;
           }
-          content = convertCachedFilesToSkillContent(cachedFiles, sourceFormat);
-          spinner.text = cachedFiles.fromCache ? `Using cached files (${cachedFiles.files.length} files)` : `Downloaded ${cachedFiles.files.length} files via API`;
+          const converted = convertCachedFilesToSkillContent(cachedFiles, sourceFormat);
+          if (converted.skillMd) {
+            content = converted;
+            spinner.text = cachedFiles.fromCache ? `Using cached files (${cachedFiles.files.length} files)` : `Downloaded ${cachedFiles.files.length} files via API`;
+          } else {
+            spinner.text = "API returned files but main instruction file missing, falling back...";
+          }
         }
       } catch {
         spinner.text = "API file fetch failed, falling back to GitHub...";
@@ -4570,6 +4638,12 @@ async function search(query, options2) {
           `     ${chalk2.yellow("\u2605")} ${skill.rating.toFixed(1)} ${chalk2.dim(`(${skill.ratingCount} ratings)`)}`
         );
       }
+      if (skill.aiScore && skill.reviewStatus && skill.reviewStatus !== "unreviewed" && skill.reviewStatus !== "auto-scored") {
+        const scoreColor = skill.aiScore >= 75 ? chalk2.green : skill.aiScore >= 50 ? chalk2.yellow : chalk2.dim;
+        console.log(
+          `     ${chalk2.magenta("AI")} ${scoreColor(String(skill.aiScore))} ${chalk2.dim(`(${skill.reviewStatus})`)}`
+        );
+      }
       console.log(chalk2.dim("\u2500".repeat(80)));
     }
     console.log();

package/package.json

@@ -1,61 +1,61 @@
-{
-  "name": "skillhub",
-  "version": "0.2.4",
-  "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/airano-ir/skillhub.git",
-    "directory": "apps/cli"
-  },
-  "homepage": "https://skills.palebluedot.live",
-  "type": "module",
-  "bin": {
-    "skillhub": "./dist/index.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "dependencies": {
-    "@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",
-    "skillhub-core": "0.1.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "keywords": [
-    "ai",
-    "agent",
-    "skills",
-    "cli",
-    "claude",
-    "codex",
-    "copilot",
-    "cursor",
-    "windsurf"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsx src/index.ts",
-    "start": "node dist/index.js",
-    "lint": "eslint src/",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest",
-    "test:run": "vitest run"
-  }
-}
+{
+  "name": "skillhub",
+  "version": "0.2.6",
+  "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/airano-ir/skillhub.git",
+    "directory": "apps/cli"
+  },
+  "homepage": "https://skills.palebluedot.live",
+  "type": "module",
+  "bin": {
+    "skillhub": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "dependencies": {
+    "@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": {
+    "skillhub-core": "workspace:*",
+    "@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",
+    "cursor",
+    "windsurf"
+  ]
+}

package/LICENSE

@@ -1,21 +0,0 @@
-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.