itismyskillmarket 1.2.3 → 1.2.4

package/.github/workflows/publish-skill.yml

@@ -19,6 +19,8 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
       - name: Debug inputs
         run: |

package/CHANGELOG.md

@@ -0,0 +1,143 @@
+# SkillMarket v1.2.3 发布总结
+
+**日期**: 2026-04-15
+**版本**: 1.2.3
+
+---
+
+## 🎉 新功能：跨平台 Skill 安装
+
+### 支持的平台
+
+| 平台 | Skill 目录 | 状态 |
+|------|-----------|------|
+| OpenCode | `~/.config/opencode/skills/` | ✅ |
+| Claude Code | `~/.claude/skills/` | ✅ |
+| VSCode | `~/.copilot/skills/` | ✅ |
+
+### 新增命令
+
+```bash
+# 查看可用平台
+skm platforms
+
+# 安装到所有检测到的平台
+skm install <skill>
+
+# 安装到指定平台
+skm install <skill> --platform opencode
+skm install <skill> --platform opencode,claude,vscode
+
+# 卸载
+skm uninstall <skill>
+skm uninstall <skill> --platform claude
+```
+
+### 安装输出示例
+
+```
+skm install test-skill-1
+
+Installing test-skill-1...
+Downloading package...
+Setting up skill...
+
+Installing to 3 platform(s)...
+
+OpenCode     ✅  Installed successfully
+Claude Code  ✅  Installed successfully
+VSCode       ✅  Installed successfully
+
+📊 Summary: 3 installed, 0 skipped, 0 failed
+
+✅ test-skill-1@1.1.0 installed successfully!
+```
+
+### 平台状态查看
+
+```
+skm platforms
+
+📍 Available Platforms:
+
+OpenCode     ✅  Available (3 skills installed)
+Claude Code  ✅  Available (2 skills installed)
+VSCode       ✅  Available (3 skills installed)
+```
+
+---
+
+## 🐛 Bug 修复
+
+1. **npm scope 兼容问题**
+   - 修复了 `@wanxuchen/`、`@itismyskillmarket/` 等多个 scope 的自动检测
+   - 现在安装 `test-skill-1` 会自动查找正确的 npm 包
+
+2. **tarball 文件名匹配**
+   - 修复了 scoped 包文件名匹配逻辑
+   - 之前 `@scope/package` 被错误匹配为 `@scope-package`
+
+---
+
+## 📦 Skill 包列表
+
+| Skill | npm 包名 | 用途 |
+|-------|---------|------|
+| test-skill | @wanxuchen/test-skill | 通用测试 |
+| test-skill-1 | @wanxuchen/test-skill-1 | 测试安装和 info 功能 |
+| test-skill-2 | @wanxuchen/test-skill-2 | 测试卸载和更新功能 |
+
+---
+
+## 🔧 技术实现
+
+### 架构
+
+```
+src/adapters/
+├── base.ts       # 平台适配器基类
+├── opencode.ts   # OpenCode 适配器
+├── claude.ts     # Claude Code 适配器
+├── vscode.ts     # VSCode 适配器
+├── registry.ts   # 平台注册和检测
+└── index.ts      # 导出
+```
+
+### 平台适配器接口
+
+```typescript
+interface PlatformAdapter {
+  readonly id: string;
+  readonly name: string;
+  readonly skillDir: string;
+  
+  isAvailable(): Promise<boolean>;
+  isInstalled(skillId: string): Promise<boolean>;
+  install(skillId: string, sourceDir: string): Promise<void>;
+  uninstall(skillId: string): Promise<void>;
+  listInstalled(): Promise<string[]>;
+}
+```
+
+---
+
+## 📚 文档更新
+
+- `README.md` - 更新使用说明
+- `docs/plans/2026-04-15-cross-platform-adapter-design.md` - 设计文档
+- `docs/plans/2026-04-15-cross-platform-adapter-plan.md` - 实现计划
+
+---
+
+## 🚀 下一步
+
+- [ ] 发布到 VSCode Marketplace
+- [ ] 发布 Claude Code 插件市场
+- [ ] 创建 skill 市场网站
+- [ ] 添加 skill 搜索功能
+
+---
+
+## 贡献者
+
+- wxc2004 (wanxuchen)

package/dist/index.js

@@ -170,12 +170,15 @@ async function fetchSkillPackage(skillId) {
   }
   return null;
 }
-async function searchSkillmarketPackages() {
+async function searchSkillmarketPackages(options = {}) {
+  const { from = 0, size = 100 } = options;
   const packages = [];
+  let total = 0;
   return new Promise((resolve, reject) => {
     const url = new URL("https://registry.npmjs.org/-/v1/search");
     url.searchParams.set("text", "keywords:skillmarket");
-    url.searchParams.set("size", "100");
+    url.searchParams.set("size", String(size));
+    url.searchParams.set("from", String(from));
     const req = https.get(url.toString(), { timeout: 1e4 }, (res) => {
       let data = "";
       res.on("data", (chunk) => {
@@ -184,6 +187,7 @@ async function searchSkillmarketPackages() {
       res.on("end", () => {
         try {
           const result = JSON.parse(data);
+          total = result.total || 0;
           if (result.objects) {
             for (const item of result.objects) {
               if (item?.package?.name) {
@@ -191,9 +195,9 @@ async function searchSkillmarketPackages() {
               }
             }
           }
-          resolve(packages);
+          resolve({ packages, total });
         } catch {
-          resolve([]);
+          resolve({ packages: [], total: 0 });
         }
       });
     });
@@ -207,30 +211,44 @@ async function searchSkillmarketPackages() {
 
 // src/commands/ls.ts
 async function listSkills(options) {
-  const { installed, updates } = options;
+  const { installed, updates, page = 1, limit = 20 } = options;
   if (installed) {
     const skills = await getInstalledSkills();
+    const total = skills.length;
+    const totalPages = Math.ceil(total / limit) || 1;
+    const currentPage = Math.min(Math.max(1, page), totalPages);
     if (skills.length === 0) {
-      console.log('No skills installed yet. Run "skm --ls" to see available skills.');
+      console.log('No skills installed yet. Run "skm ls" to see available skills.');
       return;
     }
-    console.log("Installed Skills:\n");
-    for (const skill of skills) {
+    const start = (currentPage - 1) * limit;
+    const end = Math.min(start + limit, total);
+    const pageSkills = skills.slice(start, end);
+    console.log(`Installed Skills (${total}):
+`);
+    for (const skill of pageSkills) {
       console.log(`  ${skill.id}@${skill.version}`);
       console.log(`    Platforms: ${skill.platforms.join(", ")}`);
       console.log(`    Installed: ${skill.installedAt}`);
       console.log();
     }
+    console.log(`Page ${currentPage}/${totalPages} (${limit} per page) | Use --page N to navigate`);
     return;
   }
   console.log("Searching npm registry...\n");
   try {
-    const packages = await searchSkillmarketPackages();
+    const offset = (page - 1) * limit;
+    const { packages, total } = await searchSkillmarketPackages({
+      from: offset,
+      size: limit
+    });
+    const totalPages = Math.ceil(total / limit) || 1;
+    const currentPage = Math.min(Math.max(1, page), totalPages);
     if (packages.length === 0) {
       console.log("No skills found. Check back later!");
       return;
     }
-    console.log(`Found ${packages.length} skill(s):
+    console.log(`Found ${total} skill(s):
 `);
     for (const pkgName of packages) {
       try {
@@ -257,6 +275,7 @@ async function listSkills(options) {
         console.log();
       }
     }
+    console.log(`Page ${currentPage}/${totalPages} (${limit} per page) | Use --page N to navigate`);
   } catch (error) {
     console.log(`Error fetching skills: ${error}`);
   }
@@ -511,7 +530,7 @@ async function installSkill(skillId, version, options) {
       await execAsync(`npm pack ${packageName}@${targetVersion} --pack-destination ${cacheDir}`);
       const files = await fs7.readdir(cacheDir);
       const tarball = files.find(
-        (f) => f.endsWith(".tgz") && f.includes(packageName.replace("/", "-"))
+        (f) => f.endsWith(".tgz") && f.includes(packageName.replace(/^@/, "").replace("/", "-"))
       );
       if (tarball) {
         await execAsync(`tar -xzf "${path6.join(cacheDir, tarball)}" -C "${cacheDir}"`);
@@ -744,23 +763,28 @@ Usage: skm <command> [options]
 
 Commands:
   ls [options]         List available skills
-                         --installed    Show only installed skills
-                         --updates      Check for updates
+                          --installed    Show only installed skills
+                          --updates      Check for updates
+                          --page <n>     Page number (default: 1)
+                          --limit <n>    Items per page (default: 20)
   info <skill-id>      Display skill information
   install <skill>      Install a skill
-                         @version      Install specific version
-                         --platform    Target platforms (opencode,claude,vscode)
-                         --force       Overwrite if already installed
+                          @version      Install specific version
+                          --platform    Target platforms (opencode,claude,vscode)
+                          --force       Overwrite if already installed
   uninstall <skill>    Remove an installed skill
-                         --platform    Target platforms
+                          --platform    Target platforms
   update [options]     Update skills
-                         --all          Update all skills
+                          --all          Update all skills
   sync                 Synchronize platform links
   platforms            Show available platforms
 
 Examples:
-  skm ls                     List all available skills
+  skm ls                     List all available skills (page 1)
+  skm ls --page 2            Go to page 2
+  skm ls --limit 10          Show 10 items per page
   skm ls --installed         Show installed skills only
+  skm ls --installed --page 2
   skm info brainstorming     View skill details
   skm install brainstorming  Install to all platforms
   skm install brainstorming --platform opencode  Install to OpenCode only
@@ -772,8 +796,13 @@ Examples:
   }
 });
 var lsCmd = program.command("ls").description("List available skills");
-lsCmd.option("--installed", "Show only installed skills").option("--updates", "Check for updates").action((opts) => {
-  listSkills(opts);
+lsCmd.option("--installed", "Show only installed skills").option("--updates", "Check for updates").option("-p, --page <number>", "Page number (default: 1)", parseInt).option("-l, --limit <number>", "Items per page (default: 20)", parseInt).action((opts) => {
+  const options = {
+    ...opts,
+    page: opts.page ?? 1,
+    limit: opts.limit ?? 20
+  };
+  listSkills(options);
 });
 var infoCmd = program.command("info").description("Display skill information");
 infoCmd.argument("<skill-id>", "Skill ID to show info").action((skillId) => {

package/package.json

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

package/skills/test-skill-1/SKILL.md

@@ -0,0 +1,24 @@
+# Test Skill 1
+
+用于测试 SkillMarket 安装和 info 功能的 skill。
+
+## 功能
+
+- 验证 skm install 功能
+- 验证 skm info 功能
+
+## 使用方法
+
+```bash
+skm install test-skill-1
+skm info test-skill-1
+```
+
+## 平台支持
+
+- OpenCode
+- Cursor
+- VSCode
+- Claude Code
+- Codex
+- Antigravity

package/skills/test-skill-1/index.js

@@ -0,0 +1,13 @@
+/**
+ * Test Skill 1 - 用于测试 SkillMarket 安装和 info 功能
+ */
+
+export default async function TestSkill1() {
+  console.log("✅ Test Skill 1 加载成功!");
+  
+  return {
+    name: "test-skill-1",
+    version: "1.0.3",
+    status: "installed"
+  };
+}

package/skills/test-skill-1/metadata.json

@@ -0,0 +1,9 @@
+{
+  "id": "test-skill-1",
+  "displayName": "测试技能1",
+  "description": "用于测试 SkillMarket 安装和 info 功能",
+  "version": "1.0.3",
+  "author": "SkillMarket",
+  "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"],
+  "tags": ["test", "install", "info"]
+}

package/skills/test-skill-1/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@wanxuchen/test-skill-1",
+  "version": "1.0.3",
+  "description": "Test Skill 1 - 用于测试 SkillMarket 安装流程",
+  "type": "module",
+  "main": "index.js",
+  "keywords": ["skillmarket", "test"],
+  "author": "SkillMarket",
+  "license": "MIT",
+  "skillmarket": {
+    "id": "test-skill-1",
+    "displayName": "测试技能1",
+    "description": "用于测试 SkillMarket 安装和 info 功能",
+    "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"]
+  }
+}

package/skills/test-skill-2/SKILL.md

@@ -0,0 +1,25 @@
+# Test Skill 2
+
+用于测试 SkillMarket 卸载和更新流程的 skill。
+
+## 功能
+
+- 验证 skm uninstall 功能
+- 验证 skm update 功能
+
+## 使用方法
+
+```bash
+skm install test-skill-2
+skm update test-skill-2
+skm uninstall test-skill-2
+```
+
+## 平台支持
+
+- OpenCode
+- Cursor
+- VSCode
+- Claude Code
+- Codex
+- Antigravity

package/skills/test-skill-2/index.js

@@ -0,0 +1,13 @@
+/**
+ * Test Skill 2 - 用于测试 SkillMarket 卸载和更新功能
+ */
+
+export default async function TestSkill2() {
+  console.log("✅ Test Skill 2 加载成功!");
+  
+  return {
+    name: "test-skill-2",
+    version: "1.0.3",
+    status: "installed"
+  };
+}

package/skills/test-skill-2/metadata.json

@@ -0,0 +1,9 @@
+{
+  "id": "test-skill-2",
+  "displayName": "测试技能2",
+  "description": "用于测试 SkillMarket 卸载和更新功能",
+  "version": "1.0.3",
+  "author": "SkillMarket",
+  "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"],
+  "tags": ["test", "uninstall", "update"]
+}

package/skills/test-skill-2/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@wanxuchen/test-skill-2",
+  "version": "1.0.3",
+  "description": "Test Skill 2 - 用于测试 SkillMarket 卸载和更新流程",
+  "type": "module",
+  "main": "index.js",
+  "keywords": ["skillmarket", "test"],
+  "author": "SkillMarket",
+  "license": "MIT",
+  "skillmarket": {
+    "id": "test-skill-2",
+    "displayName": "测试技能2",
+    "description": "用于测试 SkillMarket 卸载和更新功能",
+    "platforms": ["opencode", "cursor", "vscode", "claude", "codex", "antigravity"]
+  }
+}

package/src/cli.ts

@@ -79,30 +79,35 @@ program
 program
   .hook('preAction', (thisCommand) => {
     if (thisCommand.opts().help) {
-      console.log(`
+  console.log(`
 SkillMarket CLI
 
 Usage: skm <command> [options]
 
 Commands:
   ls [options]         List available skills
-                         --installed    Show only installed skills
-                         --updates      Check for updates
+                          --installed    Show only installed skills
+                          --updates      Check for updates
+                          --page <n>     Page number (default: 1)
+                          --limit <n>    Items per page (default: 20)
   info <skill-id>      Display skill information
   install <skill>      Install a skill
-                         @version      Install specific version
-                         --platform    Target platforms (opencode,claude,vscode)
-                         --force       Overwrite if already installed
+                          @version      Install specific version
+                          --platform    Target platforms (opencode,claude,vscode)
+                          --force       Overwrite if already installed
   uninstall <skill>    Remove an installed skill
-                         --platform    Target platforms
+                          --platform    Target platforms
   update [options]     Update skills
-                         --all          Update all skills
+                          --all          Update all skills
   sync                 Synchronize platform links
   platforms            Show available platforms
 
 Examples:
-  skm ls                     List all available skills
+  skm ls                     List all available skills (page 1)
+  skm ls --page 2            Go to page 2
+  skm ls --limit 10          Show 10 items per page
   skm ls --installed         Show installed skills only
+  skm ls --installed --page 2
   skm info brainstorming     View skill details
   skm install brainstorming  Install to all platforms
   skm install brainstorming --platform opencode  Install to OpenCode only
@@ -132,8 +137,16 @@ const lsCmd = program.command('ls').description('List available skills');
 lsCmd
   .option('--installed', 'Show only installed skills')
   .option('--updates', 'Check for updates')
+  .option('-p, --page <number>', 'Page number (default: 1)', parseInt)
+  .option('-l, --limit <number>', 'Items per page (default: 20)', parseInt)
   .action((opts) => {
-    listSkills(opts);
+    // Ensure numeric options have default values if not provided
+    const options = {
+      ...opts,
+      page: opts.page ?? 1,
+      limit: opts.limit ?? 20
+    };
+    listSkills(options);
   });
 
 // -----------------------------------------------------------------------------

package/src/commands/install.ts

@@ -147,10 +147,10 @@ export async function installSkill(
       const files = await fs.readdir(cacheDir);
       
       // npm pack 生成的文件名格式: <package-name>-<version>.tgz
-      // scoped 包格式: @scope-package-name-<version>.tgz
+      // scoped 包格式: @scope-package-name-<version>.tgz (注意：@ 不在文件名中)
       const tarball = files.find(f => 
         f.endsWith('.tgz') && 
-        f.includes(packageName.replace('/', '-'))
+        f.includes(packageName.replace(/^@/, '').replace('/', '-'))
       );
       
       if (tarball) {

package/src/commands/ls.ts

@@ -37,6 +37,12 @@ interface LsOptions {
   
   /** 检查更新（预留功能） */
   updates?: boolean;
+  
+  /** 页码（从 1 开始） */
+  page?: number;
+  
+  /** 每页数量 */
+  limit?: number;
 }
 
 // -----------------------------------------------------------------------------
@@ -60,25 +66,33 @@ interface LsOptions {
  * await listSkills({ installed: true });
  */
 export async function listSkills(options: LsOptions): Promise<void> {
-  const { installed, updates } = options;
+  const { installed, updates, page = 1, limit = 20 } = options;
   
   // -------------------------------------------------------------------------
   // 模式1: 显示已安装的 skills
   // -------------------------------------------------------------------------
   if (installed) {
     const skills = await getInstalledSkills();
+    const total = skills.length;
+    const totalPages = Math.ceil(total / limit) || 1;
+    const currentPage = Math.min(Math.max(1, page), totalPages);
     
     // 无已安装 skills 时给出提示
     if (skills.length === 0) {
-      console.log('No skills installed yet. Run "skm --ls" to see available skills.');
+      console.log('No skills installed yet. Run "skm ls" to see available skills.');
       return;
     }
     
+    // 计算分页范围
+    const start = (currentPage - 1) * limit;
+    const end = Math.min(start + limit, total);
+    const pageSkills = skills.slice(start, end);
+    
     // 打印表头
-    console.log('Installed Skills:\n');
+    console.log(`Installed Skills (${total}):\n`);
     
     // 遍历并打印每个 skill 的详细信息
-    for (const skill of skills) {
+    for (const skill of pageSkills) {
       // skill 名称和版本
       console.log(`  ${skill.id}@${skill.version}`);
       
@@ -92,6 +106,9 @@ export async function listSkills(options: LsOptions): Promise<void> {
       console.log();
     }
     
+    // 打印分页信息
+    console.log(`Page ${currentPage}/${totalPages} (${limit} per page) | Use --page N to navigate`);
+    
     return;
   }
   
@@ -103,8 +120,17 @@ export async function listSkills(options: LsOptions): Promise<void> {
   console.log('Searching npm registry...\n');
   
   try {
+    // 计算分页偏移量
+    const offset = (page - 1) * limit;
+    
     // 调用 npm search API 搜索 skillmarket 相关包
-    const packages = await searchSkillmarketPackages();
+    const { packages, total } = await searchSkillmarketPackages({
+      from: offset,
+      size: limit
+    });
+    
+    const totalPages = Math.ceil(total / limit) || 1;
+    const currentPage = Math.min(Math.max(1, page), totalPages);
     
     // 无搜索结果时
     if (packages.length === 0) {
@@ -113,7 +139,7 @@ export async function listSkills(options: LsOptions): Promise<void> {
     }
     
     // 打印找到的包数量
-    console.log(`Found ${packages.length} skill(s):\n`);
+    console.log(`Found ${total} skill(s):\n`);
     
     // 遍历每个包，获取详细信息并显示
     for (const pkgName of packages) {
@@ -162,6 +188,9 @@ export async function listSkills(options: LsOptions): Promise<void> {
         console.log();
       }
     }
+    
+    // 打印分页信息
+    console.log(`Page ${currentPage}/${totalPages} (${limit} per page) | Use --page N to navigate`);
   } catch (error) {
     // 网络错误处理
     console.log(`Error fetching skills: ${error}`);

package/src/commands/npm.ts

@@ -250,17 +250,25 @@ export async function fetchSkillPackage(skillId: string): Promise<NpmRegistryRes
  * 
  * API 端点: GET https://registry.npmjs.org/-/v1/search
  * 
- * @returns {Promise<string[]>} 匹配的包名数组
+ * @param options - 搜索选项
+ * @param options.from - 起始位置（分页用）
+ * @param options.size - 返回结果数量
+ * @returns {Promise<{packages: string[], total: number}>} 匹配的包名数组和总数
  * 
  * @example
- * const packages = await searchSkillmarketPackages();
- * console.log(`找到 ${packages.length} 个 skill 包`);
+ * const { packages, total } = await searchSkillmarketPackages();
+ * console.log(`找到 ${total} 个 skill 包`);
  * packages.forEach(name => {
  *   console.log(`- ${name}`);
  * });
  */
-export async function searchSkillmarketPackages(): Promise<string[]> {
+export async function searchSkillmarketPackages(options: {
+  from?: number;
+  size?: number;
+} = {}): Promise<{ packages: string[]; total: number }> {
+  const { from = 0, size = 100 } = options;
   const packages: string[] = [];
+  let total = 0;
   
   return new Promise((resolve, reject) => {
     // 构建 search API URL
@@ -269,8 +277,10 @@ export async function searchSkillmarketPackages(): Promise<string[]> {
     // 设置搜索参数
     // text: 搜索关键字
     // size: 返回结果数量上限
+    // from: 起始位置（分页用）
     url.searchParams.set('text', 'keywords:skillmarket');
-    url.searchParams.set('size', '100');
+    url.searchParams.set('size', String(size));
+    url.searchParams.set('from', String(from));
     
     const req = https.get(url.toString(), { timeout: 10000 }, (res) => {
       let data = '';
@@ -283,6 +293,9 @@ export async function searchSkillmarketPackages(): Promise<string[]> {
           // 解析搜索结果
           const result = JSON.parse(data);
           
+          // 获取总数
+          total = result.total || 0;
+          
           // 提取所有匹配的包名
           // npm search 返回结构: { objects: [{ package: { name: "..." } }] }
           if (result.objects) {
@@ -293,10 +306,10 @@ export async function searchSkillmarketPackages(): Promise<string[]> {
             }
           }
           
-          resolve(packages);
+          resolve({ packages, total });
         } catch {
           // 解析失败返回空数组
-          resolve([]);
+          resolve({ packages: [], total: 0 });
         }
       });
     });