SafeSkill CLI 文档
通过命令行安装、查看、更新与卸载 AI Agent Skill。支持 GitHub、GitLab、本地目录与 SafeSkill Hub URL。
包名：
@safeskill/cli · 调用方式： npx safeskill环境要求
- Node.js 18 及以上
- 可访问 Skill 来源的网络
终端
node -v
npx safeskill --version快速上手
推荐使用 npx（无需全局安装）。
终端
npx safeskill --help也可全局安装后使用：
终端
npm i -g @safeskill/cli
safeskill --help首次安装 Skill
终端
npx safeskill add example-org/agent-skills仓库内若有多个 Skill，可能进入交互选择。适当时可加 -y 跳过确认。
常用命令
| 操作 | 命令 |
|---|---|
| 安装 | npx safeskill add <source> |
| 查看已安装 | npx safeskill list |
| 搜索 | npx safeskill find [keyword] |
| 检查更新 | npx safeskill check |
| 一键更新 | npx safeskill update |
| 卸载 | npx safeskill remove [skill-name] |
| 生成模板 | npx safeskill init [name] |
安装来源写法
终端
npx safeskill add owner/repo
npx safeskill add https://github.com/owner/repo
npx safeskill add https://gitlab.com/group/repo
npx safeskill add ./my-skills
npx safeskill add safeskill://official/acme/code-review@1.2.0常用参数
add： -g 全局、-a <agent> 指定 agent、-s <skill> 只装指定 Skill、-l 仅列表、-y 跳过确认、--all、--copy
remove： -g、-a、-y、--all
list： -g、-a、--json
典型场景
终端
npx safeskill add owner/repo --list
npx safeskill add owner/repo --skill code-review -y
npx safeskill add owner/repo -a claude-code -a codex -y
npx safeskill add owner/repo -g -y
npx safeskill check && npx safeskill update
npx safeskill remove my-skill -yHubserver（企业）
终端
export SAFESKILL_HUB_URL=https://hub.example.com
npx safeskill add safeskill://official/acme/code-review@1.2.0常见问题
提示 No skills found — 无有效 SKILL.md 或 front matter 缺少 name / description。
权限错误 — 检查写权限；Windows 下可试 --copy 避免符号链接限制。
指定 agent 未生效 — 确认已安装该 agent；带 -a <agent> 重新执行 add。
安全建议
- 安装前确认来源可信
- 建议先 --list，再用 --skill 精确安装
- CI 或批量场景中使用 -y 并固定 --agent、--skill
-a 参数候选值
使用 -a / --agent 指定 Agent 环境。下表为支持的 Agent 平台及对应参数。
| Agent 平台 | 参数 |
|---|---|
| Amp, Kimi Code CLI, Replit, Universal | amp,kimi-cli,replit,universal |
| Antigravity | antigravity |
| Augment | augment |
| Claude Code | claude-code |
| OpenClaw | openclaw |
| Cline, Warp | cline,warp |
| CodeBuddy | codebuddy |
| Codex | codex |
| Command Code | command-code |
| Continue | continue |
| Cortex Code | cortex |
| Crush | crush |
| Cursor | cursor |
| Deep Agents | deepagents |
| Droid | droid |
| Firebender | firebender |
| Gemini CLI | gemini-cli |
| GitHub Copilot | github-copilot |
| Goose | goose |
| Junie | junie |
| iFlow CLI | iflow-cli |
| Kilo Code | kilo |
| Kiro CLI | kiro-cli |
| Kode | kode |
| MCPJam | mcpjam |
| Mistral Vibe | mistral-vibe |
| Mux | mux |
| OpenCode | opencode |
| OpenHands | openhands |
| Pi | pi |
| Qoder | qoder |
| Qwen Code | qwen-code |
| Roo Code | roo |
| Trae | trae |
| Trae CN | trae-cn |
| Windsurf | windsurf |
| Zencoder | zencoder |
| Neovate | neovate |
| Pochi | pochi |
| AdaL | adal |