用途：将仓库 .agents/skills 下按项目安装的技能文档与仓库当前状态重新对齐。代码演进后技能里的命令、路径、参数、约定可能过期，该技能负责逐条核对并修正不成立的内容，原则是“校验而非重写”。
范围：仅处理物理位于仓库内的 <dir>/.agents/skills/<name>/SKILL.md（任意深度，含 monorepo 嵌套）。~/.agents/skills、~/.claude/skills、任何 .claude/skills 目录均不扫描、不写入；skills/ 目录属于技能开发仓库，不属于安装，运行时会发现零个目标，属预期结果。
用法：可传入技能目录名（可多个）限定范围，可传 --dry-run 只预览不写文件；无法识别的参数回退默认模式并在报告中提示。每个技能按其自身项目根（包含其 .agents/ 的目录）核对，仓库级声明再回退到仓库根。
能力：发现目标、解析项目根、检查技能内部完整性（frontmatter、捆绑文件引用）、抽取可验证声明并对照仓库核对、标记已废弃技能、收集建议新增项、就地修正（或输出预览），并在可发现时用仓库自带格式化工具格式化改动文件，不安装工具。
限制：只做事实性修正，最小改动跨度，保留原语气与结构；外部或不可验证声明（URL、第三方行为、仓库外路径）不动；废弃技能只标记建议下架或删除，绝不自动删除或掏空内容；不自动提交、不生成备份文件、不写入目标集之外、不写入 $HOME；改动较多时先列出目标清单再写。
安全前置：拒绝在文件系统根、~/.agents 或 ~/.claude 下运行，必须位于 git 仓库内，且仓库根不能是 /、$HOME 或上述点目录。
报告：用 ✓ 已更新或已最新、⊘ 跳过、⚠ 提示、✗ 失败等符号，按 .agents/skills 位置分组，结尾给一行统计。