用途：把来源材料（推文、任务描述、博客、“做一个做 X 的技能”）落地为 Paperclip 技能目录中的技能，通过 PR 评审交付。该目录是各 Paperclip 公司浏览安装的技能架，因此要求元数据正确、说明有用、含示例且校验通过。核心规则是先查后写（FIND before MAKE）：目录、本仓库或 GitHub 上已有好技能时，应引用或改编而非重写。
使用时机：有人发推文/链接/想法要求变成 Paperclip 技能；把已有仓库技能打包进目录；把外部已发布技能加入目录。不适用：公司私有技能（应走该公司 Skills UI/API 库）；仅需仓库内部 agent 技能（放 .agents/skills/ 或 skills/）。
步骤：0）捕获来源材料——推文用 xc CLI（先查 command -v xc && xc whoami，不可用则委托有权限的同事），并用 xc get / xc search / xc user 拉取正文与线程，记录来源 URL。1）先查重：grep 目录 catalog.json、检查仓库内 .agents/skills/ 与 skills/、用 gh search code/repos 找 GitHub 上含 SKILL.md 的技能，判断是否真有流程、是否维护、许可证是否兼容。2）选 kind（默认 optional，bundled 需人工/董事会明确指示）、category（复用现有目录或小写 kebab-case 新类）、slug（小写 kebab-case 且全局唯一），路径为 catalog/<kind>/<category>/<slug>/，规范键 paperclipai/<kind>/<category>/<slug>。2A）外部引用只放 catalog-ref.json，需固定 40 位 commit SHA，文件为精确路径或 dir/**，每个文件 ≤1 MiB。2B）本地技能含 SKILL.md、examples/、可选 references/、scripts/（会提高信任等级并要求改测试）、assets/。frontmatter 需 name、description（40–300 字符）、key、recommendedForRoles、tags，可选 defaultInstall、requires。3）写 1–2 个完整示例（输入→应用→输出）。4）运行 pnpm --filter @paperclipai/skills-catalog build:manifest 与 validate，并更新 src/shipped-catalog.test.ts 后跑测试。5）按 prepare-paperclip-pr 提 PR 到 master，diff 仅含新技能目录、重新生成的 catalog.json 与测试更新。
限制与注意事项：generated/catalog.json 不可手改，文件变动后必须重新构建；bundled 与 optional 间 slug 重复会导致构建失败；技能目录内软链须可解析，目录软链被拒；外部引用每次构建都会拉取 GitHub，上游移动/删除会破坏构建，故固定 commit；尽量保持 markdown-only。