收纳 skill

把外面的 skill 收进 skills/：先按收纳步骤走，来源特有的那一步见不同的源头类型。收成什么形态、带脚本的怎么发、nav 怎么挂，照写 skill。

收纳步骤

不管什么来源都按这个顺序走。

1. 先拆架构、定形态，和用户确认：看来源里有几个 skill、带不带 reference 和 assets，按判形态对上三种形态
2. 定能力名称，和用户确认：也就是解决什么问题。目录名用英文，用规范的变量命名或者直接对齐上游 slug
3. 上游入口 SKILL.md 改名：只有这一个文件的，改名成 <名字>.md（迷你 skill）；带 references、scripts、assets 的，改名成 <名字>/index.md（标准 skill），从而符合 wiki 的渲染规范
4. frontmatter 忠实保留：allowed-tools、model 等字段原样不动；name 用和用户确认的能力名称，description 按能力名称改写成什么时候用、用了做什么，不照译原文。复制按钮会自动去掉 frontmatter。原文没有一级标题的补一个
5. 深度收纳，不是简单翻译或原文照录：内容全部译为中文，人称转换成对 AI 讲述。允许大幅改动，让它贴合本站 —— 换掉本站已有能力能替代的依赖，删掉用不上的路线，脚本一起改，改了什么写进维护记录。活例：整理视频为笔记把下载视频和本地转写换成了 Agent 基础能力的接口，网页 AI 字幕整条删掉。它引用的 references 也要收齐并翻译为中文；README、安装器、CI、测试、运行方式（比如用 xxx 命令运行）跳过。处理好文件之间的路径引用，保证能通过相对路径访问到 skill 内部资源和依赖的其他 skill
6. prompt 里的占位改成填空：上游的 {{idea}}、[产品名]、【…】这类，一律改成填空输入框，读者在网页上填好再复制；为占位写给 AI 的说明（「【】里的内容用户还没给，先问用户要，齐了再开始」这类）随之删掉，输入框本身就说明了哪里要填。活例：人话翻译
7. 入口页说清拿到它之后要做什么，可以补一两句原因给人看。顶层入口（收进来的抽象 skill 的 index.md，或者单个 skill 本身）开头写领域建模：本 skill 解决什么问题，可以参考原本 frontmatter 里的 description，也可以参考 README.md 里的描述。原文里的出处、作者、外链不留在入口页，挪进维护记录的「上游」，外链写成脚注 —— 同写作规范的硬规矩
8. 收尾：上级入口加一行钩子（照抄 description，见三种形态最后一条），mkdocs.yml 注册 nav，顶层入口页尾链到维护记录、记录照收纳的共用规矩写，跑 python3 scripts/check-links.py

不同的源头类型

上游本来就是一个 skill 的，走完收纳步骤就够；下面几种来源另有讲究。

插件仓库

插件的物理形态就是一个 git 仓库，里面可能不光有 skill，还有别的组件：hooks、agents、commands、mod、MCP 服务器¹。收纳时先分清哪些有用、哪些丢掉。

本站不提供、也不希望提供侵入客户端 agent 的能力，所以 hooks、agents、commands 提炼出文本 prompt 转换成 skill，作为软引导；mod（Claude Code 的侵入式插件）和 MCP 暂时没法转成 skill，吸纳时丢弃，并明确告知发起收纳的人丢了哪些。

大型 skill 仓库：脚本重、更新快

上游是 skill，但主体是一套脚本流水线、几天一个版本的，不照收纳步骤第 5 步收齐。入口必写前两样，第三样问过用户才收；用户说全收才全收：

1. 领域建模：一两句，它解决什么问题、靠什么机制做到，让 AI 认得出什么时候该用 —— 同收纳步骤第 7 步
2. 接上游：客户端照上游自己的 SKILL.md 跑，这一节只写照它跑会踩的和本站要改的 —— 哪些文件不能动、动了会怎样；本站替换掉的环节（出图走 agent-io 这类）；上游的确认关口怎么过、花钱的调用先问谁；什么活读上游哪一篇，两边的 id 怎么对应。装法只写和常规不一样的地方
3. 离开引擎也完整的部分，列出来问用户：不默认收。能单独拿出去用的守则适合收成子 skill（判法用判形态那把尺：有自己的 name 和 description），风格、画风、版型这类按编号查的目录适合进 Gallery。一条一行写清是什么、适合收成哪种、为什么，用户确认的才收，收就收完整；离开这条工作流就不知道拿来干什么的是工作流的层，不列

讲原因的 —— 它为什么这么设计、上游观察到什么失败 —— 不进 skill，走正面：默认配一篇粗讲进项目，要弄懂它怎么实现再在同一个目录里细讲，正面链到 skill。活例：PPT Master，入口一段领域建模、一节「生成 PPTX：装上游」；规划 deck、沟通模式、生成配图收成三个子 skill，视觉风格、画风、版型进了 Gallery。

提示词合集、卡牌站

来源自带的形式和框架不跟着进来：卡牌、稀有度、站点自己的分类、几套并存的占位写法这类包装一律丢掉，按本站的 skill 形态重新组织，分组按使用场景来。只收能直接拿来用的内容，分析来源本身的话（比如从写法推断出处）不进 skill，确实有用的写进维护记录的「上游」。活例：对话提示词，原来是一套提示词卡牌。

教程、视频这类教人怎么做的内容

先照做一遍再收。原文多半只露关键词和成品，照着说的做不一定行，坑要自己跑出来：跑通的 prompt、参数和坑写进 skill，和原文不一样的地方写进维护记录的「翻译之外的改动」。视频先用整理视频为笔记记成文章，文章链到 skill，skill 不链回文章。活例：Gallery 的花卉动态生长海报，原视频只给了风格关键词，首帧怎么做、比例怎么补、怎么接成循环都是照做时发现的。