用途：审计 .agents/skills 与 .claude/skills 之间的目录布局一致性，用于排查 skill 或 slash command 缺失、重复、未加载、两处不一致等问题。skill 没生效或检查目录布局时可使用。
主要能力：只审计目录布局，不移动、删除或覆盖文件。识别两种合法布局：父级符号链接（.claude/skills 整体指向 .agents/skills）和逐子项符号链接（.claude/skills 为真实目录，各子项镜像源文件）。常见漂移是 Skill 被直接创建为 .claude/skills/<name>/ 真实目录却未进入 .agents/skills/，看似已安装但不随正常备份、同步或迁移保存。问题分类包括 orphan-in-claude、missing-link、not-symlink、broken-symlink、wrong-target。
使用方式：默认审计当前目录与 $HOME 下的 .agents/skills、.claude/skills，运行 python3 "$(dirname "$0")/check.py"。可指定项目 python3 "$(dirname "$0")/check.py" --project-root /path/to/project；只查一个作用域加 --project-only 或 --global-only；输出 JSON 证据加 --json。退出码：0 无问题，1 发现问题（仍为有效结果），Python traceback、参数错误或目标不可读属执行失败需重跑。报告先给总问题数和分类计数，有 orphan-in-claude 时优先报告，每项给出名称、证据路径和一行解释，并原样附上脚本生成的建议修复命令。验证自身可运行 python3 -m unittest discover -s "$(dirname "$0")/tests" -v。
安装：npx skills add yan-labs/yan-skills --skill skill-link-check -g -y；更新：npx skills update skill-link-check -g -y。项目级去掉 -g，更新用 npx skills update skill-link-check -p -y。
限制：不自动修复，孤儿目录或重复目录可能已分叉，自动移动或删除会造成数据损失，需用户复核后执行建议命令。