eskill 1.0.6

package/README.md

@@ -0,0 +1,147 @@
+# @empjs/skill
+
+Unified AI Agent Skills Management - Install skills from Git URLs
+
+从 GitHub/GitLab URL 直接安装 Claude、Cursor、Windsurf 等 AI 编程助手的技能。
+
+## 功能
+
+- ✅ 从 Git URL 安装技能
+- ✅ 搜索 99,749+ 技能（通过 SkillsMP API）
+- ✅ 列出已安装的技能
+- ✅ 删除技能
+- ✅ **技能存储在 eskill 包目录，卸载时自动删除**
+- ✅ Tab 键自动补全
+
+## 安装
+
+```bash
+npm install -g @empjs/skill
+```
+
+## 技能存储位置
+
+⚠️ **重要变化**：技能现在存储在 **eskill 包目录** 下
+
+- **存储位置**：`node_modules/@empjs/skill/skills-storage/`
+- **优点**：`npm uninstall -g @empjs/skill` 时会自动删除所有技能
+- **说明**：无需手动清理，卸载即删除
+
+## 使用
+
+### 1. 搜索技能（首次使用需配置 API Key）
+
+```bash
+# 首次搜索会提示配置 API Key
+eskill search "git"
+
+# 配置 API Key
+eskill config set-api-key
+# 访问 https://skillsmp.com/docs/api 获取免费 API Key
+
+# 查看配置状态
+eskill config status
+```
+
+### 2. 安装技能
+
+```bash
+# 从 GitHub URL 安装
+eskill install https://github.com/anthropics/skills
+
+# 强制覆盖已存在的技能
+eskill install <url> --force
+```
+
+### 3. 管理技能
+
+```bash
+# 列出已安装的技能
+eskill list
+eskill ls
+
+# 删除技能
+eskill remove <skill-name>
+eskill rm <skill-name>
+```
+
+### 4. 卸载 eskill（自动删除所有技能）
+
+```bash
+npm uninstall -g @empjs/skill
+# 所有技能会自动删除，无需手动清理
+```
+
+### 5. 自动补全
+
+```bash
+# 安装自动补全
+eskill completion >> ~/.bashrc
+source ~/.bashrc
+
+# 使用 Tab 补全
+eskill remove <Tab>  # 显示已安装的技能
+```
+
+## 命令参考
+
+```bash
+eskill install <url>    # 安装技能
+eskill add <url>        # 同上（别名）
+eskill search <query>   # 搜索技能
+eskill list             # 列出已安装技能
+eskill ls               # 同上（别名）
+eskill remove <name>    # 删除技能
+eskill rm <name>        # 同上（别名）
+eskill config <action>  # 配置管理
+eskill agents           # 列出支持的 agents
+eskill completion       # 生成自动补全脚本
+```
+
+## 项目结构
+
+```
+skill-manager/
+├── cli.js                   # CLI 入口
+├── lib/                     # 核心代码
+│   ├── agent-config.js
+│   ├── completion.js
+│   ├── config.js
+│   ├── git-url-parser.js
+│   ├── installer.js
+│   ├── npm-installer.js
+│   └── search.js
+├── skills-storage/          # 技能存储目录（卸载时自动删除）
+│   └── .gitkeep
+└── package.json
+```
+
+## 安全注意事项
+
+⚠️ **重要**：
+
+1. **API Key 存储位置**：`~/.eskill/config.json`
+2. **已配置 `.gitignore`**：`.eskill/` 目录不会被上传到 Git
+3. **已配置 `.npmignore`**：敏感文件不会被发布到 npm
+4. **请勿提交**：包含 API Key 的配置文件
+
+## 开发
+
+```bash
+# 克隆项目
+git clone <repo>
+cd skill-manager
+
+# 安装依赖
+npm install
+
+# 全局链接（用于测试）
+npm link
+
+# 运行安全检查
+npm run security-check
+```
+
+## 许可证
+
+MIT

package/cli.js

@@ -0,0 +1,206 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import ora from 'ora';
+import { installFromGitUrl, listSkills, removeSkill } from './lib/installer.js';
+import { AGENTS, getDefaultAgent } from './lib/agent-config.js';
+import { bashCompletionScript, zshCompletionScript, listSkillsForCompletion } from './lib/completion.js';
+import { searchSkills, formatSkillList } from './lib/search.js';
+import { setApiKey, showConfigStatus } from './lib/config.js';
+import readline from 'readline';
+
+const program = new Command();
+
+program
+  .name('eskill')
+  .description('Unified AI Agent Skills Management - Install skills from Git URLs')
+  .version('1.0.0');
+
+// 安装命令
+program
+  .command('install')
+  .alias('add')
+  .description('从 Git URL 安装技能')
+  .argument('<url>', 'GitHub/GitLab URL')
+  .option('-a, --agent <name>', '目标 agent', getDefaultAgent())
+  .option('-l, --link', '使用符号链接而非复制', false)
+  .option('-f, --force', '强制覆盖已存在的技能', false)
+  .action(async (url, options) => {
+    const spinner = ora('正在安装技能...').start();
+
+    try {
+      await installFromGitUrl(url, options);
+      spinner.succeed('技能安装成功');
+    } catch (error) {
+      spinner.fail(`安装失败: ${error.message}`);
+      process.exit(1);
+    }
+  });
+
+// 列出命令
+program
+  .command('list')
+  .alias('ls')
+  .description('列出已安装的技能')
+  .option('-a, --agent <name>', '目标 agent', getDefaultAgent())
+  .action(async (options) => {
+    try {
+      const skills = await listSkills(options.agent);
+
+      if (skills.length === 0) {
+        console.log('未安装任何技能');
+        return;
+      }
+
+      console.log(`\nskill仓库目录:\n`);
+      skills.forEach(skill => {
+        console.log(`  • ${skill.name}`);
+      });
+      console.log('');
+    } catch (error) {
+      console.error(`错误: ${error.message}`);
+      process.exit(1);
+    }
+  });
+
+// 删除命令
+program
+  .command('remove')
+  .alias('rm')
+  .alias('uninstall')
+  .description('删除已安装的技能')
+  .argument('<name>', '技能名称')
+  .option('-a, --agent <name>', '目标 agent', getDefaultAgent())
+  .action(async (name, options) => {
+    try {
+      removeSkill(name, options.agent);
+    } catch (error) {
+      console.error(`错误: ${error.message}`);
+      process.exit(1);
+    }
+  });
+
+// 搜索命令
+program
+  .command('search')
+  .description('搜索技能 (SkillsMP)')
+  .argument('<query>', '搜索关键词')
+  .option('-p, --page <number>', '页码', '1')
+  .option('-l, --limit <number>', '每页数量 (max: 100)', '20')
+  .option('-s, --sort <by>', '排序方式 (stars/recent)', 'stars')
+  .option('--ai', '使用 AI 语义搜索', false)
+  .action(async (query, options) => {
+    const spinner = ora('正在搜索...').start();
+
+    try {
+      const result = await searchSkills(query, {
+        page: parseInt(options.page),
+        limit: parseInt(options.limit),
+        sortBy: options.sort,
+        ai: options.ai
+      });
+
+      spinner.stop();
+
+      if (result.success === false) {
+        if (result.needsApiKey) {
+          console.log('\n❌ 首次使用需要配置 SkillsMP API Key\n');
+          console.log('📝 获取步骤:');
+          console.log('   1. 访问: https://skillsmp.com/docs/api');
+          console.log('   2. 注册并获取免费的 API Key');
+          console.log('   3. 运行命令配置: eskill config set-api-key\n');
+          console.log('💡 配置后即可搜索 99,749+ 个技能\n');
+        } else {
+          console.error(`搜索失败: ${result.error?.message || '未知错误'}`);
+        }
+        process.exit(1);
+      }
+
+      const skills = result.data || result.skills || result.results || [];
+      console.log(formatSkillList(skills));
+
+      // 显示分页信息
+      if (result.totalPages || result.total) {
+        console.log(`总计: ${result.total || skills.length} 个技能\n`);
+      }
+
+      // 显示安装提示
+      if (skills.length > 0) {
+        console.log('💡 使用以下命令安装技能:');
+        console.log(`   eskill install <GitHub URL>\n`);
+      }
+    } catch (error) {
+      spinner.fail(`搜索失败: ${error.message}`);
+      process.exit(1);
+    }
+  });
+
+// 配置命令
+program
+  .command('config')
+  .description('配置管理')
+  .argument('<action>', '操作: set-api-key, status')
+  .action(async (action) => {
+    if (action === 'set-api-key') {
+      const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+      });
+
+      rl.question('请输入 SkillsMP API Key: ', (apiKey) => {
+        if (apiKey.trim()) {
+          setApiKey(apiKey.trim());
+          console.log('\n✓ API Key 已配置成功');
+          console.log('现在可以使用 eskill search 搜索技能了\n');
+        } else {
+          console.log('\n✗ API Key 不能为空\n');
+        }
+        rl.close();
+      });
+    } else if (action === 'status') {
+      showConfigStatus();
+    } else {
+      console.log('\n未知操作。支持的操作:');
+      console.log('  set-api-key - 设置 API Key');
+      console.log('  status      - 查看配置状态\n');
+    }
+  });
+
+// 列出支持的 agents
+program
+  .command('agents')
+  .alias('list-agents')
+  .description('列出支持的 agents')
+  .action(() => {
+    console.log('\n支持的 Agents:\n');
+    Object.entries(AGENTS).forEach(([key, config]) => {
+      console.log(`  • ${key.padEnd(12)} - ${config.name}`);
+      console.log(`    ${config.skillDir}\n`);
+    });
+  });
+
+// 自动补全命令
+program
+  .command('completion')
+  .description('生成自动补全脚本')
+  .option('-s, --shell <type>', 'Shell 类型 (bash/zsh)', 'bash')
+  .action((options) => {
+    const shell = options.shell.toLowerCase();
+    if (shell === 'bash') {
+      console.log(bashCompletionScript());
+    } else if (shell === 'zsh') {
+      console.log(zshCompletionScript());
+    } else {
+      console.error(`不支持的 shell 类型: ${shell}`);
+      process.exit(1);
+    }
+  });
+
+// 内部命令：列出技能（用于自动补全）
+program
+  .command('_list_skills')
+  .description('(内部命令) 列出技能名称')
+  .action(async () => {
+    await listSkillsForCompletion();
+  });
+
+program.parse();

package/lib/agent-config.js

@@ -0,0 +1,55 @@
+/**
+ * 获取不同 Agent 的技能目录
+ */
+export const AGENTS = {
+  claude: {
+    name: 'Claude Code',
+    skillDir: '~/Desktop/skill-manager/skills-Repository'
+  },
+  cursor: {
+    name: 'Cursor',
+    skillDir: '~/.cursor/skills'
+  },
+  windsurf: {
+    name: 'Windsurf',
+    skillDir: '~/.windsurf/skills'
+  },
+  gemini: {
+    name: 'Gemini Code',
+    skillDir: '~/.gemini/skills'
+  },
+  copilot: {
+    name: 'GitHub Copilot',
+    skillDir: '~/.copilot/skills'
+  },
+  opencode: {
+    name: 'OpenCode',
+    skillDir: '~/.opencode/skills'
+  },
+  codex: {
+    name: 'Codex CLI',
+    skillDir: '~/.codex/skills'
+  },
+  continue: {
+    name: 'Continue',
+    skillDir: '~/.continue/skills'
+  },
+  centralized: {
+    name: 'Centralized',
+    skillDir: '~/.emp-agent/skills'
+  }
+};
+
+/**
+ * 获取默认 agent（优先使用 Claude Code）
+ */
+export function getDefaultAgent() {
+  return 'claude';
+}
+
+/**
+ * 展开路径中的 ~
+ */
+export function expandHomePath(path) {
+  return path.replace(/^~\//, `${process.env.HOME}/`);
+}

package/lib/completion.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+/**
+ * eskill 命令自动补全脚本
+ * 安装方法：
+ *   eskill completion >> ~/.bashrc
+ *   eskill completion >> ~/.zshrc
+ */
+import { listSkills } from './installer.js';
+import { getDefaultAgent } from './agent-config.js';
+
+// 获取已安装的技能列表
+async function getSkillList() {
+  try {
+    const agent = getDefaultAgent();
+    const skills = await listSkills(agent);
+    return skills.map(s => s.name);
+  } catch {
+    return [];
+  }
+}
+
+// Bash 补全脚本
+export function bashCompletionScript() {
+  return '\n_eskill_completion() {\n' +
+    '  local cur prev words cword\n' +
+    '  _init_completion || return\n\n' +
+    '  case ${prev} in\n' +
+    '    remove|rm|uninstall)\n' +
+    '      local skills=$(eskill _list_skills 2>/dev/null)\n' +
+    '      COMPREPLY=($(compgen -W "${skills}" -- "${cur}"))\n' +
+    '      ;;\n' +
+    '    *)\n' +
+    '      case ${cur} in\n' +
+    '        -*)\n' +
+    '          COMPREPLY=($(compgen -W "-a --agent -l --link -f --force -h --help -V --version" -- "${cur}"))\n' +
+    '          ;;\n' +
+    '        *)\n' +
+    '          COMPREPLY=($(compgen -W "install add list ls remove rm uninstall agents list-agents help" -- "${cur}"))\n' +
+    '          ;;\n' +
+    '      esac\n' +
+    '      ;;\n' +
+    '  esac\n' +
+    '}\n\n' +
+    'complete -F _eskill_completion eskill\n';
+}
+
+// Zsh 补全脚本
+export function zshCompletionScript() {
+  return '\n#compdef eskill\n\n' +
+    '_eskill() {\n' +
+    '  local -a commands\n' +
+    '  commands=(\n' +
+    '    \'install:从 Git URL 安装技能\'\n' +
+    '    \'add:从 Git URL 安装技能（别名）\'\n' +
+    '    \'list:列出已安装的技能\'\n' +
+    '    \'ls:列出已安装的技能（别名）\'\n' +
+    '    \'remove:删除已安装的技能\'\n' +
+    '    \'rm:删除已安装的技能（别名）\'\n' +
+    '    \'uninstall:删除已安装的技能（别名）\'\n' +
+    '    \'agents:列出支持的 agents\'\n' +
+    '    \'list-agents:列出支持的 agents（别名）\'\n' +
+    '    \'help:显示帮助信息\'\n' +
+    '  )\n\n' +
+    '  if [[ ${words[(I)(remove|rm|uninstall)]} -gt 0 ]]; then\n' +
+    '    local skills=($(eskill _list_skills 2>/dev/null))\n' +
+    '    _describe \'skills\' skills\n' +
+    '  else\n' +
+    '    _describe \'command\' commands\n' +
+    '  fi\n' +
+    '}\n\n' +
+    '_eskill "$@"\n';
+}
+
+// 列出技能的内部命令
+export async function listSkillsForCompletion() {
+  const skills = await getSkillList();
+  console.log(skills.join(' '));
+}

package/lib/config.js

@@ -0,0 +1,75 @@
+/**
+ * 配置管理
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+import { homedir } from 'os';
+
+const CONFIG_DIR = join(homedir(), '.eskill');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+/**
+ * 确保配置目录存在
+ */
+function ensureConfigDir() {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+}
+
+/**
+ * 读取配置
+ */
+export function readConfig() {
+  if (existsSync(CONFIG_FILE)) {
+    try {
+      const data = readFileSync(CONFIG_FILE, 'utf-8');
+      return JSON.parse(data);
+    } catch (error) {
+      return {};
+    }
+  }
+  return {};
+}
+
+/**
+ * 写入配置
+ */
+export function writeConfig(config) {
+  ensureConfigDir();
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+/**
+ * 设置 API key
+ */
+export function setApiKey(key) {
+  const config = readConfig();
+  config.skillsmpApiKey = key;
+  writeConfig(config);
+}
+
+/**
+ * 获取 API key
+ */
+export function getApiKey() {
+  const config = readConfig();
+  return config.skillsmpApiKey || process.env.SKILLSMP_API_KEY;
+}
+
+/**
+ * 检查是否已配置 API key
+ */
+export function hasApiKey() {
+  return !!getApiKey();
+}
+
+/**
+ * 显示配置状态
+ */
+export function showConfigStatus() {
+  const config = readConfig();
+  console.log('\n配置状态:\n');
+  console.log(`  API Key: ${config.skillsmpApiKey ? '✓ 已配置' : '✗ 未配置'}`);
+  console.log(`  配置文件: ${CONFIG_FILE}\n`);
+}

package/lib/git-url-parser.js

@@ -0,0 +1,50 @@
+/**
+ * 解析 Git URL（支持 GitHub/GitLab）
+ * 支持格式：
+ * - https://github.com/user/repo/tree/main/skills/skill-name
+ * - https://gitlab.com/user/repo/-/tree/main/skills/skill-name
+ * - https://github.com/user/repo
+ */
+export function parseGitUrl(url) {
+  const patterns = [
+    // GitHub with tree and path: https://github.com/user/repo/tree/branch/path/to/skill
+    {
+      regex: /^https?:\/\/github\.com\/([^\/]+)\/([^\/]+)\/tree\/([^\/]+)(?:\/(.*))?$/,
+      platform: 'github'
+    },
+    // GitLab with tree and path: https://gitlab.com/user/repo/-/tree/branch/path/to/skill
+    {
+      regex: /^https?:\/\/gitlab\.com\/([^\/]+)\/([^\/]+)\/-\/tree\/([^\/]+)(?:\/(.*))?$/,
+      platform: 'gitlab'
+    },
+    // Simple GitHub URL: https://github.com/user/repo
+    {
+      regex: /^https?:\/\/github\.com\/([^\/]+)\/([^\/]+)$/,
+      platform: 'github',
+      defaultBranch: true
+    },
+    // Simple GitLab URL: https://gitlab.com/user/repo
+    {
+      regex: /^https?:\/\/gitlab\.com\/([^\/]+)\/([^\/]+)$/,
+      platform: 'gitlab',
+      defaultBranch: true
+    }
+  ];
+
+  for (const pattern of patterns) {
+    const match = url.match(pattern.regex);
+    if (match) {
+      const [, owner, repo, branch, path] = match;
+      return {
+        platform: pattern.platform,
+        owner,
+        repo: pattern.defaultBranch ? repo : repo.replace(/\.git$/, ''),
+        branch: pattern.defaultBranch ? 'main' : branch,
+        path: path || '',
+        cloneUrl: `https://${pattern.platform === 'github' ? 'github.com' : 'gitlab.com'}/${owner}/${repo}.git`
+      };
+    }
+  }
+
+  throw new Error(`不支持的 Git URL 格式: ${url}`);
+}

package/lib/installer.js

@@ -0,0 +1,151 @@
+import { execSync } from 'child_process';
+import { existsSync, mkdirSync, symlinkSync, rmSync, readdirSync } from 'fs';
+import { join, basename, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { parseGitUrl } from './git-url-parser.js';
+import { AGENTS, expandHomePath } from './agent-config.js';
+
+/**
+ * 获取 eskill 包的安装目录
+ * 技能安装在这里，卸载时会自动删除
+ */
+function getEskillPackageDir() {
+  const __filename = fileURLToPath(import.meta.url);
+  const __dirname = dirname(__filename);
+  return dirname(__dirname); // 返回包根目录
+}
+
+/**
+ * 获取技能存储目录
+ */
+function getSkillsStorageDir() {
+  const pkgDir = getEskillPackageDir();
+  return join(pkgDir, 'skills-storage');
+}
+
+/**
+ * 从 Git URL 安装技能
+ */
+export async function installFromGitUrl(gitUrl, options = {}) {
+  const { agent = 'claude', link = false, force = false } = options;
+
+  // 解析 Git URL
+  const parsed = parseGitUrl(gitUrl);
+  console.log(`平台: ${parsed.platform}`);
+  console.log(`仓库: ${parsed.owner}/${parsed.repo}`);
+  console.log(`分支: ${parsed.branch}`);
+  if (parsed.path) {
+    console.log(`路径: ${parsed.path}`);
+  }
+
+  // 获取技能存储目录
+  const skillDir = getSkillsStorageDir();
+
+  // 确保技能目录存在
+  if (!existsSync(skillDir)) {
+    mkdirSync(skillDir, { recursive: true });
+  }
+
+  // 确定技能名称
+  const skillName = parsed.path ? basename(parsed.path) : parsed.repo;
+  const targetPath = join(skillDir, skillName);
+
+  // 检查是否已存在
+  if (existsSync(targetPath)) {
+    if (!force) {
+      throw new Error(`技能已存在: ${skillName}\n使用 --force 选项强制覆盖`);
+    }
+    console.log(`删除已存在的技能: ${targetPath}`);
+    rmSync(targetPath, { recursive: true, force: true });
+  }
+
+  // 创建临时目录
+  const tempDir = `/tmp/eskill-${Date.now()}`;
+
+  try {
+    // 克隆仓库
+    console.log(`\n克隆仓库...`);
+    const cloneUrl = parsed.cloneUrl;
+    execSync(
+      `git clone --depth 1 --branch ${parsed.branch} --single-branch ${cloneUrl} ${tempDir}`,
+      { stdio: 'inherit' }
+    );
+
+    // 确定源路径
+    const sourcePath = parsed.path ? join(tempDir, parsed.path) : tempDir;
+
+    // 验证源路径存在
+    if (!existsSync(sourcePath)) {
+      throw new Error(`路径不存在: ${sourcePath}`);
+    }
+
+    // 安装技能
+    if (link) {
+      // 使用符号链接
+      console.log(`\n创建符号链接: ${sourcePath} -> ${targetPath}`);
+      symlinkSync(sourcePath, targetPath, 'dir');
+    } else {
+      // 复制文件
+      console.log(`\n复制文件到: ${targetPath}`);
+      execSync(`cp -r "${sourcePath}" "${targetPath}"`, { stdio: 'inherit' });
+    }
+
+    console.log(`\n✓ 技能已安装到: ${targetPath}`);
+    console.log(`  存储位置: eskill 包目录`);
+    console.log(`  说明: 卸载 eskill 时会自动删除所有技能`);
+
+    return { success: true, path: targetPath };
+  } catch (error) {
+    // 清理临时目录
+    if (existsSync(tempDir)) {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+    throw error;
+  } finally {
+    // 清理临时目录（如果是符号链接则保留源）
+    if (!link && existsSync(tempDir)) {
+      rmSync(tempDir, { recursive: true, force: true });
+    }
+  }
+}
+
+/**
+ * 列出已安装的技能
+ */
+export function listSkills(agent = 'claude') {
+  const skillDir = getSkillsStorageDir();
+
+  if (!existsSync(skillDir)) {
+    return [];
+  }
+
+  // 读取目录中的技能
+  return readdirSync(skillDir, { withFileTypes: true })
+    .filter(dirent => dirent.isDirectory())
+    .map(dirent => ({
+      name: dirent.name,
+      path: join(skillDir, dirent.name)
+    }));
+}
+
+/**
+ * 删除技能
+ */
+export function removeSkill(skillName, agent = 'claude') {
+  const skillDir = getSkillsStorageDir();
+  const targetPath = join(skillDir, skillName);
+
+  if (!existsSync(targetPath)) {
+    throw new Error(`技能不存在: ${skillName}`);
+  }
+
+  rmSync(targetPath, { recursive: true, force: true });
+  console.log(`✓ 已删除技能: ${skillName}`);
+}
+
+/**
+ * 获取技能存储目录路径
+ */
+export function getSkillsDir() {
+  return getSkillsStorageDir();
+}

package/lib/npm-installer.js

@@ -0,0 +1,31 @@
+/**
+ * npm 包名解析器
+ * 支持格式：
+ * - @scope/package-name
+ * - package-name
+ * - package-name@version
+ * - @scope/package-name@version
+ */
+export function parseNpmPackageName(input) {
+  // 匹配 npm 包名（支持 scope 和版本）
+  const match = input.match(/^(@[^\/]+\/[^@]+|[^@]+)(?:@(.+))?$/);
+
+  if (!match) {
+    throw new Error(`无效的 npm 包名: ${input}`);
+  }
+
+  const [, packageName, version = 'latest'] = match;
+
+  return {
+    packageName,
+    version,
+    fullName: packageName
+  };
+}
+
+/**
+ * 检查是否为 npm 包
+ */
+export function isNpmPackage(input) {
+  return input.startsWith('@') || !input.includes('/');
+}

package/lib/search.js

@@ -0,0 +1,116 @@
+/**
+ * 技能搜索功能
+ * 支持 SkillsMP API 搜索
+ */
+import https from 'https';
+import { getApiKey } from './config.js';
+
+/**
+ * 发起 HTTPS 请求
+ */
+function httpsGet(url, headers = {}) {
+  return new Promise((resolve, reject) => {
+    https.get(url, {
+      headers: {
+        'User-Agent': 'eskill-cli/1.0.0',
+        ...headers
+      }
+    }, (res) => {
+      let data = '';
+      res.on('data', chunk => data += chunk);
+      res.on('end', () => {
+        try {
+          resolve(JSON.parse(data));
+        } catch (e) {
+          resolve({ raw: data });
+        }
+      });
+    }).on('error', reject);
+  });
+}
+
+/**
+ * SkillsMP 搜索
+ */
+async function searchSkillsMP(query, options = {}) {
+  const { page = 1, limit = 20, sortBy = 'stars', ai = false } = options;
+  const apiKey = getApiKey();
+
+  if (!apiKey) {
+    return {
+      success: false,
+      needsApiKey: true,
+      error: { message: '需要 API key' }
+    };
+  }
+
+  const endpoint = ai ? '/api/v1/skills/ai-search' : '/api/v1/skills/search';
+  let url = `https://skillsmp.com${endpoint}?q=${encodeURIComponent(query)}`;
+
+  if (!ai) {
+    url += `&page=${page}&limit=${limit}&sortBy=${sortBy}`;
+  }
+
+  try {
+    const headers = { 'Authorization': `Bearer ${apiKey}` };
+    const result = await httpsGet(url, headers);
+    return result;
+  } catch (error) {
+    throw new Error(`SkillsMP 搜索失败: ${error.message}`);
+  }
+}
+
+/**
+ * 统一搜索接口
+ */
+export async function searchSkills(query, options = {}) {
+  return await searchSkillsMP(query, options);
+}
+
+/**
+ * 格式化技能列表显示
+ */
+export function formatSkillList(skills, showIndex = true) {
+  if (!skills || skills.length === 0) {
+    return '未找到相关技能';
+  }
+
+  let output = '\n';
+  skills.forEach((skill, index) => {
+    if (showIndex) {
+      output += `  ${index + 1}. ${skill.name || skill.title}\n`;
+    } else {
+      output += `  • ${skill.name || skill.title}\n`;
+    }
+
+    if (skill.description) {
+      output += `    ${skill.description.substring(0, 80)}${skill.description.length > 80 ? '...' : ''}\n`;
+    }
+
+    if (skill.author || skill.owner) {
+      output += `    作者: ${skill.author || skill.owner}\n`;
+    }
+
+    if (skill.stars !== undefined) {
+      output += `    Stars: ⭐ ${skill.stars}\n`;
+    }
+
+    if (skill.url || skill.github_url) {
+      output += `    ${skill.url || skill.github_url}\n`;
+    }
+
+    output += '\n';
+  });
+
+  return output;
+}
+
+/**
+ * 从搜索结果中提取 GitHub URL 用于安装
+ */
+export function extractInstallUrl(skill) {
+  if (skill.github_url) return skill.github_url;
+  if (skill.url && skill.url.includes('github.com')) return skill.url;
+  if (skill.repository) return skill.repository;
+  return null;
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "eskill",
+  "version": "1.0.6",
+  "description": "Unified AI Agent Skills Management - Install skills from Git URLs",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "eskill": "./cli.js"
+  },
+  "scripts": {
+    "prepublishOnly": "node scripts/pre-publish-check.js",
+    "test": "node scripts/pre-publish-check.js",
+    "security-check": "node scripts/pre-publish-check.js"
+  },
+  "keywords": [
+    "claude",
+    "skills",
+    "agent",
+    "cursor",
+    "windsurf",
+    "git"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "ora": "^8.0.1"
+  }
+}

package/scripts/pre-publish-check.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+/**
+ * 发布前安全检查
+ * 确保没有敏感信息被包含在发布包中
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+
+console.log('🔒 安全检查中...\n');
+
+const issues = [];
+
+// 1. 检查 .eskill 目录
+const configDir = join(process.env.HOME, '.eskill');
+if (existsSync(configDir)) {
+  console.log('⚠️  警告: 检测到本地配置目录');
+  console.log(`   位置: ${configDir}`);
+  console.log('   ✅ 已被 .gitignore 和 .npmignore 忽略\n');
+}
+
+// 2. 检查 node_modules
+if (existsSync(join(process.cwd(), 'node_modules'))) {
+  console.log('✅ node_modules 存在（已忽略）');
+}
+
+// 3. 检查 .gitignore
+if (existsSync(join(process.cwd(), '.gitignore'))) {
+  const gitignore = readFileSync(join(process.cwd(), '.gitignore'), 'utf-8');
+  if (gitignore.includes('.eskill/')) {
+    console.log('✅ .gitignore 包含 .eskill/');
+  } else {
+    issues.push('.gitignore 未包含 .eskill/');
+  }
+}
+
+// 4. 检查 .npmignore
+if (existsSync(join(process.cwd(), '.npmignore'))) {
+  const npmignore = readFileSync(join(process.cwd(), '.npmignore'), 'utf-8');
+  if (npmignore.includes('.eskill/')) {
+    console.log('✅ .npmignore 包含 .eskill/');
+  } else {
+    issues.push('.npmignore 未包含 .eskill/');
+  }
+}
+
+console.log('\n📋 检查结果：');
+
+if (issues.length > 0) {
+  console.log('\n❌ 发现问题：');
+  issues.forEach(issue => console.log(`   - ${issue}`));
+  process.exit(1);
+} else {
+  console.log('\n✅ 所有检查通过！可以安全发布。');
+  console.log('\n📝 发布步骤：');
+  console.log('   npm publish');
+  console.log('   或');
+  console.log('   git push origin main\n');
+}