Agent skill

Skill Link Check

by yan-labs in yan-labs/yan-skills

A skill your agent uses when a skill or slash command is missing, duplicated, not loading, or inconsistent between .agents/skills and .claude/skills; includes “skill 没生效”“检查 skill 链接” and broken…

MITAuto-check passedAgent Workflows

Install Skill Link Check

skills CLI
$ npx skills add yan-labs/yan-skills --skill skill-link-check -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yan-labs/yan-skills skill-link-check --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yan-labs/yan-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skill-link-check .claude/skills/skill-link-check && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-link-check
GitHub stars
209
Token cost
~573 tokens
SKILL.md length
95 words
Files
4
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when a skill or slash command is missing, duplicated, not loading, or inconsistent between .agents/skills and .claude/skills; includes “skill 没生效”“检查 skill 链接” and broken…

  • Works in 2 steps: Parent symlink:.claude/skills 本身指向… → Per-child symlinks:.claude/skills…
  • Slash command is missing
  • SKILL.md covers 安装与更新, 完成条件与退出码, 运行方式 and 两种合法布局, plus 3 more sections
  • Runs Python scripts from its folder; calls python3 and npx

What it does

Skill Link Check is an agent skill from yan-labs/yan-skills. 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.

Its SKILL.md is about 570 tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `check.py`, `evals/evals.json` and `tests/test_check.py`).

It sits in Agent Workflows, covering Hooks and plugins. The repository describes itself as: Yan's agent skills collection — Google Trends SEO workflows, AI news, autopilot, and more. For Claude Code / Codex / Cursor. The licence is MIT.

When your agent uses it

  • Slash command is missing
  • Inconsistent between .agents/skills and .claude/skills
  • Includes skill 没生效检查 skill 链接 and broken skill links

Example prompts

  • “skill 没生效”
  • “检查 skill 链接”
  • “/skill-link-check”

Requirements

  • Python 3
  • Node.js

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Parent symlink:.claude/skills 本身指向 .agents/skills。新增 Skill 自动保持一致。
  2. Per-child symlinks:.claude/skills 是真实目录,每个 .claude/skills/ 指向 ../../.agents/skills/。

What it can do on your machine

Read from SKILL.md and the folder at commit 5640916. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • skills.sh

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Link Check loads about 573 tokens when it runs. Until then it costs about 68 tokens; SKILL.md has 95 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~68
When it runs · the whole SKILL.md, loaded when a task matches
~573

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yan-labs/yan-skills at commit 5640916, republished under its MIT licence (© yan-labs). 95 words, ~573 tokens.

Download SKILL.mdSave it as .claude/skills/skill-link-check/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
skill-link-check
description
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.

安装与更新

来源:Skills.sh

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 或持续执行任务里,以审计证据完整为完成条件:从目标项目运行脚本,报告每个适用作用域的布局、问题分类和退出状态。有问题时列数量、路径和建议命令;无问题时报告 clean。脚本不修改被审计目录。

  • 0:审计完成且无问题。
  • 1:审计完成且发现问题;这仍是有效结果。
  • Python traceback、参数错误或目标不可读:执行失败,查明后重跑。

运行方式

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

默认审计:

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

自动化或 checker 可使用:

bash
# 明确指定项目,避免依赖当前工作目录
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

两种合法布局

两种模式都应通过:

  1. Parent symlink:.claude/skills 本身指向 .agents/skills。新增 Skill 自动保持一致。
  2. Per-child symlinks:.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 之外。

报告规则

  1. 先给总问题数和分类计数;有 orphan-in-claude 时先报告它。
  2. 每项给出名称、证据路径和一行解释。
  3. 原样附上脚本生成的建议修复命令,便于用户复核后执行。
  4. 不自动修复。孤儿目录可能是用户尚未迁移的工作,重复目录也可能已经分叉;自动移动或删除会造成数据损失。
  5. 如果全部健康,一句话说明适用作用域及布局模式即可结束。

验证 Skill 自身

bash
python3 -m unittest discover -s "$(dirname "$0")/tests" -v

© yan-labs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in skill-link-check of yan-labs/yan-skills.

  • SKILL.md
  • check.py
  • evals/evals.json
  • tests/test_check.py

Open the folder on GitHubat commit 5640916

Compare with similar skills

Skill Link Check next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Link Check compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Link Check this skillyan-labs/yan-skills209—~573Automated safety check: PassMIT
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Claude Code Agent Developmentanthropics/claude-plugins-official38k7 repos~2.8kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Plugin Settings Patternanthropics/claude-plugins-official38k7 repos~3kAutomated safety check: PassApache-2.0
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0

Similar skills

  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Plugin Settings Pattern

    anthropics/claude-plugins-official

    Official

    Shows how Claude Code plugins keep per-project settings and state in .claude/plugin-name.local.md files with YAML frontmatter and a markdown body.

    38k GitHub starsUsed in 7 repos~3k tokens
    Agent WorkflowsAuto-check passed
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed

More from yan-labs/yan-skills

All 9 skills in this repo
  • Rankup

    yan-labs/yan-skills

    独立开发者的项目全生命周期管理:需求验证、选词选品、建站或做原生 App、上线接入、SEO/GEO 获客、支付变现、监控迭代与跨会话接力。以下情况使用:用户提到 rankup 或 /rankup(check、review、init;doctor 仅指整理项目 .rankup 记录);当前目录或工作区有…

    209 GitHub stars~5.1k tokensUpdated yesterday
    Auto-check: notes
  • Backlink

    yan-labs/yan-skills

    A skill your agent uses for backlink work - finding, qualifying, submitting, analyzing or verifying backlinks, directory and blog-comment placements, competitor link sources, anchors, toxic links…

    209 GitHub stars~8.9k tokensUpdated yesterday
    Auto-check passed
  • Opencli

    yan-labs/yan-skills

    当用户要用本机已登录 Chrome 操作或验收网页(含测试自己的站、E2E、截图)、读取登录后台、抓取无 API 的数据、填表,或排查 OpenCLI doctor、会话、adapter 故障,或明确提到 opencli、浏览器自动化、标签页被抢时使用。公开文本先用 HTTP;话题调研交 agent-reach;SEO 与选词决策交 rankup;外链选点、提交与…

    209 GitHub stars~6.8k tokensUpdated yesterday
    Auto-check passed
  • Agent Fleet

    yan-labs/yan-skills

    使用本机 fleet 分派 Codex GPT-6.1 Sol、Gemini、Grok 或 JEV 任务,或调用 Kollab 图片/视频/音频/多模态能力时使用;包括用户点名 agent-fleet、Nano Banana、nanobanana、香蕉、便宜模型、多模型并行,用户说“让 Codex 或 GPT-6.1 Sol 做某事”的编码、调研与 review 派单,以及按全局…

    209 GitHub stars~3.4k tokensUpdated yesterday
    Auto-check: notes
  • Codex

    yan-labs/yan-skills

    当用户明确要求直接操作 Codex CLI 作为后台代理(自选 sandbox、codex review、apply、resume 等原生命令,或用 git worktree 并行布置多个 worker)做代码分析、编辑、审查时使用。普通的“让 Codex 或 GPT-6 写代码、调研、review”派单走 agent-fleet(fleet code);图片生成与网站视觉素材走…

    209 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Cf CLI

    yan-labs/yan-skills

    A skill your agent uses when the user asks for Cloudflare's cf CLI, cf cli search, or cloudflare.config.ts to inspect resources, manage zones or DNS, attach domains, or deploy.

    209 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Skill Link Check

What does Skill Link Check do?

A skill your agent uses 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 Link Check is an agent skill from yan-labs/yan-skills.claude/skills; includes “skill 没生效”“检查 skill 链接” and broken skill links.

When should I use Skill Link Check?

Skill Link Check fits situations like: slash command is missing; inconsistent between .agents/skills and .claude/skills; includes skill 没生效检查 skill 链接 and broken skill links.

How do I install Skill Link Check in Claude Code?

Run `npx skills add yan-labs/yan-skills --skill skill-link-check -a claude-code`. Or copy the skill folder (skill-link-check in yan-labs/yan-skills) into .claude/skills/skill-link-check in your project. Claude Code loads it when a task matches its description.

How do I install Skill Link Check in Codex?

Run `npx skills add yan-labs/yan-skills --skill skill-link-check -a codex`. Or copy the skill folder (skill-link-check in yan-labs/yan-skills) into .agents/skills/skill-link-check in your project. Codex loads it when a task matches its description.

Can I use Skill Link Check in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yan-labs/yan-skills --skill skill-link-check -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-link-check, .gemini/skills/skill-link-check, .github/skills/skill-link-check and .opencode/skills/skill-link-check in your project.

What does Skill Link Check need to run?

Going by SKILL.md and its folder, Skill Link Check needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and npx). Our summary lists: Python 3; Node.js.

Does Skill Link Check access the network?

SKILL.md names 1 domain. As links in the text: skills.sh. This is read from the text; nothing was executed.

Is Skill Link Check safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skill Link Check use?

Skill Link Check is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Link Check use?

About 573 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skill Link Check?

Skills that share tags, products or a category with Skill Link Check: Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Claude Code Agent Development (anthropics/claude-plugins-official, 38k stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars) and Plugin Settings Pattern (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Link Check?

yan-labs (a GitHub user) maintains it in yan-labs/yan-skills, which has 209 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 8, 2026.

Source: yan-labs/yan-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.