- name
SKILL.md
技能檔案保留在發布者的儲存庫中。
在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add yan-labs/yan-skills --skill skill-link-check -a cursor -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add yan-labs/yan-skills --skill skill-link-check -a claude-code -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add yan-labs/yan-skills --skill skill-link-check -a codex -y在終端機中貼上複製的指令。它會將這個 SKILL.md 安裝到對應的代理中。
npx skills add yan-labs/yan-skills --skill skill-link-check -a grok -y在 Grok Bot 聊天中傳送複製的訊息。Bot 會從 GitHub 取得這個 SKILL.md,並加入你所有 Bot 共用的技能中。
Install this skill: https://github.com/yan-labs/yan-skills/tree/HEAD/skill-link-check來自發布者
来源:Skills.sh
# 首次全局安装,或更新失败时重新安装
npx skills add yan-labs/yan-skills --skill skill-link-check -g -y
# 更新已安装的全局 Skill
npx skills update skill-link-check -g -y
若使用项目级安装,去掉安装命令中的 -g;项目级更新使用 npx skills update skill-link-check -p -y。
本 Skill 只审计目录布局,不自动移动、删除或覆盖文件:
.agents/skills/<name>/ 保存真实源文件。.claude/skills 要么整体链接到 .agents/skills,要么通过逐个子项链接镜像它。最常见的漂移是 Skill 被直接创建成 .claude/skills/<name>/ 真实目录,却没有进入 .agents/skills/。它看似已安装,实际不会随正常备份、同步或迁移流程保存。
在 /goal 或持续执行任务里,以审计证据完整为完成条件:从目标项目运行脚本,报告每个适用作用域的布局、问题分类和退出状态。有问题时列数量、路径和建议命令;无问题时报告 clean。脚本不修改被审计目录。
0:审计完成且无问题。1:审计完成且发现问题;这仍是有效结果。python3 "$(dirname "$0")/check.py"
默认审计:
.agents/skills 与 .claude/skills。$HOME 下的同名目录。自动化或 checker 可使用:
# 明确指定项目,避免依赖当前工作目录
python3 "$(dirname "$0")/check.py" --project-root /path/to/project
# 只查一个作用域
python3 "$(dirname "$0")/check.py" --project-only
python3 "$(dirname "$0")/check.py" --global-only
# 输出稳定 JSON 证据;发现问题时仍返回 1
python3 "$(dirname "$0")/check.py" --json
两种模式都应通过:
.claude/skills 本身指向 .agents/skills。新增 Skill 自动保持一致。.claude/skills 是真实目录,每个 .claude/skills/<name> 指向 ../../.agents/skills/<name>。脚本会自动识别模式,不要求为了统一风格而改造一个本来健康的布局。
orphan-in-claude:.claude/skills/ 中有真实条目,但 .agents/skills/ 没有对应源文件。报告时优先列出。missing-link:源 Skill 存在,但运行时镜像缺失。not-symlink:逐子项模式下,镜像位置是重复的真实文件或目录。broken-symlink:链接目标不存在,包括损坏的父级链接。wrong-target:链接存在,但指向错误 Skill 或 .agents/skills 之外。orphan-in-claude 时先报告它。python3 -m unittest discover -s "$(dirname "$0")/tests" -v
Use when a skill or slash command is missing, duplicated, not loading, or inconsistent between `.agents/skills` and `.claude/skills`; includes “skill 没生效”“检查 skill 链接” and broken skill links. Audits p
---name: skill-link-checkdescription: Use when a skill or slash command is missing, duplicated, not loading, or inconsistent between…---# skill-link-check/SKILL.md總覽
Use when a skill or slash command is missing, duplicated, not loading, or inconsistent between `.agents/skills` and `.claude/skills`; includes “skill 没生效”“检查 skill 链接” and broken skill links. Audits project and global skill layouts without changing them.
常見問題
從發布者下載 skill-link-check/SKILL.md,或複製路徑後開啟儲存庫。PlugMCP 只收錄這項技能,不代管檔案。
發布者將它存放在 https://github.com/yan-labs/yan-skills。
Claude、Cursor、Codex 和 Grok Build 可以讀取你從發布者儲存庫加入的 SKILL.md。在聊天中傳送技能的 GitHub 資料夾連結,Grok Bot 就會安裝它。