# skill-catalog

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

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

- 平台：macOS / Linux
- 许可：GPL-3.0-or-later（全文见 [LICENSE](LICENSE)）

## 安装

```sh
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`。