domob-skill-hub

Skill Hub 的命令行工具 —— 浏览、搜索、安装团队内部的 Claude Code skills。

零运行时依赖(只用 Node 18+ 内置的 fetch / zlib),npx 拉起即用。

用法

# 安装一个 skill(默认装到当前目录下的 <slug>/)
npx domob-skill-hub install oss-upload -t ~/.claude/skills

# 需要鉴权时带上 JWT
npx domob-skill-hub install oss-upload --token <JWT> -t ~/Downloads

# 搜索 / 列表
npx domob-skill-hub search oss
npx domob-skill-hub list --sort hot

# 查看详情
npx domob-skill-hub info oss-upload

命令

| 命令 | 说明 | | --- | --- | | install <slug> | 下载并解压一个 skill,落到 <target>/<slug>/ | | uninstall <slug> | 删除已安装的 skill(别名 remove / rm) | | list [query] | 列出 / 搜索 skills(别名 search / ls) | | info <slug> | 查看某个 skill 的详情 |

选项

| 选项 | 说明 | | --- | --- | | -t, --target <dir> | 安装目录,默认当前目录;实际落到 <dir>/<slug>/ | | -f, --force | 目标已存在时覆盖 | | -r, --registry <url> | 服务地址,默认 https://skills.domob-inc.com | | --token <jwt> | 鉴权 JWT | | --sort <key> | list 排序:new / hot / liked | | -h, --help / -v, --version | 帮助 / 版本 |

环境变量:DOMOB_SKILL_HUB_REGISTRY、DOMOB_SKILL_HUB_TOKEN 可分别替代 --registry / --token。

设计要点

• 解压路径:后端打包的 zip 中,每个条目已带 <slug>/ 前缀。因此 CLI 以 --target 为基准解压,文件自然落到 <target>/<slug>/...,不会出现路径错位 (早期版本曾因「剥前缀 + 解压基准错」把文件写到 target 根、留下空的安装目录)。
• 空包拦截:服务端若返回 0 文件的合法空 zip,CLI 直接报错中止,不会静默 创建一个空目录还提示成功。
• 完整性校验:以 zip 中央目录为准定位每个文件(兼容 Go archive/zip 的 流式 data descriptor),解压后做 CRC32 与大小校验。
• 安全:防 zip-slip,拒绝 ../ 越界路径。

开发

node test/unzip.test.js   # 离线单测(自造 zip → 解压 → 校验)