Skills Registry Template

Archived: 2026-08-16 · roadmap-id: skills-registry-template

Why

做好的 skill 现在能发布了（skill publish），但没有地方可发。

publish 的产物是一条 manifest 条目，要写进「一个 registry 仓的 checkout」—— 那个仓不存在。这是 skills-hub 方向上唯一剩下的结构性缺环。

而且它不是「随便建个仓就行」：publish 的 source 从所在仓的 git remote 推导 （skillPublish.ts），所以公开仓必须物理持有正典内容才能产出可匿名安装的 manifest。 这条把「搬 vs 镜像」定死为：公开仓是正典，宿主单向 vendor（PRD §4.1.3）。

为什么做成模板而不是直接手搓一个仓

「建一个 skill hub」需要的东西对任何人都一样：内容目录约定、一份 manifest、 一个说明写法的 docs 站、以及防止 manifest 与内容漂移的门。手搓一次是一次性劳动； 做成模板，agentdock init 就能给任何人一份带门的起点——这正是本平台在做的事。

Non-goals

• ❌ 不建 fushenguang/thefool-skills 仓本身——那是本刀的消费者，属 thefoolai 侧动作。 本刀只交付模板 + 三道门。
• ❌ 不做独立的 skill 浏览 UI——由 skills.json 生成 docs 页即可，避免维护两套渲染。
• ❌ 不做 skill 的安装/消费侧，不做交易/授权/eval。
• ❌ 不改 skill validate / skill publish 的行为（含上面的选项乙——若采纳，另立条目另开一刀）。
• ❌ 不做部署（skills.app.fujia.site 的 Dokploy 配置属使用者侧）。
• ❌ 不动 web-nextjs / game-web-phaser 两个既有模板。
• ❌ 不做多语言 docs（web-nextjs 的 docs 本就是单语言，不在本刀扩展）。