@xd-skill/cli

心动 Skill Hub 命令行工具。安装、发布、管理 Claude / Codex / ClawHub 的 skill 包。

安装

要求 Node ≥ 22。

npm  i -g @xd-skill/cli
pnpm add -g @xd-skill/cli
yarn global add @xd-skill/cli

# 或者不全局装,一次性运行
npx -y @xd-skill/cli --help

验证:

xd-skill --version

快速上手

# 1. 登录(浏览器走 SSO device flow)
xd-skill login
xd-skill whoami

# 2. 找 skill
xd-skill search <keyword>
xd-skill inspect <slug>

# 3. 装到当前项目
xd-skill install <slug>          # 解压到 ./skills/<slug>/
xd-skill list                    # 当前 workdir 已装 skill

# 4. 发布
xd-skill init                    # 在当前目录生成 SKILL.md 模板（Agent Skills 格式）
xd-skill publish ./my-skill      # 打包 zip 上传并触发机审
xd-skill publish ./my-skill --wait  # 阻塞直到机审完成

CI / headless 场景:在 Web Settings → API Tokens 创建 xdsk_user_* token,通过环境变量注入,无需交互登录。

export XD_SKILL_TOKEN=xdsk_user_xxxxxxxx
xd-skill whoami

命令分布

| Namespace | 命令 | |---|---| | 根(高频) | init · publish · install · list · search · inspect · whoami | | auth | auth login [--with-token] · auth logout · auth device {code,status,authorize} | | skill(服务端操作) | skill {rename,merge,delete,undelete,star,unstar,explore} | | local(项目级 lock.json) | local {update,pin,unpin,uninstall} | | transfer | transfer {request,list,accept,reject,cancel} |

所有命令支持 --help。

配置

• 用户配置:~/.xd-skill-hub/config.json(session token、默认 registry)
• 项目 lock:<workdir>/.xd-skill-hub/lock.json(已装 skill 索引)
• Registry 默认 https://skills.xindong.com,可用 --registry、XD_SKILL_REGISTRY 或配置文件覆盖
• Workdir 默认 cwd,可用 --workdir <path> 或 XD_SKILL_WORKDIR 覆盖

文档

• 完整文档:https://skills.xindong.com
• 机器可读摘要(给 AI agent):https://skills.xindong.com/llms.txt

License

Proprietary — © 心动网络 xd-platform。仅供 xd-platform / 心动内部使用,未经授权不得复制、分发或用于商业目的。