Home / yan-labs / yan-skills · skill-link-check/SKILL.md · GitHub

skill-link-check skillA

skill-link-check is agent-read markdown (skill) from yan-labs/yan-skills: Audit project and global .agents/skills and .claude/skills layouts. Verify that .agents/skills contains the real source and .claude/skills mirrors it through a parent or per-skill symlink. Use whenever a skill or slash command is missing, not loading, duplicated, inconsistent, or described as "skill 没生效", "skill 不一致", "为什么 skill 没识别到", "检查 skill 链接", ghost skill, broken skill link, or missing skill. Also use when a skill exists in one directory but not the other..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Skill Link Check

## 安装与更新

来源:[Skills.sh](https://skills.sh/yan-labs/yan-skills)

```bash
# 首次全局安装,或更新失败时重新安装
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 Contract

在 `/goal`、autopilot 或其他持续执行器中,本 Skill 的完成条件是“审计证据完整”,不是“退出码必须为 0”。发现问题是有效结果,不能为了让检查通过而擅自修复。

```xml
<goal>审计所有适用作用域,判定 Skill 源目录与运行时镜像是否一致,并为每个问题提供可复核证据和修复命令。</goal>
<gate>检查脚本已从用户目标项目运行;每个适用作用域都有布局模式、问题分类和退出状态。</gate>
<done-when>无问题时明确报告 clean;有问题时完整列出数量、类别、路径和建议命令;未自动修改任何被审计目录。</done-when>
```

因此:

- 退出码 `0`:审计完成且没有发现问题。
- 退出码 `1`:审计完成且发现问题,不代表 Skill 执行失败。
- Python traceback、参数错误或无法读取目标:才属于执行失败,需要修复后重跑。

## 运行方式

```bash
python3 "$(dirname "$0")/check.py"
```

默认审计:

- **Project**:当前目录下的 `.agents/skills` 与 `.claude/skills`。
- **Global**:`$HOME` 下的同名目录。

自动化或 checker 可使用:

```bash
# 明确指定项目,避免依赖当前工作目录
…

Read the whole file at its exact version.

How to install

Latest version
mdr add yan-labs/yan-skills/skill-link-check@git:20260801.45daefe
Exact content
mdr add yan-labs/yan-skills/skill-link-check@sha256:914ae8dc9f82ffce

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_bagvajcyfwc7hs3i.svg)](https://markdownregistry.com/a/art_bagvajcyfwc7hs3i)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260801.45daefe latest2026-08-01 45daefe 4,404 BA view · diff
git:20260705.6abb68b2026-07-05 6abb68b 3,568 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (4404 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

yan-labs/yan-skills · 203 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bagvajcyfwc7hs3i
GET https://markdownregistry.com/api/v1/resolve?ref=yan-labs/yan-skills/skill-link-check
GET https://markdownregistry.com/api/v1/blob/914ae8dc9f82ffceec025757c92270566d45b53df9c06d3bed8969488d247d89

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from yan-labs/yan-skills

agent-fleet skill
yan-labs/yan-skills · agent-fleet/SKILL.md · 通用多模型子任务执行工具。用户想把一个任务派给别的模型(Gemini、DeepSeek、Kimi/Moonshot,或任何 Anthropic 兼容端点)去跑,尤其是想同时并行跑好几个不同模型的任务("同时起一个 Gemini…
git:20260922.7a67fde · audit A · 203 stars
agent-fleet skill
yan-labs/yan-skills · agent-fleet/skill/SKILL.md · 把机械化、大批量、对模型能力要求不高的子任务派给第三方模型(DeepSeek、Kimi/Moonshot,以及用户自备网关接入的 Gemini 或任何 Anthropic 兼容端点)去跑,省下 Claude 自己的 token…
git:20260923.16c2bb7 · audit A · 203 stars
autopilot skill
yan-labs/yan-skills · autopilot/SKILL.md · 接收一句模糊指令,自动调查、分类、拆解为 XML 阶段计划、选 skill、定完成判定, 然后以无人值守模式通过 loop/goal + agent-mode 完整执行到底—— 包括自动部署、自动 E2E 测试、自动代码…
git:20260912.2c2f140 · audit A · 203 stars
backlink skill
yan-labs/yan-skills · backlink/SKILL.md · OpenCLI-first backlink discovery, profile analysis, opportunity qualification, safe browser-assisted form filling…
git:20260913.4f244b1 · audit B · 203 stars
codex skill
yan-labs/yan-skills · codex/SKILL.md · **Generate images** with Codex's built-in OpenAI image-generation tool — route every "生成图片 / 配图 / 插图 / image gen / 画一张…
git:20260822.e230bea · audit A · 203 stars
game-opportunity skill
yan-labs/yan-skills · game-opportunity/SKILL.md · Rankup 的小游戏机会专项 Skill。用于监测游戏平台 sitemap、发现 24 小时游戏新词、建立多语言关键词需求簇、核对 KD/SERP/近 7 天趋势/独立需求/可玩供给并生成每日决策报告;通用规则和脚本随 Rankup…
git:20260921.28c4148 · audit A · 203 stars
imagegen skill
yan-labs/yan-skills · imagegen/SKILL.md · 生成网站与内容所需的一切视觉素材——用户说 生成图片、配图、插图、画一张、出一套图、logo、吉祥物、封面、海报、og 图、分享图、favicon…
v1.0.0 · audit A · 203 stars
opencli skill
yan-labs/yan-skills · opencli/SKILL.md · 用 OpenCLI 驱动用户本机那个真实的、已登录的 Chrome,或调用它的 160+ 站点 adapter。任何需要登录态的页面操作都从这里开始——读登录后的后台、抓没有 API…
v1.5.0 · audit A · 203 stars
rankup skill
yan-labs/yan-skills · rankup/SKILL.md · 网站从零到一与长期增长的总控 Skill。用于新建网站、SaaS、工具站或内容站,规划或初始化 TanStack Start Monorepo,使用 Cloudflare Workers、D1、R2 部署全栈应用,接入支付,执行…
v3.16.1 · audit A · 203 stars
skillsmp skill
yan-labs/yan-skills · skillsmp/SKILL.md · 在 SkillsMP(1.6M+ 公开 SKILL.md 的索引,覆盖 Claude Code / Codex / ChatGPT)里搜 Agent Skill,按关键词、分类、职业、语言过滤,并专门挖那些「写得好但没人知道」的冷门…
git:20260830.f8ac2dd · audit A · 203 stars

Every file in yan-labs/yan-skills

Browse by kind, by grade A, or by owner.