发布方式和普通 npm 包不一样。我先查 Cursor 现在怎么分发 skill,再按你这个全局 skill 给出可执行的流程。
不需要上传到 npm,也不用先初始化一个 package。现在的发布物就是一个公开 Git 仓库里的 SKILL.md,别人用 npx skills add 安装。skills.sh 没有投稿入口,有人安装且遥测开着时,目录才会自动收录。
准备什么
仓库里放这些就够:
frontend-conventions/
├── SKILL.md # 已有,frontmatter 里要有 name 和 description
├── README.md # 给人看的说明和安装命令
└── LICENSE # 建议 MIT
package.json 不是安装所必需的。skill 里不要放密钥、本机路径和个人项目的业务文档。
发布流程
- 在 GitHub 建一个公开仓库,把现在的
frontend-conventions 目录推上去。目录可以放在仓库根,也可以放在 skills/frontend-conventions/。
- 本机先确认能被发现,不真正安装:
npx skills add 你的用户名/仓库名 --list
- 安装到本机全局,给 Cursor 用:
npx skills add 你的用户名/仓库名@frontend-conventions -g -y
- 把这条命令写进 README。你自己先装一次,且不要设置
DISABLE_TELEMETRY=1,skills.sh 才会收到收录记录。收录不是即时的,可能要等几天。
- 以后改内容就正常提交并推送。已经安装的人用
npx skills update 更新。
npm 什么时候才需要
只有你希望 skill 跟着某个库一起发版、用 semver 锁版本时,才给它加 package.json 并 npm publish。安装的人再执行 npx skills experimental_sync,从 node_modules 里把 SKILL.md 链到 agent 目录。对你这份纯约定 skill,这条路是多出来的分发渠道,不是发布前提。
放进现有项目的 monorepo
不靠谱,不建议改 Memento。这个 skill 和产品代码无关,仓库一公开,项目里其他 skill(例如需求流程)也可能被 npx skills add 一起扫出来。
靠谱的做法是单独建一个 skills 仓库。以后有第二个 skill,再在同一个仓库里并列目录:
skills/
├── frontend-conventions/SKILL.md
└── 另一个-skill/SKILL.md
这样 npx skills add 用户名/仓库名 会列出全部,npx skills add 用户名/仓库名@frontend-conventions 只装这一个。