skill-catalog/README.md

skill-catalog

技能目录站：把对外发布的技能发布成一个自托管目录站（动态服务从 catalog.json 现渲染，附同源静态快照；能干什么 / 先装什么 / 要配什么 / 依赖谁 / 一条安装命令）。

以 Pi package（技能形态）发布。技能本体在 skills/skill-catalog/。

• 平台：macOS / Linux
• 许可：GPL-3.0-or-later（全文见 LICENSE）

安装

pi install git:gitea.vhkd.top/pi-hub/skill-catalog.git@v0.2.1

装完 pi-skill list 能看到 skill-catalog，pi-skill skill-catalog check 会告诉还缺什么。

先准备什么

• node（运行环境），生成器与动态服务（serve.mjs）；零 npm 依赖
• ssh（命令），部署两跳（relay→host）
• tar（命令），部署打包（tar -czf）
• curl（命令），字体下载与上线自检

常用命令

命令	说明
build	生成 dist：catalog.json + assets + serve.mjs + 静态快照（只收录声明了 publish 的技能）
serve	本地跑动态服务：从 catalog.json 现渲染，带 /api/skills 与 /healthz
preview	生成并本地动态预览目录站
deploy	把 dist 发布到部署目标（relay→host，release + current 切换，systemd 服务自动重启）
list	收录清单与依赖闭包状态
check	只读自检：收录规则、部署目标与线上健康

用法与对外契约见技能内的 SKILL.md 与 REFERENCE.md。