skillhub 0.1.13 → 0.1.15

package/dist/index.js

@@ -25,7 +25,7 @@ import { parseSkillMd } from "skillhub-core";
 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_TIMEOUT = parseInt(process.env.SKILLHUB_API_TIMEOUT || "20000");
 var API_FILES_TIMEOUT = parseInt(process.env.SKILLHUB_API_FILES_TIMEOUT || "45000");
 function httpsRequest(url, options = {}) {
   return new Promise((resolve, reject) => {
@@ -101,7 +101,8 @@ async function searchSkills(query, options = {}) {
   const params = new URLSearchParams({
     q: query,
     limit: String(options.limit || 10),
-    page: String(options.page || 1)
+    page: String(options.page || 1),
+    sort: options.sort || "downloads"
   });
   if (options.platform) {
     params.set("platform", options.platform);
@@ -481,6 +482,12 @@ A different skill is already installed with the name "${actualName}":`));
     console.log(
       `  This skill will be automatically activated when your ${getPlatformName(options.platform)} agent recognizes it's relevant.`
     );
+    const setupInstructions = getPlatformSetupInstructions(options.platform, installPath);
+    if (setupInstructions) {
+      console.log();
+      console.log(chalk.cyan("Next Steps:"));
+      console.log(setupInstructions);
+    }
     if (content.scripts.length > 0) {
       console.log();
       console.log(chalk.dim(`Scripts: ${content.scripts.map((s) => s.name).join(", ")}`));
@@ -501,6 +508,26 @@ function getPlatformName(platform) {
   };
   return names[platform];
 }
+function getPlatformSetupInstructions(platform, installPath) {
+  switch (platform) {
+    case "claude":
+      return chalk.dim("  Skills in ~/.claude/skills/ are automatically discovered by Claude Code.");
+    case "codex":
+      return chalk.dim(`  Reference this skill in your AGENTS.md:
+  @import ${installPath}/SKILL.md`);
+    case "copilot":
+      return chalk.dim(`  Reference this skill in .github/copilot-instructions.md:
+  @import ${installPath}/SKILL.md`);
+    case "cursor":
+      return chalk.dim(`  Reference this skill in your .cursorrules file:
+  @import ${installPath}/SKILL.md`);
+    case "windsurf":
+      return chalk.dim(`  Reference this skill in your Windsurf configuration:
+  Path: ${installPath}/SKILL.md`);
+    default:
+      return null;
+  }
+}
 function convertCachedFilesToSkillContent(response) {
   let skillMd = "";
   const scripts = [];
@@ -540,9 +567,13 @@ async function search(query, options) {
   const spinner = ora2("Searching skills...").start();
   try {
     const limit = parseInt(options.limit || "10");
+    const page = parseInt(options.page || "1");
+    const sort = options.sort || "downloads";
     const result = await searchSkills(query, {
       platform: options.platform,
-      limit
+      limit,
+      page,
+      sort
     });
     spinner.stop();
     if (result.skills.length === 0) {
@@ -550,35 +581,43 @@ async function search(query, options) {
       console.log(chalk2.dim("Try a different search term or check the spelling."));
       return;
     }
-    console.log(chalk2.bold(`Found ${result.pagination.total} skills:
+    const sortLabel = { downloads: "downloads", stars: "GitHub stars", rating: "rating", recent: "recently updated" }[sort] || sort;
+    console.log(chalk2.bold(`Found ${result.pagination.total} skills (sorted by ${sortLabel}):
 `));
     console.log(
       chalk2.dim("\u2500".repeat(80))
     );
-    for (const skill of result.skills) {
+    const startIndex = (page - 1) * limit;
+    for (let i = 0; i < result.skills.length; i++) {
+      const skill = result.skills[i];
+      const num = chalk2.dim(`[${startIndex + i + 1}]`);
       const verified = skill.isVerified ? chalk2.green("\u2713") : " ";
       const security = skill.securityStatus ? getSecurityStatusBadge(skill.securityStatus) : getSecurityBadge(skill.securityScore);
       console.log(
-        `${verified} ${chalk2.cyan(skill.id.padEnd(40))} ${security}  \u2B50 ${formatNumber(skill.githubStars).padStart(6)}  \u2B07 ${formatNumber(skill.downloadCount).padStart(6)}`
+        `${num} ${verified} ${chalk2.cyan(skill.id.padEnd(38))} ${security}`
       );
       console.log(
-        `  ${chalk2.dim(skill.description.slice(0, 70))}${skill.description.length > 70 ? "..." : ""}`
+        `     \u2B07 ${formatNumber(skill.downloadCount).padStart(6)}  \u2B50 ${formatNumber(skill.githubStars).padStart(6)}  ${chalk2.dim(skill.description.slice(0, 55))}${skill.description.length > 55 ? "..." : ""}`
       );
       const showRating = (skill.ratingCount ?? 0) >= 3;
       if (showRating && skill.rating) {
         console.log(
-          `  ${chalk2.yellow("\u2605")} ${skill.rating.toFixed(1)} ${chalk2.dim(`(${skill.ratingCount} ratings)`)}`
+          `     ${chalk2.yellow("\u2605")} ${skill.rating.toFixed(1)} ${chalk2.dim(`(${skill.ratingCount} ratings)`)}`
         );
       }
       console.log(chalk2.dim("\u2500".repeat(80)));
     }
     console.log();
     console.log(chalk2.dim(`Install with: ${chalk2.white("npx skillhub install <skill-id>")}`));
-    if (result.pagination.total > result.skills.length) {
+    const totalPages = result.pagination.totalPages;
+    if (totalPages > 1) {
       console.log(
-        chalk2.dim(`Showing ${result.skills.length} of ${result.pagination.total}. Use --limit to see more.`)
+        chalk2.dim(`Page ${page} of ${totalPages}. Use ${chalk2.white(`--page ${page + 1}`)} for next page.`)
       );
     }
+    if (sort === "downloads") {
+      console.log(chalk2.dim(`Sort options: ${chalk2.white("--sort stars|rating|recent")}`));
+    }
   } catch (error) {
     spinner.fail("Search failed");
     const err = error;
@@ -799,7 +838,7 @@ program.command("install <skill-id>").description("Install a skill from the regi
     // Commander converts --no-api to api: false
   });
 });
-program.command("search <query>").description("Search for skills in the registry").option("-p, --platform <platform>", "Filter by platform").option("-l, --limit <number>", "Number of results", "10").action(async (query, options) => {
+program.command("search <query>").description("Search for skills in the registry").option("-p, --platform <platform>", "Filter by platform").option("-s, --sort <sort>", "Sort by: downloads, stars, rating, recent", "downloads").option("-l, --limit <number>", "Number of results", "10").option("--page <number>", "Page number", "1").action(async (query, options) => {
   await search(query, options);
 });
 program.command("list").description("List installed skills").option("-p, --platform <platform>", "Filter by platform").option("--project", "List skills in the current project").option("--all", "List both global and project skills").action(async (options) => {

package/package.json

@@ -1,59 +1,61 @@
-{
-  "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"
-  }
-}
+{
+  "name": "skillhub",
+  "version": "0.1.15",
+  "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",
+    "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.