itismyskillmarket 1.2.2 → 1.2.3

package/package.json

@@ -1,13 +1,8 @@
 {
   "name": "itismyskillmarket",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "Cross-platform skill manager for AI coding tools",
   "type": "module",
-  "files": [
-    "dist",
-    "src",
-    "README.md"
-  ],
   "bin": {
     "skm": "dist/index.js"
   },

package/skills/README.md

@@ -0,0 +1,52 @@
+# SkillMarket Skills
+
+This directory contains the skill packages that can be published to npm.
+
+## Adding a New Skill
+
+1. Create a new directory under `skills/<skill-name>/`
+2. Add the required files:
+   - `package.json` - Package configuration with `skillmarket` metadata
+   - `SKILL.md` - Skill documentation
+   - `metadata.json` - Skill metadata
+   - `index.js` - Main entry point (OpenCode plugin)
+
+3. Update the GitHub Actions workflow to include your skill (if using dropdown options)
+
+## Publishing a Skill
+
+### Option 1: GitHub Actions (Recommended)
+1. Go to repository Actions tab
+2. Select "Publish Skill" workflow
+3. Click "Run workflow"
+4. Enter skill name (e.g., `test-skill`)
+5. Optionally specify version
+
+### Option 2: Manual Publish
+```bash
+cd skills/<skill-name>
+npm install
+npm publish --access=public
+```
+
+## Skill Package Requirements
+
+```json
+{
+  "name": "@itismyskillmarket/<skill-name>",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "index.js",
+  "keywords": ["skillmarket"],
+  "skillmarket": {
+    "id": "<skill-name>",
+    "displayName": "Display Name",
+    "description": "Description",
+    "platforms": ["opencode", "cursor", "vscode"]
+  }
+}
+```
+
+## Current Skills
+
+- `test-skill` - Test skill for validating the installation flow

package/skills/test-skill/SKILL.md

@@ -0,0 +1,25 @@
+# Test Skill
+
+这是一个用于测试 SkillMarket 安装流程的 skill。
+
+## 功能
+
+- `test.greet` - 向用户打招呼
+- `test.randomNumber` - 生成随机数
+- `test.systemInfo` - 获取系统信息
+
+## 使用方法
+
+```bash
+skm install test-skill
+skm info test-skill
+```
+
+## 平台支持
+
+- OpenCode
+- Cursor
+- VSCode
+- Claude Code
+- Codex
+- Antigravity

package/skills/test-skill/index.js

@@ -0,0 +1,66 @@
+/**
+ * Test Skill - SkillMarket 测试技能
+ * 
+ * 这是一个用于验证 SkillMarket 安装流程的示例 skill
+ */
+
+import { tool } from "@opencode-ai/plugin";
+
+export default async function TestSkill() {
+  console.log("✅ Test Skill 加载成功!");
+
+  return {
+    tool: {
+      // 1. 简单的问候工具
+      greet: tool({
+        description: "向用户打招呼",
+        args: {
+          name: tool.schema.string().describe("你的名字")
+        },
+        async execute({ name }, context) {
+          const { agent, sessionID } = context;
+          return `你好 ${name}！我是 ${agent} 代理，欢迎使用测试插件！会话ID: ${sessionID}`;
+        }
+      }),
+
+      // 2. 随机数生成工具
+      randomNumber: tool({
+        description: "生成指定范围的随机数",
+        args: {
+          min: tool.schema.number().describe("最小值").default(1),
+          max: tool.schema.number().describe("最大值").default(100)
+        },
+        async execute({ min, max }, context) {
+          const randomNum = Math.floor(Math.random() * (max - min + 1)) + min;
+          return `随机数（${min}-${max}）: ${randomNum}`;
+        }
+      }),
+
+      // 3. 系统信息工具
+      systemInfo: tool({
+        description: "获取系统信息",
+        args: {},
+        async execute(args, context) {
+          const { sessionID, agent } = context;
+          const info = {
+            agent: agent,
+            sessionID: sessionID,
+            timestamp: new Date().toISOString(),
+            platform: process.platform,
+            nodeVersion: process.version
+          };
+          return JSON.stringify(info, null, 2);
+        }
+      })
+    },
+
+    // 钩子示例
+    "tool.execute.before": async (input, output) => {
+      console.log(`🛠️ 工具即将执行: ${input.tool}`);
+    },
+
+    "tool.execute.after": async (input, output) => {
+      console.log(`✅ 工具执行完成: ${input.tool}`);
+    }
+  };
+}

package/skills/test-skill/metadata.json

@@ -0,0 +1,9 @@
+{
+  "id": "test-skill",
+  "displayName": "测试技能",
+  "description": "SkillMarket 测试技能 - 用于验证安装流程",
+  "version": "1.0.0",
+  "author": "SkillMarket",
+  "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"],
+  "tags": ["test", "demo"]
+}

package/skills/test-skill/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@itismyskillmarket/test-skill",
+  "version": "1.0.1",
+  "description": "SkillMarket 测试技能 - 用于验证安装流程",
+  "type": "module",
+  "main": "index.js",
+  "keywords": ["skillmarket", "test"],
+  "author": "SkillMarket",
+  "license": "MIT",
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.1.31"
+  },
+  "skillmarket": {
+    "id": "test-skill",
+    "displayName": "测试技能",
+    "description": "这是一个用于测试 SkillMarket 安装流程的 skill",
+    "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"]
+  }
+}

package/src/adapters/base.ts

@@ -0,0 +1,87 @@
+/**
+ * =============================================================================
+ * Base Platform Adapter
+ * =============================================================================
+ * 
+ * Abstract base class for platform-specific skill adapters.
+ * Provides common functionality for all platforms.
+ */
+
+import fs from 'fs-extra';
+import path from 'path';
+import type { PlatformAdapter } from '../types.js';
+
+export abstract class BaseAdapter implements PlatformAdapter {
+  abstract readonly id: string;
+  abstract readonly name: string;
+  abstract readonly skillDir: string;
+  
+  /**
+   * Get the path where a specific skill should be installed
+   */
+  protected getSkillPath(skillId: string): string {
+    return path.join(this.skillDir, skillId);
+  }
+  
+  /**
+   * Get the path to the SKILL.md file for a skill
+   */
+  protected getSkillFilePath(skillId: string): string {
+    return path.join(this.getSkillPath(skillId), 'SKILL.md');
+  }
+  
+  async isAvailable(): Promise<boolean> {
+    try {
+      await fs.ensureDir(this.skillDir);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  
+  async isInstalled(skillId: string): Promise<boolean> {
+    const skillFile = this.getSkillFilePath(skillId);
+    return fs.pathExists(skillFile);
+  }
+  
+  async install(skillId: string, sourceDir: string): Promise<void> {
+    const targetDir = this.getSkillPath(skillId);
+    const targetFile = this.getSkillFilePath(skillId);
+    
+    await fs.ensureDir(targetDir);
+    
+    const sourceFile = path.join(sourceDir, 'SKILL.md');
+    if (!(await fs.pathExists(sourceFile))) {
+      throw new Error(`SKILL.md not found in ${sourceDir}`);
+    }
+    
+    await fs.copy(sourceFile, targetFile, { overwrite: true });
+  }
+  
+  async uninstall(skillId: string): Promise<void> {
+    const targetDir = this.getSkillPath(skillId);
+    if (await fs.pathExists(targetDir)) {
+      await fs.remove(targetDir);
+    }
+  }
+  
+  async listInstalled(): Promise<string[]> {
+    if (!(await fs.pathExists(this.skillDir))) {
+      return [];
+    }
+    
+    const entries = await fs.readdir(this.skillDir, { withFileTypes: true });
+    const skills: string[] = [];
+    
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        const skillFile = path.join(this.skillDir, entry.name, 'SKILL.md');
+        if (await fs.pathExists(skillFile)) {
+          skills.push(entry.name);
+        }
+      }
+    }
+    
+    return skills;
+  }
+}

package/src/adapters/claude.ts

@@ -0,0 +1,31 @@
+/**
+ * =============================================================================
+ * Claude Code Platform Adapter
+ * =============================================================================
+ * 
+ * Handles skill installation for Claude Code CLI.
+ * Skills are installed to ~/.claude/skills/<skill-id>/
+ */
+
+import path from 'path';
+import os from 'os';
+import fs from 'fs-extra';
+import { BaseAdapter } from './base.js';
+
+export class ClaudeAdapter extends BaseAdapter {
+  readonly id = 'claude';
+  readonly name = 'Claude Code';
+  
+  get skillDir(): string {
+    return path.join(os.homedir(), '.claude', 'skills');
+  }
+  
+  async isAvailable(): Promise<boolean> {
+    // Check for environment variable or directory
+    if (process.env.CLAUDE_CODE) return true;
+    
+    // Check if .claude directory exists
+    const claudeDir = path.join(os.homedir(), '.claude');
+    return fs.pathExists(claudeDir);
+  }
+}

package/src/adapters/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Platform adapters index
+ */
+
+export { BaseAdapter } from './base.js';
+export { OpenCodeAdapter } from './opencode.js';
+export { ClaudeAdapter } from './claude.js';
+export { VSCodeAdapter } from './vscode.js';
+export { detectPlatforms, getPlatformAdapter, getAllAdapters, getAdapterByPlatform } from './registry.js';

package/src/adapters/opencode.ts

@@ -0,0 +1,40 @@
+/**
+ * =============================================================================
+ * OpenCode Platform Adapter
+ * =============================================================================
+ * 
+ * Handles skill installation for OpenCode AI coding tool.
+ * Skills are installed to ~/.config/opencode/skills/<skill-id>/
+ */
+
+import path from 'path';
+import os from 'os';
+import fs from 'fs-extra';
+import { BaseAdapter } from './base.js';
+
+export class OpenCodeAdapter extends BaseAdapter {
+  readonly id = 'opencode';
+  readonly name = 'OpenCode';
+  
+  get skillDir(): string {
+    // Respect OPENCODE_CONFIG_DIR environment variable
+    const configDir = process.env.OPENCODE_CONFIG_DIR 
+      || path.join(os.homedir(), '.config', 'opencode');
+    return path.join(configDir, 'skills');
+  }
+  
+  async isAvailable(): Promise<boolean> {
+    // Check for environment variable or directory
+    if (process.env.OPENCODE) return true;
+    
+    const configDir = process.env.OPENCODE_CONFIG_DIR 
+      || path.join(os.homedir(), '.config', 'opencode');
+    
+    try {
+      await fs.ensureDir(path.join(configDir, 'skills'));
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}

package/src/adapters/registry.ts

@@ -0,0 +1,77 @@
+/**
+ * =============================================================================
+ * Platform Registry
+ * =============================================================================
+ * 
+ * Central registry for platform adapters.
+ * Handles platform detection and selection.
+ */
+
+import { OpenCodeAdapter } from './opencode.js';
+import { ClaudeAdapter } from './claude.js';
+import { VSCodeAdapter } from './vscode.js';
+import type { PlatformAdapter } from '../types.js';
+import type { Platform } from '../constants.js';
+
+const adapters: Map<string, PlatformAdapter> = new Map();
+
+/**
+ * Register all built-in platform adapters
+ */
+function registerAdapters(): void {
+  const opencode = new OpenCodeAdapter();
+  const claude = new ClaudeAdapter();
+  const vscode = new VSCodeAdapter();
+  
+  adapters.set(opencode.id, opencode);
+  adapters.set(claude.id, claude);
+  adapters.set(vscode.id, vscode);
+}
+
+// Register adapters on module load
+registerAdapters();
+
+/**
+ * Detect which platforms are available on the current system
+ */
+export async function detectPlatforms(): Promise<PlatformAdapter[]> {
+  const available: PlatformAdapter[] = [];
+  
+  for (const adapter of adapters.values()) {
+    if (await adapter.isAvailable()) {
+      available.push(adapter);
+    }
+  }
+  
+  return available;
+}
+
+/**
+ * Get adapter for a specific platform
+ */
+export function getPlatformAdapter(platformId: string): PlatformAdapter | undefined {
+  return adapters.get(platformId);
+}
+
+/**
+ * Get all registered adapters
+ */
+export function getAllAdapters(): PlatformAdapter[] {
+  return Array.from(adapters.values());
+}
+
+/**
+ * Get adapter by platform type
+ */
+export function getAdapterByPlatform(platform: Platform): PlatformAdapter | undefined {
+  const idMap: Record<Platform, string> = {
+    opencode: 'opencode',
+    claude: 'claude',
+    vscode: 'vscode',
+    cursor: 'opencode',  // Cursor uses OpenCode-compatible structure
+    codex: 'opencode',  // Codex uses OpenCode-compatible structure
+    antigravity: 'opencode',  // Antigravity uses OpenCode-compatible structure
+  };
+  
+  return adapters.get(idMap[platform]);
+}

package/src/adapters/vscode.ts

@@ -0,0 +1,62 @@
+/**
+ * =============================================================================
+ * VSCode (Copilot) Platform Adapter
+ * =============================================================================
+ * 
+ * Handles skill installation for VSCode GitHub Copilot Agent Skills.
+ * Skills are installed to ~/.copilot/skills/<skill-id>/
+ * 
+ * Note: Also supports ~/.claude/skills/ for cross-compatibility.
+ */
+
+import path from 'path';
+import os from 'os';
+import fs from 'fs-extra';
+import { BaseAdapter } from './base.js';
+
+export class VSCodeAdapter extends BaseAdapter {
+  readonly id = 'vscode';
+  readonly name = 'VSCode';
+  
+  get skillDir(): string {
+    // Try ~/.copilot/skills first, fallback to ~/.claude/skills
+    return path.join(os.homedir(), '.copilot', 'skills');
+  }
+  
+  async isAvailable(): Promise<boolean> {
+    // Check multiple possible locations
+    const possibleDirs = [
+      path.join(os.homedir(), '.copilot', 'skills'),
+      path.join(os.homedir(), '.claude', 'skills'),
+    ];
+    
+    for (const dir of possibleDirs) {
+      try {
+        await fs.ensureDir(dir);
+        return true;
+      } catch {
+        continue;
+      }
+    }
+    
+    return false;
+  }
+  
+  async install(skillId: string, sourceDir: string): Promise<void> {
+    // Install to ~/.copilot/skills, but also create symlink in ~/.claude/skills
+    await super.install(skillId, sourceDir);
+    
+    // Create cross-compatible symlink in ~/.claude/skills
+    const claudeSkillDir = path.join(os.homedir(), '.claude', 'skills');
+    const targetPath = this.getSkillPath(skillId);
+    const claudeTargetPath = path.join(claudeSkillDir, skillId);
+    
+    try {
+      await fs.ensureDir(claudeSkillDir);
+      await fs.remove(claudeTargetPath);
+      await fs.symlink(targetPath, claudeTargetPath, 'junction');
+    } catch {
+      // Silently fail if symlink not possible (cross-platform compatibility)
+    }
+  }
+}