skillhub 0.2.0 → 0.2.1

package/dist/index.js

@@ -21,7 +21,7 @@ import fs from "fs-extra";
 import * as path from "path";
 import chalk from "chalk";
 import ora from "ora";
-import { parseSkillMd } from "skillhub-core";
+import { parseSkillMd, parseGenericInstructionFile, INSTRUCTION_FILE_PATTERNS as INSTRUCTION_FILE_PATTERNS2 } from "skillhub-core";
 
 // src/utils/api.ts
 import https from "https";
@@ -156,6 +156,7 @@ async function getSkillFiles(id) {
 
 // src/utils/github.ts
 import { Octokit } from "@octokit/rest";
+import { INSTRUCTION_FILE_PATTERNS } from "skillhub-core";
 import https2 from "https";
 var octokit = null;
 function getOctokit() {
@@ -193,17 +194,34 @@ async function fetchRawFile(owner, repo, path3, branch) {
     });
   });
 }
-async function fetchSkillContent(owner, repo, skillPath, branch = "main") {
+function getInstructionFilename(sourceFormat) {
+  const pattern = INSTRUCTION_FILE_PATTERNS.find((p) => p.format === sourceFormat);
+  return pattern?.filename || "SKILL.md";
+}
+async function fetchSkillContent(owner, repo, skillPath, branch = "main", sourceFormat = "skill.md") {
   const client = getOctokit();
-  const skillMdPath = skillPath ? `${skillPath}/SKILL.md` : "SKILL.md";
+  const filename = getInstructionFilename(sourceFormat);
+  const isStandalone = sourceFormat !== "skill.md";
+  const basePath = skillPath ? `${skillPath}/${filename}` : filename;
   let skillMdResponse;
-  const pathsToTry = [
-    skillMdPath,
-    // Common skill directories
-    ...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`] : []
-  ];
+  let pathsToTry;
+  if (sourceFormat === "cursorrules" || sourceFormat === "windsurfrules") {
+    pathsToTry = [filename];
+  } else if (sourceFormat === "copilot-instructions") {
+    pathsToTry = [`.github/${filename}`];
+  } else if (sourceFormat === "agents.md") {
+    pathsToTry = [basePath];
+    if (skillPath) {
+      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`] : []
+    ];
+  }
   for (const pathToTry of pathsToTry) {
     try {
       skillMdResponse = await client.repos.getContent({
@@ -235,12 +253,20 @@ async function fetchSkillContent(owner, repo, skillPath, branch = "main") {
     }
   }
   if (!skillMdResponse) {
-    throw new Error(`SKILL.md not found at ${owner}/${repo} (tried ${pathsToTry.length} paths)`);
+    throw new Error(`${filename} not found at ${owner}/${repo} (tried ${pathsToTry.length} paths)`);
   }
   if (!("content" in skillMdResponse.data)) {
-    throw new Error("SKILL.md not found");
+    throw new Error(`${filename} not found`);
   }
   const skillMd = Buffer.from(skillMdResponse.data.content, "base64").toString("utf-8");
+  if (isStandalone) {
+    return {
+      skillMd,
+      scripts: [],
+      references: [],
+      assets: []
+    };
+  }
   const scripts = [];
   try {
     const scriptsPath = skillPath ? `${skillPath}/scripts` : "scripts";
@@ -444,10 +470,12 @@ async function install(skillId, options) {
     }
     let skillName;
     let branch = "main";
+    let sourceFormat = "skill.md";
     if (skillInfo) {
       skillName = skillInfo.name;
       skillPath = skillInfo.skillPath;
       branch = skillInfo.branch || "main";
+      sourceFormat = skillInfo.sourceFormat || "skill.md";
       spinner.text = `Found skill: ${chalk.cyan(skillName)}`;
     } else {
       spinner.text = "Skill not in registry, fetching from GitHub...";
@@ -476,7 +504,10 @@ async function install(skillId, options) {
         spinner.text = "Downloading skill files...";
         const cachedFiles = await getSkillFiles(skillInfo.id);
         if (cachedFiles && cachedFiles.files.length > 0) {
-          content = convertCachedFilesToSkillContent(cachedFiles);
+          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`;
         }
       } catch {
@@ -490,7 +521,7 @@ async function install(skillId, options) {
         spinner.text = `Downloading from GitHub: ${owner}/${repo}/${skillPath || ""}...`;
       }
       try {
-        content = await fetchSkillContent(owner, repo, skillPath, branch);
+        content = await fetchSkillContent(owner, repo, skillPath, branch, sourceFormat);
         spinner.text = `Downloaded ${content.scripts.length} scripts, ${content.references.length} references`;
       } catch (error) {
         spinner.fail("Failed to download skill files");
@@ -512,7 +543,11 @@ async function install(skillId, options) {
       spinner.fail("Failed to download skill content");
       process.exit(1);
     }
-    const parsed = parseSkillMd(content.skillMd);
+    const parsed = sourceFormat === "skill.md" ? parseSkillMd(content.skillMd) : parseGenericInstructionFile(content.skillMd, sourceFormat, {
+      name: skillName,
+      description: skillInfo?.description || null,
+      owner
+    });
     if (!parsed.validation.isValid) {
       spinner.warn("Skill has validation issues:");
       for (const error of parsed.validation.errors) {
@@ -650,13 +685,16 @@ function getPlatformSetupInstructions(platform, installPath) {
       return null;
   }
 }
-function convertCachedFilesToSkillContent(response) {
+var MAIN_FILE_NAMES = INSTRUCTION_FILE_PATTERNS2.map((p) => p.filename);
+function convertCachedFilesToSkillContent(response, sourceFormat = "skill.md") {
   let skillMd = "";
   const scripts = [];
   const references = [];
+  const expectedPattern = INSTRUCTION_FILE_PATTERNS2.find((p) => p.format === sourceFormat);
+  const expectedFilename = expectedPattern?.filename || "SKILL.md";
   for (const file of response.files) {
     if (!file.content) continue;
-    if (file.name === "SKILL.md" && (file.path === "SKILL.md" || file.path === file.name)) {
+    if (!skillMd && (file.name === expectedFilename || MAIN_FILE_NAMES.includes(file.name)) && file.path === file.name) {
       skillMd = file.content;
       continue;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillhub",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI tool for managing AI Agent skills - search, install, and update skills for Claude, Codex, Copilot, and more",
   "author": "SkillHub Contributors",
   "license": "MIT",