itismyskillmarket 1.3.2 → 1.3.4

package/CHANGELOG.md

@@ -1,3 +1,150 @@
+# SkillMarket v1.3.3 更新日志
+
+**日期**: 2026-04-30
+**版本**: 1.3.3
+
+---
+
+## 🚀 新功能：GitHub 第三方库支持 (Beta)
+
+### 1. 支持 GitHub URL 和简写格式
+
+现在可以直接从 GitHub 仓库安装 skills：
+
+```bash
+# GitHub URL 格式
+skm install https://github.com/owner/repo
+skm install https://github.com/owner/repo/tree/main/skills/my-skill
+
+# 简写格式
+skm install owner/repo
+skm install owner/repo#branch
+skm install owner/repo@commit-hash
+```
+
+### 2. 自动检测 Skill 本体
+
+安装时会自动检测仓库中的 skill 文件：
+
+- ✅ `SKILL.md` - skill 定义文件（必须）
+- ✅ `package.json` - 包配置文件（可选）
+- ✅ `metadata.json` - 元数据文件（可选）
+- ✅ 平台目录（`opencode/`, `cursor/`, `vscode/`, `claude/` 等）
+
+**检测输出示例**：
+```
+Detecting skill...
+  SKILL.md: ✅
+  package.json: ✅
+  Detected platforms: opencode, vscode
+```
+
+### 3. 平台判断和格式转换
+
+- 自动判断 skill 支持的平台
+- 如果某些平台文件缺失，会自动生成适配文件
+- 支持的平台：OpenCode, Cursor, VSCode, Claude Code, Codex, Antigravity
+
+```bash
+# 安装到指定平台（自动生成缺失的平台文件）
+skm install owner/repo --platform opencode,claude
+
+# 指定分支
+skm install owner/repo#dev --platform vscode
+```
+
+### 4. 版本控制
+
+支持指定分支、tag 或 commit：
+
+```bash
+# 指定分支
+skm install owner/repo#main
+skm install owner/repo -b develop
+
+# 指定 commit
+skm install owner/repo@abc1234
+
+# 指定 tag（通过分支名）
+skm install owner/repo#v1.0.0
+```
+
+### 5. 技术实现
+
+**新增模块**：`src/commands/github-install.ts`
+
+| 函数名 | 功能 |
+|--------|------|
+| `parseGitHubUrl()` | 解析 GitHub URL 和简写格式 |
+| `detectSkillFromGitHub()` | 从 GitHub API 检测 skill |
+| `installFromGitHub()` | 从 GitHub 安装 skill |
+| `generatePlatformAdapters()` | 为缺失平台生成适配文件 |
+
+**支持的 URL 格式**：
+| 格式 | 示例 |
+|------|------|
+| 完整 URL | `https://github.com/owner/repo` |
+| 完整 URL + 路径 | `https://github.com/owner/repo/tree/main/path` |
+| 简写 | `owner/repo` |
+| 简写 + 分支 | `owner/repo#branch` |
+| 简写 + commit | `owner/repo@commit` |
+
+---
+
+## 🔧 技术实现
+
+### GitHub 安装新增函数
+
+| 函数名 | 功能 |
+|--------|------|
+| `parseGitHubUrl()` | 解析 GitHub URL |
+| `detectSkillFromGitHub()` | 检测 skill 本体 |
+| `installFromGitHub()` | 主安装函数 |
+| `generatePlatformAdapters()` | 格式转换 |
+
+### 更新接口
+
+**GitHubInstallOptions** 接口：
+```typescript
+export interface GitHubInstallOptions {
+  platforms?: string[];  // 目标平台
+  force?: boolean;       // 强制覆盖
+  branch?: string;       // 指定分支
+  commit?: string;       // 指定 commit
+}
+```
+
+### CLI 参数更新
+
+| 命令 | 参数 | 说明 |
+|------|------|------|
+| `skm install` | `-b, --branch` | GitHub 分支 |
+| `skm install` | `-c, --commit` | GitHub commit hash |
+
+---
+
+## 📦 完整版本历史
+
+| 版本 | 日期 | 描述 |
+|------|------|------|
+| 1.3.3 | 2026-04-30 | GitHub 第三方库支持 |
+| 1.3.2 | 2026-04-30 | 增强卸载命令：--all, --dry-run, --yes |
+| 1.3.1 | 2026-04-29 | Bug 修复，workflow 改进 |
+| 1.3.0 | 2026-04-23 | 独立搜索命令，改进分页逻辑 |
+| 1.2.6 | 2026-04-22 | 添加搜索功能（--search） |
+| 1.2.5 | 2026-04-16 | 文档更新 |
+| 1.2.4 | 2026-04-16 | 修复版本号硬编码问题 |
+| 1.2.3 | 2026-04-15 | 跨平台 Skill 安装支持 |
+
+---
+
+## 贡献者
+
+- wxc2004 (wanxuchen)
+- Sisyphus Agent
+
+---
+
 # SkillMarket v1.3.2 更新日志
 
 **日期**: 2026-04-30
@@ -90,14 +237,6 @@ VSCode       ✅  Uninstalled
 ⚠️  1 platform(s) failed to uninstall. Continue with local cleanup? (y/N): _
 ```
 
-### 5. 更新帮助文档
-
-`skm --help` 现在包含卸载命令的完整说明：
-
-```bash
-skm uninstall --help
-```
-
 ---
 
 ## 🔧 技术实现

package/README.md

@@ -1,6 +1,6 @@
 # SkillMarket
 
-Cross-platform skill manager for AI coding tools (Cursor, VSCode, Codex, OpenCode, Claude Code, Antigravity).
+Cross-platform skill manager for AI coding tools (Cursor, VSCode, Codex, OpenCode, Claude Code, Antigravity, OpenClaw, Hermes Agent).
 
 ## Installation
 
@@ -104,6 +104,8 @@ $ skm platforms
 OpenCode     ✅  Available (2 skills installed)
 Claude Code  ✅  Available (1 skills installed)
 VSCode       ✅  Available (0 skills installed)
+OpenClaw     ✅  Available
+Hermes Agent ✅  Available
 ```
 
 ## Development

package/dist/index.js

@@ -35,8 +35,12 @@ var PLATFORMS = [
   // OpenCode - 开源 AI 编程工具
   "claude",
   // Claude Code - Anthropic CLI 工具
-  "antigravity"
+  "antigravity",
   // Antigravity - AI 编程助手
+  "openclaw",
+  // OpenClaw - AgentSkills compatible agent
+  "hermes"
+  // Hermes Agent - NousResearch agent framework
 ];
 var REGISTRY_FILE = "registry.json";
 var LATEST_LINK = "latest";
@@ -555,15 +559,128 @@ var VSCodeAdapter = class extends BaseAdapter {
   }
 };
 
+// src/adapters/openclaw.ts
+import { readdirSync, existsSync, cpSync, rmSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { ensureDirSync } from "fs-extra";
+var OpenClawAdapter = class {
+  id = "openclaw";
+  name = "OpenClaw";
+  skillDir = join(homedir(), ".openclaw", "skills");
+  async isAvailable() {
+    try {
+      return existsSync(join(homedir(), ".openclaw"));
+    } catch {
+      return false;
+    }
+  }
+  async isInstalled(skillId) {
+    try {
+      const skillPath = join(this.skillDir, skillId);
+      return existsSync(skillPath);
+    } catch {
+      return false;
+    }
+  }
+  async install(skillId, sourceDir) {
+    ensureDirSync(this.skillDir);
+    const targetDir = join(this.skillDir, skillId);
+    if (existsSync(targetDir)) {
+      rmSync(targetDir, { recursive: true, force: true });
+    }
+    cpSync(sourceDir, targetDir, { recursive: true });
+  }
+  async uninstall(skillId) {
+    const targetDir = join(this.skillDir, skillId);
+    if (existsSync(targetDir)) {
+      rmSync(targetDir, { recursive: true, force: true });
+    }
+  }
+  async listInstalled() {
+    try {
+      if (!existsSync(this.skillDir)) {
+        return [];
+      }
+      return readdirSync(this.skillDir).filter((name) => {
+        const fullPath = join(this.skillDir, name);
+        return existsSync(fullPath) && name !== ".";
+      });
+    } catch {
+      return [];
+    }
+  }
+};
+
+// src/adapters/hermes.ts
+import { readdirSync as readdirSync2, existsSync as existsSync2, cpSync as cpSync2, rmSync as rmSync2 } from "fs";
+import { join as join2 } from "path";
+import { homedir as homedir2 } from "os";
+import { ensureDirSync as ensureDirSync2 } from "fs-extra";
+var HermesAdapter = class {
+  id = "hermes";
+  name = "Hermes Agent";
+  skillDir = join2(homedir2(), ".hermes", "skills");
+  async isAvailable() {
+    try {
+      if (existsSync2(join2(homedir2(), ".hermes"))) {
+        return true;
+      }
+      return false;
+    } catch {
+      return false;
+    }
+  }
+  async isInstalled(skillId) {
+    try {
+      const skillPath = join2(this.skillDir, skillId);
+      return existsSync2(skillPath);
+    } catch {
+      return false;
+    }
+  }
+  async install(skillId, sourceDir) {
+    ensureDirSync2(this.skillDir);
+    const targetDir = join2(this.skillDir, skillId);
+    if (existsSync2(targetDir)) {
+      rmSync2(targetDir, { recursive: true, force: true });
+    }
+    cpSync2(sourceDir, targetDir, { recursive: true });
+  }
+  async uninstall(skillId) {
+    const targetDir = join2(this.skillDir, skillId);
+    if (existsSync2(targetDir)) {
+      rmSync2(targetDir, { recursive: true, force: true });
+    }
+  }
+  async listInstalled() {
+    try {
+      if (!existsSync2(this.skillDir)) {
+        return [];
+      }
+      return readdirSync2(this.skillDir).filter((name) => {
+        const fullPath = join2(this.skillDir, name);
+        return existsSync2(fullPath) && name !== ".";
+      });
+    } catch {
+      return [];
+    }
+  }
+};
+
 // src/adapters/registry.ts
 var adapters = /* @__PURE__ */ new Map();
 function registerAdapters() {
   const opencode = new OpenCodeAdapter();
   const claude = new ClaudeAdapter();
   const vscode = new VSCodeAdapter();
+  const openclaw = new OpenClawAdapter();
+  const hermes = new HermesAdapter();
   adapters.set(opencode.id, opencode);
   adapters.set(claude.id, claude);
   adapters.set(vscode.id, vscode);
+  adapters.set(openclaw.id, openclaw);
+  adapters.set(hermes.id, hermes);
 }
 registerAdapters();
 async function detectPlatforms() {
@@ -584,8 +701,10 @@ function getAdapterByPlatform(platform) {
     // Cursor uses OpenCode-compatible structure
     codex: "opencode",
     // Codex uses OpenCode-compatible structure
-    antigravity: "opencode"
+    antigravity: "opencode",
     // Antigravity uses OpenCode-compatible structure
+    openclaw: "openclaw",
+    hermes: "hermes"
   };
   return adapters.get(idMap[platform]);
 }
@@ -974,6 +1093,272 @@ Uninstalling all skills...
   return { success: successCount, failed: failedCount };
 }
 
+// src/commands/github-install.ts
+import fs10 from "fs-extra";
+import path9 from "path";
+var GITHUB_URL_PATTERNS = [
+  /^https?:\/\/github\.com\/([^/]+)\/([^/]+)(?:\/tree\/([^/]+)(?:\/(.+))?)?$/,
+  /^([^/]+)\/([^/]+)(?:#(.+))?$/,
+  // owner/repo#branch
+  /^([^/]+)\/([^/]+)@(.+)$/
+  // owner/repo@commit
+];
+function parseGitHubUrl(input) {
+  input = input.replace(/\/$/, "");
+  for (const pattern of GITHUB_URL_PATTERNS) {
+    const match = input.match(pattern);
+    if (match) {
+      const owner = match[1];
+      const repo = match[2].replace(/\.git$/, "");
+      const branch = match[3] || "main";
+      const commitOrPath = match[4] || match[3];
+      const path10 = match[5] || void 0;
+      return {
+        owner,
+        repo,
+        branch: commitOrPath && !commitOrPath.includes("/") ? commitOrPath : branch,
+        commit: commitOrPath?.match(/^[0-9a-f]{40}$/) ? commitOrPath : void 0,
+        path: path10
+      };
+    }
+  }
+  return null;
+}
+async function fetchGitHubFile(source, filePath) {
+  const ref = source.commit || source.branch || "main";
+  const url = `https://api.github.com/repos/${source.owner}/${source.repo}/contents/${filePath}?ref=${ref}`;
+  try {
+    const response = await fetch(url, {
+      headers: {
+        "Accept": "application/vnd.github.v3.raw",
+        "User-Agent": "SkillMarket"
+      }
+    });
+    if (!response.ok) {
+      return null;
+    }
+    return await response.text();
+  } catch {
+    return null;
+  }
+}
+async function fetchGitHubDir(source, dirPath = "") {
+  const ref = source.commit || source.branch || "main";
+  const url = `https://api.github.com/repos/${source.owner}/${source.repo}/contents/${dirPath}?ref=${ref}`;
+  try {
+    const response = await fetch(url, {
+      headers: {
+        "Accept": "application/vnd.github.v3+json",
+        "User-Agent": "SkillMarket"
+      }
+    });
+    if (!response.ok) {
+      return [];
+    }
+    const data = await response.json();
+    return Array.isArray(data) ? data : [];
+  } catch {
+    return [];
+  }
+}
+async function detectSkillFromGitHub(source) {
+  const result = {
+    hasSkillMd: false,
+    hasPackageJson: false,
+    hasMetadataJson: false,
+    platforms: [],
+    files: []
+  };
+  const basePath = source.path || "";
+  const skillMdPath = basePath ? `${basePath}/SKILL.md` : "SKILL.md";
+  const skillMdContent = await fetchGitHubFile(source, skillMdPath);
+  if (skillMdContent !== null) {
+    result.hasSkillMd = true;
+    result.files.push(skillMdPath);
+  }
+  const packageJsonPath = basePath ? `${basePath}/package.json` : "package.json";
+  const packageJsonContent = await fetchGitHubFile(source, packageJsonPath);
+  if (packageJsonContent !== null) {
+    result.hasPackageJson = true;
+    result.files.push(packageJsonPath);
+    try {
+      const pkg = JSON.parse(packageJsonContent);
+      result.skillId = pkg.name?.split("/").pop() || pkg.skillmarket?.id;
+      result.displayName = pkg.skillmarket?.displayName;
+      result.description = pkg.description;
+      if (pkg.skillmarket?.platforms) {
+        result.platforms = pkg.skillmarket.platforms;
+      }
+    } catch {
+    }
+  }
+  const metadataPath = basePath ? `${basePath}/metadata.json` : "metadata.json";
+  const metadataContent = await fetchGitHubFile(source, metadataPath);
+  if (metadataContent !== null) {
+    result.hasMetadataJson = true;
+    result.files.push(metadataPath);
+  }
+  const platformDirs = ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"];
+  for (const dir of platformDirs) {
+    const dirPath = basePath ? `${basePath}/${dir}` : dir;
+    const files = await fetchGitHubDir(source, dirPath);
+    if (files.length > 0) {
+      const platform = dir;
+      if (!result.platforms.includes(platform)) {
+        result.platforms.push(platform);
+      }
+      result.files.push(dirPath);
+    }
+  }
+  if (result.platforms.length === 0) {
+    result.platforms.push("opencode");
+  }
+  return result;
+}
+async function generatePlatformAdapters(skillId, existingPlatforms, targetPlatforms, sourceDir) {
+  const skillsDir = getSkillsDir();
+  const skillVersionDir = path9.join(skillsDir, `${skillId}@github`);
+  for (const platform of targetPlatforms) {
+    if (existingPlatforms.includes(platform)) {
+      continue;
+    }
+    const platformDir = path9.join(skillVersionDir, platform);
+    await fs10.ensureDir(platformDir);
+    const sourceSkillMd = path9.join(sourceDir, "SKILL.md");
+    const targetSkillMd = path9.join(platformDir, "SKILL.md");
+    if (await fs10.pathExists(sourceSkillMd)) {
+      await fs10.copy(sourceSkillMd, targetSkillMd);
+    }
+    if (platform === "opencode" || platform === "cursor" || platform === "codex" || platform === "antigravity") {
+    } else if (platform === "vscode") {
+      const skillJson = {
+        name: skillId,
+        description: `Skill: ${skillId}`,
+        version: "1.0.0"
+      };
+      await fs10.writeJson(path9.join(platformDir, "skill.json"), skillJson, { spaces: 2 });
+    } else if (platform === "claude") {
+      const skillJson = {
+        name: skillId,
+        description: `Skill: ${skillId}`,
+        version: "1.0.0"
+      };
+      await fs10.writeJson(path9.join(platformDir, "skill.json"), skillJson, { spaces: 2 });
+    }
+  }
+}
+async function installFromGitHub(input, options) {
+  let source = parseGitHubUrl(input);
+  if (!source) {
+    throw new Error(`Invalid GitHub URL or format: ${input}`);
+  }
+  if (options?.branch) source.branch = options.branch;
+  if (options?.commit) source.commit = options.commit;
+  console.log(`Installing from GitHub: ${source.owner}/${source.repo}`);
+  if (source.branch) console.log(`  Branch: ${source.branch}`);
+  if (source.commit) console.log(`  Commit: ${source.commit}`);
+  if (source.path) console.log(`  Path: ${source.path}`);
+  console.log("\nDetecting skill...");
+  const detected = await detectSkillFromGitHub(source);
+  if (!detected.hasSkillMd && !detected.hasPackageJson) {
+    throw new Error("No skill found in this repository (missing SKILL.md and package.json)");
+  }
+  console.log(`  SKILL.md: ${detected.hasSkillMd ? "\u2705" : "\u274C"}`);
+  console.log(`  package.json: ${detected.hasPackageJson ? "\u2705" : "\u274C"}`);
+  console.log(`  Detected platforms: ${detected.platforms.join(", ") || "none"}`);
+  const skillId = detected.skillId || source.repo;
+  const version = `github-${source.commit?.substring(0, 7) || source.branch || "main"}`;
+  console.log(`
+Setting up skill: ${skillId}@${version}`);
+  await ensureMarketDirs();
+  const skillsDir = getSkillsDir();
+  const skillVersionDir = path9.join(skillsDir, `${skillId}@${version}`);
+  await fs10.ensureDir(skillVersionDir);
+  console.log("Downloading files...");
+  const basePath = source.path || "";
+  const skillMdPath = basePath ? `${basePath}/SKILL.md` : "SKILL.md";
+  const skillMdContent = await fetchGitHubFile(source, skillMdPath);
+  if (skillMdContent) {
+    await fs10.writeFile(path9.join(skillVersionDir, "SKILL.md"), skillMdContent);
+    console.log("  \u2705 SKILL.md");
+  }
+  const packageJsonPath = basePath ? `${basePath}/package.json` : "package.json";
+  const packageJsonContent = await fetchGitHubFile(source, packageJsonPath);
+  if (packageJsonContent) {
+    await fs10.writeFile(path9.join(skillVersionDir, "package.json"), packageJsonContent);
+    console.log("  \u2705 package.json");
+  }
+  const metadataPath = basePath ? `${basePath}/metadata.json` : "metadata.json";
+  const metadataContent = await fetchGitHubFile(source, metadataPath);
+  if (metadataContent) {
+    await fs10.writeFile(path9.join(skillVersionDir, "metadata.json"), metadataContent);
+    console.log("  \u2705 metadata.json");
+  }
+  const targetPlatforms = options?.platforms || detected.platforms;
+  const existingPlatforms = detected.platforms;
+  const missingPlatforms = targetPlatforms.filter((p) => !existingPlatforms.includes(p));
+  if (missingPlatforms.length > 0) {
+    console.log(`
+Generating adapters for missing platforms: ${missingPlatforms.join(", ")}`);
+    await generatePlatformAdapters(skillId, existingPlatforms, targetPlatforms, skillVersionDir);
+    console.log("  \u2705 Platform adapters generated");
+  }
+  const skillDir = path9.join(skillsDir, skillId);
+  await fs10.ensureDir(skillDir);
+  const latestLink = path9.join(skillDir, "latest");
+  try {
+    await fs10.remove(latestLink);
+    await fs10.symlink(skillVersionDir, latestLink, "junction");
+  } catch {
+    await fs10.copy(skillVersionDir, path9.join(skillDir, "latest"), { overwrite: true });
+  }
+  console.log(`
+Installing to ${targetPlatforms.length} platform(s)...
+`);
+  const results = [];
+  for (const platform of targetPlatforms) {
+    const adapter = getAdapterByPlatform(platform);
+    if (!adapter) {
+      console.log(`${platform.padEnd(12)} \u274C  Unknown platform`);
+      results.push({ name: platform, status: "failed", error: "Unknown platform" });
+      continue;
+    }
+    try {
+      const isInstalled = await adapter.isInstalled(skillId);
+      if (isInstalled && !options?.force) {
+        console.log(`${adapter.name.padEnd(12)} \u26A0\uFE0F  Already installed (use --force to overwrite)`);
+        results.push({ name: adapter.name, status: "skipped" });
+        continue;
+      }
+      await adapter.install(skillId, skillVersionDir);
+      console.log(`${adapter.name.padEnd(12)} \u2705  Installed successfully`);
+      results.push({ name: adapter.name, status: "installed" });
+    } catch (error) {
+      console.log(`${adapter.name.padEnd(12)} \u274C  Failed: ${error}`);
+      results.push({ name: adapter.name, status: "failed", error: String(error) });
+    }
+  }
+  const installed = results.filter((r) => r.status === "installed").length;
+  const skipped = results.filter((r) => r.status === "skipped").length;
+  const failed = results.filter((r) => r.status === "failed").length;
+  console.log(`
+\u{1F4CA} Summary: ${installed} installed, ${skipped} skipped, ${failed} failed`);
+  console.log(`
+Installing to platforms: ${targetPlatforms.join(", ")}`);
+  console.log("  (Platform installation logic needs to be completed)");
+  const registry = await loadRegistry();
+  registry.skills[skillId] = {
+    id: skillId,
+    version,
+    installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    platforms: targetPlatforms
+  };
+  await saveRegistry(registry);
+  console.log(`
+\u2705 ${skillId}@${version} installed successfully from GitHub!`);
+  console.log(`   Source: ${source.owner}/${source.repo}`);
+}
+
 // src/cli.ts
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = dirname(__filename);
@@ -1051,14 +1436,24 @@ var infoCmd = program.command("info").description("Display skill information");
 infoCmd.argument("<skill-id>", "Skill ID to show info").action((skillId) => {
   showSkillInfo(skillId);
 });
-var installCmd = program.command("install").description("Install a skill to local and platform directories");
-installCmd.argument("<skill>", "Skill ID to install (e.g., brainstorming or @scope/name)").option("-p, --platform <platforms>", "Target platforms (comma-separated: opencode,claude,vscode)").option("-f, --force", "Overwrite if already installed").option("-v, --version <version>", "Specific version to install").action(async (skill, opts) => {
+var installCmd = program.command("install").description("Install a skill from npm or GitHub");
+installCmd.argument("<skill>", "Skill ID, npm package, or GitHub URL (owner/repo, https://github.com/owner/repo)").option("-p, --platform <platforms>", "Target platforms (comma-separated: opencode,claude,vscode)").option("-f, --force", "Overwrite if already installed").option("-v, --version <version>", "Specific version to install (npm only)").option("-b, --branch <branch>", "GitHub branch to install from").option("-c, --commit <commit>", "GitHub commit hash to install from").action(async (skill, opts) => {
   try {
     const platforms = opts.platform ? opts.platform.split(",").map((p) => p.trim()) : void 0;
-    await installSkill(skill, opts.version, {
-      platforms,
-      force: opts.force
-    });
+    const githubSource = parseGitHubUrl(skill);
+    if (githubSource) {
+      await installFromGitHub(skill, {
+        platforms,
+        force: opts.force,
+        branch: opts.branch,
+        commit: opts.commit
+      });
+    } else {
+      await installSkill(skill, opts.version, {
+        platforms,
+        force: opts.force
+      });
+    }
   } catch (err) {
     console.error("Installation failed:", err);
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itismyskillmarket",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "description": "Cross-platform skill manager for AI coding tools",
   "type": "module",
   "bin": {

package/src/adapters/hermes.test.ts

@@ -0,0 +1,39 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { HermesAdapter } from './hermes.js';
+import { join } from 'path';
+import { homedir } from 'os';
+
+describe('HermesAdapter', () => {
+  let adapter: HermesAdapter;
+
+  beforeEach(() => {
+    adapter = new HermesAdapter();
+  });
+
+  it('should have id "hermes"', () => {
+    expect(adapter.id).toBe('hermes');
+  });
+
+  it('should have name "Hermes Agent"', () => {
+    expect(adapter.name).toBe('Hermes Agent');
+  });
+
+  it('should have correct skillDir', () => {
+    expect(adapter.skillDir).toBe(join(homedir(), '.hermes', 'skills'));
+  });
+
+  it('should check availability based on ~/.hermes/ existence', async () => {
+    const result = await adapter.isAvailable();
+    expect(typeof result).toBe('boolean');
+  });
+
+  it('should check if skill is installed', async () => {
+    const result = await adapter.isInstalled('test-skill');
+    expect(typeof result).toBe('boolean');
+  });
+
+  it('should list installed skills', async () => {
+    const result = await adapter.listInstalled();
+    expect(Array.isArray(result)).toBe(true);
+  });
+});