@dmall-inc/skills-cli

基于平台技能引用 URL 安装技能到本地。

安装

npm i -g @dmall-inc/skills-cli

或临时执行：

npx @dmall-inc/skills-cli add https://<host>/skills/@owner/<name> --token <wat_xxx>

说明：CLI 可以 npm i -g 全局安装；未显式指定目标时，技能默认落到 ~/.agents/skills，因此同一台机器上支持通用 skills 目录的多个 agent 都可复用。

用法

skills-cli add <url> [--token <wat_xxx>] [--target-dir <dir>] [--agents <ids>] [--yes] [--force] [--version <v>]

• url 必须是：https://<host>/skills/@owner/<name>
• token 优先级：--token > DMALL_SKILLS_TOKEN
• 在终端交互模式下，默认会先让你多选安装目标并做最终确认
• --yes：跳过最终确认；若同时传 --agents，则整次安装完全非交互
• --agents：显式指定安装目标，支持逗号分隔的多选
  • universal → ~/.agents/skills/<name>
  • claude-code → ~/.claude/skills/<name>
  • codex → ~/.codex/skills/<name>
  • openclaw → ~/.openclaw/skills/<name>
  • qoder → ~/.qoder/skills/<name>
  • hermes-agent → ~/.hermes/skills/<name>
• 未传 --target-dir 时，默认安装到：
  • ~/.agents/skills/<name>
• 默认目录如果已存在同名技能，会先移动到同级 .backup/ 下再安装新版本
• 若进入交互式多选，则会按你确认后的目标列表安装到多个目录

安装流程

1. 解析 URL 得到 owner + name
2. 调用 GET /api/open/skills/resolve
3. 调用 GET /api/open/skills/{id}/download
4. 若为交互终端，先选择安装目标并确认
5. 解压并安装到本地目录（默认目录重名时自动备份旧目录）
6. 校验目标目录内存在 SKILL.md

常见问题

• 报错 Missing token
  • 传 --token 或设置 DMALL_SKILLS_TOKEN
• 报错 HTTP 401/403
  • token 无效、无权限，或技能对当前 workspace 不可见
• 报错 Invalid install URL path
  • URL 不是 /skills/@owner/<name> 结构
• 报错 ``unzip command not found
  • 先在本机安装 unzip