@workskills/getskill 1.0.0

package/EXAMPLES.md

@@ -0,0 +1,265 @@
+# GetSkill 使用示例
+
+## 场景 1: 首次使用（未安装 Git）
+
+### Windows 用户
+
+```bash
+# 第一次运行安装命令
+$ getskill install commit-helper
+
+检测到系统未安装 Git，正在准备安装...
+
+Windows 系统检测到未安装 Git
+正在下载 Git 安装程序...
+
+下载进度: 100%
+下载完成！
+
+Git 安装程序已下载到: C:\Users\...\AppData\Local\Temp\git-installer.exe
+
+正在启动安装程序，请按照提示完成安装...
+安装完成后，请重新运行此命令。
+
+# Git 安装完成后，再次运行
+$ getskill install commit-helper
+
+获取技能信息: commit-helper...
+克隆仓库: https://github.com/workskills/commit-helper.git...
+仓库克隆成功: C:\Users\...\\.claude\skills-cache\commit-helper
+
+技能已安装到 skills 目录:
+  - C:\Users\...\.claude\skills\commit-helper.md
+
+Git 仓库缓存: C:\Users\...\.claude\skills-cache\commit-helper
+```
+
+### macOS 用户
+
+```bash
+$ getskill install commit-helper
+
+检测到系统未安装 Git，正在准备安装...
+
+macOS 系统检测到未安装 Git
+请使用以下命令安装 Git:
+
+  brew install git
+
+如果未安装 Homebrew，请访问: https://brew.sh/
+
+# 安装 Git
+$ brew install git
+
+# 再次运行
+$ getskill install commit-helper
+✓ 安装成功
+```
+
+### Linux 用户
+
+```bash
+$ getskill install commit-helper
+
+检测到系统未安装 Git，正在准备安装...
+
+Linux 系统检测到未安装 Git
+请使用系统包管理器安装 Git:
+
+  Ubuntu/Debian: sudo apt-get install git
+  CentOS/RHEL:   sudo yum install git
+  Fedora:        sudo dnf install git
+  Arch:          sudo pacman -S git
+
+# Ubuntu/Debian 用户
+$ sudo apt-get install git
+
+# 再次运行
+$ getskill install commit-helper
+✓ 安装成功
+```
+
+## 场景 2: 已安装 Git（正常使用）
+
+```bash
+# 搜索技能
+$ getskill search commit
+
+找到 3 个技能:
+
+1. commit-helper
+   描述: 帮助生成规范的 git commit 信息
+   Git: https://github.com/workskills/commit-helper.git
+   作者: workskills
+
+2. commit-lint
+   描述: 检查 commit 信息是否符合规范
+   Git: https://github.com/workskills/commit-lint.git
+   作者: workskills
+
+# 安装技能
+$ getskill install commit-helper
+
+获取技能信息: commit-helper...
+克隆仓库: https://github.com/workskills/commit-helper.git...
+仓库克隆成功: ~/.claude/skills-cache/commit-helper
+已复制: commit-helper.md -> ~/.claude/skills/commit-helper.md
+
+技能已安装到 skills 目录:
+  - ~/.claude/skills/commit-helper.md
+
+Git 仓库缓存: ~/.claude/skills-cache/commit-helper
+
+# 列出已安装的技能
+$ getskill list
+
+本地已安装的技能 (1):
+1. commit-helper.md
+
+# 更新技能
+$ getskill update commit-helper
+
+正在更新技能: commit-helper...
+更新仓库: commit-helper...
+Already up to date.
+仓库更新成功: ~/.claude/skills-cache/commit-helper
+已复制: commit-helper.md -> ~/.claude/skills/commit-helper.md
+
+技能已更新到 skills 目录:
+  - ~/.claude/skills/commit-helper.md
+
+# 查看目录路径
+$ getskill path
+
+技能目录: ~/.claude/skills
+缓存目录: ~/.claude/skills-cache
+
+# 清理缓存
+$ getskill clean
+
+已清理缓存目录: ~/.claude/skills-cache
+```
+
+## 场景 3: 编程接口使用
+
+```javascript
+const getskill = require('@workskills/getskill');
+
+(async () => {
+    try {
+        // 检查 Git 是否已安装
+        const isGitInstalled = await getskill.checkGitInstalled();
+        console.log('Git 已安装:', isGitInstalled);
+
+        if (!isGitInstalled) {
+            console.log('正在引导安装 Git...');
+            await getskill.ensureGitInstalled();
+        }
+
+        // 搜索技能
+        const results = await getskill.searchSkills('commit');
+        console.log('搜索结果:', results);
+
+        // 安装技能
+        const result = await getskill.downloadSkill('commit-helper');
+        console.log('安装成功:', result.files);
+
+        // 更新技能
+        await getskill.updateSkill('commit-helper');
+        console.log('更新成功');
+
+        // 列出本地技能
+        const localSkills = getskill.listLocalSkills();
+        console.log('本地技能:', localSkills);
+
+    } catch (error) {
+        console.error('错误:', error.message);
+    }
+})();
+```
+
+## 场景 4: 批量安装技能
+
+```bash
+# 创建脚本 install-skills.sh
+#!/bin/bash
+
+skills=(
+    "commit-helper"
+    "code-review"
+    "test-generator"
+    "doc-writer"
+)
+
+for skill in "${skills[@]}"; do
+    echo "正在安装: $skill"
+    getskill install "$skill"
+    echo "---"
+done
+
+# 运行脚本
+$ chmod +x install-skills.sh
+$ ./install-skills.sh
+```
+
+## 场景 5: 错误处理
+
+```bash
+# 技能不存在
+$ getskill install non-existent-skill
+获取技能信息: non-existent-skill...
+搜索技能失败: Request failed with status code 404
+执行命令时出错: Request failed with status code 404
+
+# Git URL 无效
+$ getskill install invalid-git-skill
+获取技能信息: invalid-git-skill...
+克隆仓库: https://invalid-url.git...
+克隆失败: fatal: repository 'https://invalid-url.git/' not found
+执行命令时出错: Command failed: git clone...
+
+# 网络问题
+$ getskill search commit
+搜索技能失败: connect ETIMEDOUT
+执行命令时出错: connect ETIMEDOUT
+```
+
+## 场景 6: 目录结构查看
+
+```bash
+# 安装几个技能后查看目录结构
+$ tree ~/.claude
+
+~/.claude/
+├── skills/
+│   ├── commit-helper.md
+│   ├── code-review.md
+│   └── test-generator.md
+└── skills-cache/
+    ├── commit-helper/
+    │   ├── commit-helper.md
+    │   ├── README.md
+    │   └── .git/
+    ├── code-review/
+    │   ├── code-review.md
+    │   ├── README.md
+    │   └── .git/
+    └── test-generator/
+        ├── test-generator.md
+        ├── README.md
+        └── .git/
+```
+
+## 常见问题
+
+### Q: Git 安装后仍提示未安装？
+A: Windows 用户需要重启终端或系统，以便环境变量生效。
+
+### Q: 如何卸载技能？
+A: 直接删除 `~/.claude/skills/` 目录下的对应 `.md` 文件即可。
+
+### Q: 缓存目录可以删除吗？
+A: 可以使用 `getskill clean` 清理缓存，下次更新技能时会重新克隆。
+
+### Q: 如何手动指定 Git 路径？
+A: 确保 `git` 命令在系统 PATH 中，或修改 `~/.bashrc` / `~/.zshrc` 添加 Git 路径。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 workskills.store
+
+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.

package/README.md

@@ -0,0 +1,257 @@
+# GetSkill
+
+OpenClaw 技能管理工具 - 从 getskill.work 搜索、下载和更新技能文件
+
+## 功能特性
+
+- 🔍 从 getskill.work API 搜索技能
+- 📥 通过 Git 克隆技能仓库
+- 🔄 通过 Git pull 更新已安装的技能
+- 🛠️ 自动检测并引导安装 Git（如未安装）
+- 📂 跨平台支持（Windows/macOS/Linux）
+- 💾 自动管理技能文件到 OpenClaw skills 目录
+
+## 工作原理
+
+1. **搜索**: 从 `getskill.work` API 获取技能列表，包含 Git 仓库地址
+2. **安装**: 使用 `git clone` 克隆技能仓库到缓存目录
+3. **复制**: 将仓库中的 `.md` 技能文件复制到 OpenClaw skills 目录
+4. **更新**: 使用 `git pull` 更新仓库，并重新复制文件
+
+## 目录结构
+
+```
+~/.claude/
+├── skills/          # OpenClaw 技能文件目录
+│   ├── skill1.md
+│   └── skill2.md
+└── skills-cache/    # Git 仓库缓存
+    ├── skill1/
+    └── skill2/
+```
+
+### 平台路径
+
+- **Windows**: `%USERPROFILE%\.claude\skills`
+- **macOS**: `~/.claude/skills`
+- **Linux**: `~/.claude/skills`
+
+## 安装
+
+### 全局安装（推荐）
+
+```bash
+npm install -g @workskills/getskill
+```
+
+安装后，可以在任何位置使用 `getskill` 命令。
+
+### 本地安装
+
+```bash
+npm install @workskills/getskill
+```
+
+本地安装后，可以通过 npx 运行：
+
+```bash
+npx getskill search <关键词>
+```
+
+### 从源码安装
+
+```bash
+git clone https://github.com/workskills/getskill.git
+cd getskill
+npm install
+npm link
+```
+
+## 使用方法
+
+### 搜索技能
+
+```bash
+getskill search <关键词>
+```
+
+示例输出：
+```
+找到 3 个技能:
+
+1. commit-helper
+   描述: 帮助生成规范的 git commit 信息
+   Git: https://github.com/workskills/commit-helper.git
+   作者: workskills
+
+2. code-review
+   描述: AI 代码审查助手
+   Git: https://github.com/workskills/code-review.git
+   作者: workskills
+```
+
+### 安装技能
+
+```bash
+getskill install <技能名称>
+```
+
+示例：
+```bash
+getskill install commit-helper
+```
+
+操作流程：
+1. 调用 API 获取技能详情（包含 git_url）
+2. 执行 `git clone` 到 `~/.claude/skills-cache/commit-helper`
+3. 复制 `.md` 文件到 `~/.claude/skills/`
+
+### 更新技能
+
+```bash
+getskill update <技能名称>
+```
+
+示例：
+```bash
+getskill update commit-helper
+```
+
+操作流程：
+1. 进入缓存目录 `~/.claude/skills-cache/commit-helper`
+2. 执行 `git pull`
+3. 重新复制最新的 `.md` 文件
+
+### 列出本地技能
+
+```bash
+getskill list
+```
+
+### 查看目录路径
+
+```bash
+getskill path
+```
+
+### 清理缓存
+
+```bash
+getskill clean
+```
+
+清理所有 Git 仓库缓存（不影响 skills 目录中的文件）
+
+## API 接口规范
+
+### 搜索 API
+
+```
+GET https://getskill.work/api/skills/search?q=<关键词>
+```
+
+响应格式：
+```json
+{
+  "skills": [
+    {
+      "id": "commit-helper",
+      "name": "commit-helper",
+      "description": "帮助生成规范的 git commit 信息",
+      "git_url": "https://github.com/workskills/commit-helper.git",
+      "author": "workskills",
+      "version": "1.0.0"
+    }
+  ]
+}
+```
+
+### 详情 API
+
+```
+GET https://getskill.work/api/skills/<技能ID>
+```
+
+响应格式：
+```json
+{
+  "id": "commit-helper",
+  "name": "commit-helper",
+  "description": "帮助生成规范的 git commit 信息",
+  "git_url": "https://github.com/workskills/commit-helper.git",
+  "author": "workskills",
+  "version": "1.0.0",
+  "files": ["commit-helper.md"],
+  "readme": "..."
+}
+```
+
+## 编程接口
+
+```javascript
+const getskill = require('@workskills/getskill');
+
+// 搜索技能
+const results = await getskill.searchSkills('commit');
+
+// 安装技能
+const result = await getskill.downloadSkill('commit-helper');
+console.log(result.files); // 已复制的文件列表
+
+// 更新技能
+await getskill.updateSkill('commit-helper');
+
+// 列出本地技能
+const skills = getskill.listLocalSkills();
+
+// 获取目录
+const skillsDir = getskill.getSkillsDirectory();
+const cacheDir = getskill.getSkillsCacheDirectory();
+```
+
+## 技能仓库规范
+
+技能 Git 仓库应包含：
+- 一个或多个 `.md` 技能文件（非 README）
+- 可选的 `README.md` 说明文档
+- 可选的示例代码或配置文件
+
+示例结构：
+```
+commit-helper/
+├── commit-helper.md    # 主技能文件（会被复制）
+├── README.md           # 说明文档（不会被复制）
+└── examples/           # 示例（不会被复制）
+```
+
+## 依赖
+
+- Node.js >= 12
+- Git 命令行工具（如未安装，程序会自动引导安装）
+
+## Git 自动检测与安装
+
+首次运行 `install` 或 `update` 命令时，程序会自动检测系统是否已安装 Git：
+
+### Windows
+- **自动下载**: 自动下载 Git 安装程序并启动安装向导
+- **手动安装**: 如果自动下载失败，会提示访问 https://git-scm.com/download/win
+
+### macOS
+- 提示使用 Homebrew 安装：`brew install git`
+- 如未安装 Homebrew，会提示访问 https://brew.sh/
+
+### Linux
+- 提示使用系统包管理器安装：
+  - Ubuntu/Debian: `sudo apt-get install git`
+  - CentOS/RHEL: `sudo yum install git`
+  - Fedora: `sudo dnf install git`
+  - Arch: `sudo pacman -S git`
+
+## 许可证
+
+MIT
+
+## 作者
+
+workskills.store

package/index.js

@@ -0,0 +1,578 @@
+#!/usr/bin/env node
+
+const https = require('https');
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { exec } = require('child_process');
+
+/**
+ * 检查 Git 是否已安装
+ */
+async function checkGitInstalled() {
+    try {
+        await executeCommand('git --version');
+        return true;
+    } catch (error) {
+        return false;
+    }
+}
+
+/**
+ * 获取 Git 下载链接（根据操作系统）
+ */
+function getGitDownloadUrl() {
+    const platform = os.platform();
+    const arch = os.arch();
+
+    switch (platform) {
+        case 'win32':
+            // Windows
+            if (arch === 'x64') {
+                return 'https://github.com/git-for-windows/git/releases/download/v2.44.0.windows.1/Git-2.44.0-64-bit.exe';
+            } else {
+                return 'https://github.com/git-for-windows/git/releases/download/v2.44.0.windows.1/Git-2.44.0-32-bit.exe';
+            }
+        case 'darwin':
+            // macOS - 提示使用 Homebrew
+            return 'homebrew'; // 特殊标记
+        case 'linux':
+            // Linux - 提示使用包管理器
+            return 'package-manager'; // 特殊标记
+        default:
+            return null;
+    }
+}
+
+/**
+ * 下载文件
+ */
+function downloadFile(url, destPath) {
+    return new Promise((resolve, reject) => {
+        const urlObj = new URL(url);
+        const protocol = urlObj.protocol === 'https:' ? https : http;
+
+        const file = fs.createWriteStream(destPath);
+
+        protocol.get(url, (response) => {
+            // 处理重定向
+            if (response.statusCode === 301 || response.statusCode === 302) {
+                file.close();
+                fs.unlinkSync(destPath);
+                return downloadFile(response.headers.location, destPath)
+                    .then(resolve)
+                    .catch(reject);
+            }
+
+            if (response.statusCode !== 200) {
+                file.close();
+                fs.unlinkSync(destPath);
+                return reject(new Error(`下载失败，状态码: ${response.statusCode}`));
+            }
+
+            const totalSize = parseInt(response.headers['content-length'], 10);
+            let downloadedSize = 0;
+
+            response.on('data', (chunk) => {
+                downloadedSize += chunk.length;
+                const percent = ((downloadedSize / totalSize) * 100).toFixed(2);
+                process.stdout.write(`\r下载进度: ${percent}%`);
+            });
+
+            response.pipe(file);
+
+            file.on('finish', () => {
+                file.close();
+                console.log('\n下载完成！');
+                resolve(destPath);
+            });
+        }).on('error', (err) => {
+            file.close();
+            fs.unlinkSync(destPath);
+            reject(err);
+        });
+    });
+}
+
+/**
+ * 安装 Git
+ */
+async function installGit() {
+    const platform = os.platform();
+    const downloadUrl = getGitDownloadUrl();
+
+    console.log('检测到系统未安装 Git，正在准备安装...\n');
+
+    if (downloadUrl === 'homebrew') {
+        console.log('macOS 系统检测到未安装 Git');
+        console.log('请使用以下命令安装 Git:\n');
+        console.log('  brew install git');
+        console.log('\n如果未安装 Homebrew，请访问: https://brew.sh/');
+        throw new Error('请先安装 Git 后再运行此命令');
+    }
+
+    if (downloadUrl === 'package-manager') {
+        console.log('Linux 系统检测到未安装 Git');
+        console.log('请使用系统包管理器安装 Git:\n');
+        console.log('  Ubuntu/Debian: sudo apt-get install git');
+        console.log('  CentOS/RHEL:   sudo yum install git');
+        console.log('  Fedora:        sudo dnf install git');
+        console.log('  Arch:          sudo pacman -S git');
+        throw new Error('请先安装 Git 后再运行此命令');
+    }
+
+    if (platform === 'win32') {
+        console.log('Windows 系统检测到未安装 Git');
+        console.log('正在下载 Git 安装程序...\n');
+
+        const tempDir = os.tmpdir();
+        const installerPath = path.join(tempDir, 'git-installer.exe');
+
+        try {
+            await downloadFile(downloadUrl, installerPath);
+            console.log(`\nGit 安装程序已下载到: ${installerPath}`);
+            console.log('\n正在启动安装程序，请按照提示完成安装...');
+            console.log('安装完成后，请重新运行此命令。\n');
+
+            // 启动安装程序
+            exec(`"${installerPath}"`, (error) => {
+                if (error) {
+                    console.error('启动安装程序失败:', error.message);
+                }
+            });
+
+            throw new Error('请完成 Git 安装后重新运行此命令');
+        } catch (error) {
+            console.error('\n下载 Git 安装程序失败:', error.message);
+            console.log('\n您可以手动访问以下网址下载 Git:');
+            console.log('https://git-scm.com/download/win');
+            throw new Error('请先安装 Git 后再运行此命令');
+        }
+    }
+}
+
+/**
+ * 确保 Git 已安装
+ */
+async function ensureGitInstalled() {
+    const isInstalled = await checkGitInstalled();
+    if (!isInstalled) {
+        await installGit();
+    }
+    return true;
+}
+
+/**
+ * 获取 OpenClaw skills 目录路径（根据操作系统）
+ */
+function getSkillsDirectory() {
+    const platform = os.platform();
+    const homeDir = os.homedir();
+
+    switch (platform) {
+        case 'win32':
+            // Windows: %USERPROFILE%\.claude\skills
+            return path.join(homeDir, '.claude', 'skills');
+        case 'darwin':
+            // macOS: ~/.claude/skills
+            return path.join(homeDir, '.claude', 'skills');
+        case 'linux':
+            // Linux: ~/.claude/skills
+            return path.join(homeDir, '.claude', 'skills');
+        default:
+            // 默认使用 ~/.claude/skills
+            return path.join(homeDir, '.claude', 'skills');
+    }
+}
+
+/**
+ * 确保目录存在
+ */
+function ensureDirectoryExists(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+
+/**
+ * HTTP/HTTPS 请求封装
+ */
+function request(url, options = {}) {
+    return new Promise((resolve, reject) => {
+        const urlObj = new URL(url);
+        const protocol = urlObj.protocol === 'https:' ? https : http;
+
+        const reqOptions = {
+            hostname: urlObj.hostname,
+            port: urlObj.port,
+            path: urlObj.pathname + urlObj.search,
+            method: options.method || 'GET',
+            headers: options.headers || {}
+        };
+
+        const req = protocol.request(reqOptions, (res) => {
+            let data = '';
+
+            res.on('data', (chunk) => {
+                data += chunk;
+            });
+
+            res.on('end', () => {
+                if (res.statusCode >= 200 && res.statusCode < 300) {
+                    resolve({
+                        statusCode: res.statusCode,
+                        headers: res.headers,
+                        body: data
+                    });
+                } else {
+                    reject(new Error(`Request failed with status code ${res.statusCode}`));
+                }
+            });
+        });
+
+        req.on('error', (err) => {
+            reject(err);
+        });
+
+        if (options.body) {
+            req.write(options.body);
+        }
+
+        req.end();
+    });
+}
+
+/**
+ * 执行命令
+ */
+function executeCommand(command, cwd) {
+    return new Promise((resolve, reject) => {
+        exec(command, { cwd, maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
+            if (error) {
+                reject(error);
+            } else {
+                resolve({ stdout, stderr });
+            }
+        });
+    });
+}
+
+/**
+ * 搜索技能（从 getskill.work API）
+ * @param {string} keyword - 搜索关键词
+ * @returns {Promise<Array>} 技能列表（包含 git 地址）
+ */
+async function searchSkills(keyword) {
+    const url = `https://getskill.work/api/skills/search?q=${encodeURIComponent(keyword)}`;
+
+    try {
+        const response = await request(url);
+        const data = JSON.parse(response.body);
+        // 返回格式: [{ name, description, git_url, author, ... }]
+        return data.skills || [];
+    } catch (error) {
+        console.error('搜索技能失败:', error.message);
+        throw error;
+    }
+}
+
+/**
+ * 获取技能详情（包含 git 地址）
+ * @param {string} skillId - 技能ID
+ * @returns {Promise<Object>} 技能详情
+ */
+async function getSkillDetail(skillId) {
+    const url = `https://getskill.work/api/skills/${skillId}`;
+
+    try {
+        const response = await request(url);
+        const data = JSON.parse(response.body);
+        // 返回格式: { name, description, git_url, files, ... }
+        return data;
+    } catch (error) {
+        console.error('获取技能详情失败:', error.message);
+        throw error;
+    }
+}
+
+/**
+ * 获取技能仓库缓存目录
+ */
+function getSkillsCacheDirectory() {
+    const homeDir = os.homedir();
+    return path.join(homeDir, '.claude', 'skills-cache');
+}
+
+/**
+ * 克隆或更新 Git 仓库
+ * @param {string} gitUrl - Git 仓库地址
+ * @param {string} skillName - 技能名称
+ * @returns {Promise<string>} 本地仓库路径
+ */
+async function cloneOrUpdateRepo(gitUrl, skillName) {
+    // 首先检查并确保 Git 已安装
+    await ensureGitInstalled();
+
+    const cacheDir = getSkillsCacheDirectory();
+    ensureDirectoryExists(cacheDir);
+
+    const repoPath = path.join(cacheDir, skillName);
+
+    if (fs.existsSync(repoPath)) {
+        // 仓库已存在，执行 git pull
+        console.log(`更新仓库: ${skillName}...`);
+        try {
+            await executeCommand('git pull', repoPath);
+            console.log(`仓库更新成功: ${repoPath}`);
+        } catch (error) {
+            console.error(`更新失败: ${error.message}`);
+            throw error;
+        }
+    } else {
+        // 克隆新仓库
+        console.log(`克隆仓库: ${gitUrl}...`);
+        try {
+            await executeCommand(`git clone "${gitUrl}" "${skillName}"`, cacheDir);
+            console.log(`仓库克隆成功: ${repoPath}`);
+        } catch (error) {
+            console.error(`克隆失败: ${error.message}`);
+            throw error;
+        }
+    }
+
+    return repoPath;
+}
+
+/**
+ * 从仓库复制技能文件到 skills 目录
+ * @param {string} repoPath - 仓库路径
+ * @param {string} skillName - 技能名称
+ */
+function copySkillFiles(repoPath) {
+    const skillsDir = getSkillsDirectory();
+    ensureDirectoryExists(skillsDir);
+
+    // 查找仓库中的 .md 文件
+    const files = fs.readdirSync(repoPath);
+    const mdFiles = files.filter(file =>
+        file.endsWith('.md') &&
+        !file.toLowerCase().startsWith('readme')
+    );
+
+    if (mdFiles.length === 0) {
+        throw new Error(`在仓库中未找到技能 .md 文件`);
+    }
+
+    const copiedFiles = [];
+    mdFiles.forEach(file => {
+        const sourcePath = path.join(repoPath, file);
+        const targetPath = path.join(skillsDir, file);
+
+        fs.copyFileSync(sourcePath, targetPath);
+        console.log(`已复制: ${file} -> ${targetPath}`);
+        copiedFiles.push(targetPath);
+    });
+
+    return copiedFiles;
+}
+
+/**
+ * 下载技能（通过 Git）
+ * @param {string} skillIdOrName - 技能ID或名称
+ */
+async function downloadSkill(skillIdOrName) {
+    try {
+        console.log(`获取技能信息: ${skillIdOrName}...`);
+        const skillDetail = await getSkillDetail(skillIdOrName);
+
+        if (!skillDetail.git_url) {
+            throw new Error('技能信息中未包含 git_url');
+        }
+
+        const skillName = skillDetail.name || skillIdOrName;
+        const repoPath = await cloneOrUpdateRepo(skillDetail.git_url, skillName);
+        const copiedFiles = copySkillFiles(repoPath);
+
+        return {
+            skillName,
+            repoPath,
+            files: copiedFiles
+        };
+    } catch (error) {
+        console.error(`下载技能失败: ${error.message}`);
+        throw error;
+    }
+}
+
+/**
+ * 更新技能（通过 Git）
+ * @param {string} skillName - 技能名称
+ */
+async function updateSkill(skillName) {
+    try {
+        console.log(`正在更新技能: ${skillName}...`);
+
+        const cacheDir = getSkillsCacheDirectory();
+        const repoPath = path.join(cacheDir, skillName);
+
+        if (!fs.existsSync(repoPath)) {
+            console.log(`技能仓库不存在，将重新下载...`);
+            return await downloadSkill(skillName);
+        }
+
+        // 执行 git pull
+        await executeCommand('git pull', repoPath);
+        console.log(`Git 仓库已更新`);
+
+        // 复制文件到 skills 目录
+        const copiedFiles = copySkillFiles(repoPath);
+
+        console.log(`技能 ${skillName} 更新成功！`);
+        return {
+            skillName,
+            repoPath,
+            files: copiedFiles
+        };
+    } catch (error) {
+        console.error(`更新技能 ${skillName} 失败:`, error.message);
+        throw error;
+    }
+}
+
+/**
+ * 列出本地已安装的技能
+ */
+function listLocalSkills() {
+    const skillsDir = getSkillsDirectory();
+
+    if (!fs.existsSync(skillsDir)) {
+        console.log('技能目录不存在');
+        return [];
+    }
+
+    const files = fs.readdirSync(skillsDir);
+    const skillFiles = files.filter(file => file.endsWith('.md'));
+
+    return skillFiles;
+}
+
+/**
+ * 命令行接口
+ */
+async function cli() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+
+    try {
+        switch (command) {
+            case 'search':
+                if (!args[1]) {
+                    console.error('请提供搜索关键词');
+                    console.log('用法: getskill search <关键词>');
+                    process.exit(1);
+                }
+                const results = await searchSkills(args[1]);
+                console.log(`找到 ${results.length} 个技能:\n`);
+                results.forEach((skill, index) => {
+                    console.log(`${index + 1}. ${skill.name}`);
+                    if (skill.description) {
+                        console.log(`   描述: ${skill.description}`);
+                    }
+                    if (skill.git_url) {
+                        console.log(`   Git: ${skill.git_url}`);
+                    }
+                    if (skill.author) {
+                        console.log(`   作者: ${skill.author}`);
+                    }
+                    console.log('');
+                });
+                break;
+
+            case 'install':
+            case 'get':
+            case 'download':
+                if (!args[1]) {
+                    console.error('请提供技能ID或名称');
+                    console.log('用法: getskill install <技能名称>');
+                    process.exit(1);
+                }
+                const result = await downloadSkill(args[1]);
+                console.log(`\n技能已安装到 skills 目录:`);
+                result.files.forEach(file => console.log(`  - ${file}`));
+                console.log(`\nGit 仓库缓存: ${result.repoPath}`);
+                break;
+
+            case 'update':
+                if (!args[1]) {
+                    console.error('请提供技能名称');
+                    console.log('用法: getskill update <技能名称>');
+                    process.exit(1);
+                }
+                const updateResult = await updateSkill(args[1]);
+                console.log(`\n技能已更新到 skills 目录:`);
+                updateResult.files.forEach(file => console.log(`  - ${file}`));
+                break;
+
+            case 'list':
+                const skills = listLocalSkills();
+                console.log(`本地已安装的技能 (${skills.length}):`);
+                skills.forEach((skill, index) => {
+                    console.log(`${index + 1}. ${skill}`);
+                });
+                break;
+
+            case 'path':
+                console.log(`技能目录: ${getSkillsDirectory()}`);
+                console.log(`缓存目录: ${getSkillsCacheDirectory()}`);
+                break;
+
+            case 'clean':
+                const cacheDir = getSkillsCacheDirectory();
+                if (fs.existsSync(cacheDir)) {
+                    fs.rmSync(cacheDir, { recursive: true, force: true });
+                    console.log(`已清理缓存目录: ${cacheDir}`);
+                } else {
+                    console.log('缓存目录不存在');
+                }
+                break;
+
+            default:
+                console.log('GetSkill - OpenClaw 技能管理工具');
+                console.log('');
+                console.log('用法:');
+                console.log('  getskill search <关键词>    - 从 getskill.work 搜索技能');
+                console.log('  getskill install <技能名称> - 通过 git clone 安装技能');
+                console.log('  getskill update <技能名称>  - 通过 git pull 更新技能');
+                console.log('  getskill list               - 列出本地技能');
+                console.log('  getskill path               - 显示目录路径');
+                console.log('  getskill clean              - 清理 git 缓存');
+                console.log('');
+                console.log(`技能目录: ${getSkillsDirectory()}`);
+                console.log(`缓存目录: ${getSkillsCacheDirectory()}`);
+        }
+    } catch (error) {
+        console.error('执行命令时出错:', error.message);
+        process.exit(1);
+    }
+}
+
+// 导出模块函数
+module.exports = {
+    searchSkills,
+    getSkillDetail,
+    downloadSkill,
+    updateSkill,
+    listLocalSkills,
+    getSkillsDirectory,
+    getSkillsCacheDirectory,
+    cloneOrUpdateRepo,
+    copySkillFiles,
+    checkGitInstalled,
+    ensureGitInstalled
+};
+
+// 如果直接运行此文件，执行 CLI
+if (require.main === module) {
+    cli();
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+    "name": "@workskills/getskill",
+    "version": "1.0.0",
+    "description": "Search, install, and update OpenClaw skills from getskill.work with automatic Git integration",
+    "main": "index.js",
+    "bin": {
+        "getskill": "./index.js"
+    },
+    "scripts": {
+        "test": "node verify.js",
+        "verify": "node verify.js",
+        "start": "node index.js",
+        "prepublishOnly": "npm run verify"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/workskills/getskill.git"
+    },
+    "bugs": {
+        "url": "https://github.com/workskills/getskill/issues"
+    },
+    "homepage": "https://github.com/workskills/getskill#readme",
+    "keywords": [
+        "openclaw",
+        "workskills",
+        "skill",
+        "skills",
+        "search",
+        "install",
+        "update",
+        "git",
+        "cli",
+        "claude",
+        "ai",
+        "automation"
+    ],
+    "author": {
+        "name": "workskills.store",
+        "url": "https://workskills.store"
+    },
+    "license": "MIT",
+    "engines": {
+        "node": ">=12.0.0"
+    },
+    "os": [
+        "darwin",
+        "linux",
+        "win32"
+    ],
+    "files": [
+        "index.js",
+        "README.md",
+        "EXAMPLES.md",
+        "LICENSE"
+    ],
+    "dependencies": {},
+    "devDependencies": {}
+}