用途：skill-sync 是仓库内的同步维护助手，职责是“同步分发”，不是“起草源文件”。source 改写、模块作者规则与 support file 设计交给 skill-author 或直接编辑 source；它只在校验通过后把标准 source 同步到 Claude / GitHub / Trae，并回写 README。source-of-truth 为 skills/<skill-name>/SKILL.md 及其 references/、assets/、scripts/，安装产物不反向作为来源。
主要能力：默认同步当前仓库 skills/ 下所有标准 source skill；用户显式传入名称时只处理真实存在的源 skill，名称无法解析则提示重新输入。校验 SKILL.md、必要 support files 与 README 关键分节/锚点，任一失败即停止；比对生成内容与 README 是否一致并检查内部模块路径；统计 source Markdown 体积；从 skills/odai/references/modules/ 生成 plans/odai-route-map.md。同步时随源文件一并搬运同目录附属资源，改写入口与资源相对路径，直接覆盖目标文件，存在 replaces 时清理旧安装产物与 README 条目，README 仅处理“Skills 一览”表格落位。
用法：执行 node scripts/skill-sync.js --check 或 --dry-run 做一致性检查（不写文件）；无参数或只传 skill 名称才执行写入；--stats 输出体积统计，可传 skill 名称限定范围；--route-map 生成路由表（仅面向 odai）。Claude 命令层只做薄封装，脚本是唯一执行真相，不让模型手工生成目标文件。
限制：不修改 .agents；不扫描无关目录；不发明文件格式或扩展安装体系；源 skill 不存在则不写入；除 skills/<skill-name>/ 与 README.md 外不读取其他 skill 目录；正文按源文件直拷，除固定头部、路径改写与 frontmatter 显式声明的 Claude 侧包装字段外不改，不调整章节顺序、不合并段落、不推断平台差异；$ARGUMENTS 按普通文本占位符处理。失败时提示对应源文件不存在。官方文档未提供公开页面，其他细节暂未提供。