技能教程 · 代理
注册表装法，和它该长成的样子
npx skills 把一行安装带火了：从注册表或仓库拉一个技能目录，铺进你在用的每个代理。WorkshopSkill 的包发布的正是同一单元——一个具名目录，里面躺着一份 SKILL.md——两边天然咬合。
安装器实际做的是什么
解析技能名，把目录复制到它认识的所有代理技能路径（~/.claude/skills、~/.codex/skills……），记下装了什么在哪。概念上就是技能界的包管理器。注意：它不转换技能——所以凡按惯例发布的目录都能被它搬。
本站对安装器的承诺
安装器要复製的那个单元
blind-portrait/ SKILL.md # name + description + metadata + 命令 manifest.json # 版本、更新时间、逐文件 sha256 ...可打印件 # 都被 SKILL.md 按名字引用 不用安装器的一条命令： curl -LO https://workshopskill.com/zh/activities/blind-portrait/files/blind-portrait.zip unzip blind-portrait.zip
给团队自建注册表
想要 npx skills add my-org/blind-portrait 这种装法：把包镜像进一个 GitHub 仓库（每技能一个目录，正是注册表读的形状），让安装器指向它。本站 skills.json 带着名字、描述、包地址与校验和——注册表播种需要的全在这。
什么时候别用注册表
- 只为一场课取三个文件：curl 比工具链快——没有 npm 缓存，不要求 Node。
- 断网会场：zip 就是离线交付物；注册表多一跳网络。
- 要审计：包内 manifest 逐文件哈希能字节级复核；注册表交付的是「它当天发的那份」。
接着读
常见问题
本站进了公开注册表吗？
本站自己就是注册表：skills.json 加每技能一个 zip。第三方注册表可以收录它；curl 是钦定安装路径。
注册表装的技能会自动更新吗？
这个家族里没人自动更新——诚实的答案。用 metadata.updated 对 skills.json，或比对 manifest.json 的逐档 sha256。
哪些代理被 npx skills 支持？
带技能目录的主流加载器（Claude Code、Codex 一系）；本站每篇代理教程都写明了确切路径。