@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 键自动补全

安装

npm install -g @empjs/skill

技能存储位置

⚠️ 重要变化：技能现在存储在 eskill 包目录 下

• 存储位置：node_modules/@empjs/skill/skills-storage/
• 优点：npm uninstall -g @empjs/skill 时会自动删除所有技能
• 说明：无需手动清理，卸载即删除

使用

1. 搜索技能（首次使用需配置 API Key）

# 首次搜索会提示配置 API Key
eskill search "git"

# 配置 API Key
eskill config set-api-key
# 访问 https://skillsmp.com/docs/api 获取免费 API Key

# 查看配置状态
eskill config status

2. 安装技能

# 从 GitHub URL 安装
eskill install https://github.com/anthropics/skills

# 强制覆盖已存在的技能
eskill install <url> --force

3. 管理技能

# 列出已安装的技能
eskill list
eskill ls

# 删除技能
eskill remove <skill-name>
eskill rm <skill-name>

4. 卸载 eskill（自动删除所有技能）

npm uninstall -g @empjs/skill
# 所有技能会自动删除，无需手动清理

5. 自动补全

# 安装自动补全
eskill completion >> ~/.bashrc
source ~/.bashrc

# 使用 Tab 补全
eskill remove <Tab>  # 显示已安装的技能

命令参考

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 的配置文件

开发

# 克隆项目
git clone <repo>
cd skill-manager

# 安装依赖
npm install

# 全局链接（用于测试）
npm link

# 运行安全检查
npm run security-check

许可证

MIT