用途：skill-builder 用于为任何兼容的 Agent 产品构建正确、一致的 Agent Skills，适用于创建、更新、重命名、删除、校验技能，或向技能添加路由、工作流与内容。
主要操作：通过 Operation Router 将用户意图映射为 CREATE（生成技能目录、SKILL.md 及必要伴随文件）、UPDATE（最小差异修改，保持范围稳定）、DELETE（删除并更新依赖引用）、ADD（新增路由行或子流程）、VALIDATE（基于证据的校验报告与修复）、RENAME（安全重命名并更新引用）。选择规则是使用能解决问题的最小操作，不确定时默认 UPDATE 而非 CREATE。
核心原则：技能应无聊、可测试、难误用；保持一个清晰路由器，避免技能间描述重叠；保持模型与框架无关；运行强制性的第一性原理检查，若现有技能、README、脚本或模板可解决则不建议新建技能。
规范要求：技能目录包含 SKILL.md，以有效 YAML frontmatter 开头，name 与父目录名一致，description 说明做什么与何时使用；SKILL.md 聚焦路由器与核心规则，必要时才添加 references/、scripts/、assets/、README.md，引用保持一级深度，非标准元数据放在 metadata 下。命名使用 kebab-case，避免通用名称。
确认边界：只读检查、草拟内容、本地校验和提议差异无需确认；删除文件或目录、重命名技能目录、覆盖用户内容、改变触发语义、编辑仓库索引、安装依赖或联网副作用前需确认。
校验：需对规范、触发和输出三层提供证据；可用 skills-ref validate ./<skill-name> 或按 references/validation.md 手动校验。限制：不推荐 rm -rf、git reset --hard 或 push --force 作为默认；需优先最小权限能力；资料未提供具体兼容客户端列表、安装命令或版本要求。