用途：将仓库中 .agents/skills/ 下安装的项目级 agent skills 与仓库当前状态重新同步。代码演进后，技能中记录的路径、命令、参数、环境变量、符号、版本和约定可能过时，该技能负责核对并修正不再成立的事实性内容，原则是“验证而非重写”，不会调整风格、重排章节或新增章节。
主要能力：默认递归处理整个仓库，任意深度的 .agents/skills/<name>/SKILL.md 都是目标，包括 monorepo 包内嵌套的 .agents/skills。每个技能按其自身项目根（即包含其 .agents/ 的目录）验证，而非一律按仓库根。默认应用事实性修正，可用 --dry-run 预览。
使用方式：位置参数 skill-name ... 可限定只处理指定名称的技能；--dry-run 预览所有计划变更而不写文件。运行前有守卫检查：拒绝在文件系统根目录、~/.agents 或 ~/.claude 下、非 git 仓库中运行，也拒绝仓库根为 /、$HOME 或位于上述点目录下。发现阶段使用 fd 枚举目标，排除 .git、.claude、node_modules 等目录，并通过 realpath 跳过指向全局安装的符号链接。
适用场景：用户要求更新、刷新、重新同步、检查或验证 .agents/skills 下安装的项目技能时触发。
限制：不扫描也不写入 ~/.agents/skills/、~/.claude/skills/ 及任何 .claude/skills/ 目录；skills/ 目录下的技能开发仓库不属于安装，天然不在范围内，运行结果为找不到目标而非错误。仅做事实性修正，不自动提交，不创建备份文件，不写入目标集合之外或 $HOME 下；外部或不可验证的声明（URL、第三方 API 行为、仓库外路径）保持不动；过时技能只标记建议，不删除。更多细节见 references/agent-skills-update.md。