К основному содержанию
скилл CX Codex

link-validation — скилл для Claude Code: проверка ссылок в markdown

Скилл link-validation проверяет ссылки в markdown-файлах проекта офлайн через lychee: относительные пути, корневые пути и якоря. Пригодится перед коммитом документации.

MIT 135 установок ★ 3 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add terrylica/cc-skills --skill link-validation -a claude-code
Открыть на GitHub

Что делает link-validation

Скилл запускает tasks/link-check.sh. Скрипт переходит в корень рабочего дерева через git rev-parse --show-toplevel, вызывает bunx lychee с --offline --no-progress --root-dir по маске './**/*.md', печатает сводку lychee и вердикт — всё сошлось или нашлись битые внутренние ссылки. Код возврата берётся у lychee, поэтому проверку легко вставить в CI или в pre-commit. В репозитории cc-skills тот же прогон доступен как moon run repo:link-check, а moon run repo:check гоняет его вместе с остальными проверками.

Ловит относительные ссылки, корневые вроде /docs/adr/x.md и фрагменты #anchor. Внешние URL не проверяются: их доступность зависит от сети и чужих сайтов. На диск ничего не пишется, кроме кеша .lycheecache.

Нужен lychee. В скрипте он вызывается через bunx, так что достаточно Bun; в остальных случаях brew install lychee. Конфиг lychee.toml в корне репозитория задаёт исключения и include_fragments = "anchor-only" — lychee 0.24 отвергает старый булев true. Ссылка на путь, который есть только на вашей машине (~/...), не пройдёт никогда: такой путь пишите инлайн-кодом, а не ссылкой.

Какие задачи решает

  • поймать битые относительные ссылки до коммита документации
  • проверить, что после правки README не осталось висячих якорей
  • прогнать проверку ссылок в CI и получить код возврата lychee
  • найти корневые ссылки /docs/..., которые ломаются без --root-dir
  • убрать из проверки фикстуры с намеренно битыми ссылками

Примеры запросов агенту

  • Прогони link-validation по markdown-файлам и покажи, какие внутренние ссылки сломаны.
  • Перед коммитом проверь документацию на висячие якоря.
  • Запусти moon run repo:link-check и скажи, что именно упало.

Как установить link-validation

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill link-validation -a claude-code

2Вручную: положить файлы

~/.claude/skills/link-validation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/link-validation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о link-validation

Как установить link-validation в Claude Code?

Выполните npx skills add terrylica/cc-skills --skill link-validation -a claude-code, после чего файл скилла окажется по пути ~/.claude/skills/link-validation/SKILL.md.

Что делает link-validation?

Гоняет lychee в офлайн-режиме по markdown-файлам и сообщает о битых относительных ссылках, корневых путях и якорях. Возвращает код выхода lychee, так что подходит для автоматической проверки.

Почему внешние ссылки не проверяются?

Проверка офлайн по замыслу: доступность чужих сайтов зависит от сети и их аптайма, на результат такого прогона нельзя опереться.

Исходный текст

SKILL.md · MIT
---
name: link-validation
description: Offline markdown link validation with lychee (tasks/link-check.sh, moon run repo:link-check). Detect broken internal links and anchors on demand.
allowed-tools: Bash, Read, Glob
triggers:
  - link validation
  - broken links
  - lychee
  - check links
  - markdown links
---

# Link Validation Skill

Validates markdown links in your workspace using [lychee](https://github.com/lycheeverse/lychee).

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## When to Use This Skill

Use this skill when:

- Checking for broken links in markdown files
- Validating link paths before committing documentation
- Proving a doc change left no dangling internal link

## How to Run It

The working path is the offline lychee check in `tasks/link-check.sh`. Inside the cc-skills repository it is part of the quality gate:

```bash
moon run repo:link-check     # this check alone
moon run repo:check          # the whole gate, link-check included
bash tasks/link-check.sh     # the same script without moon
```

In any other workspace, run the same lychee command from the repository root:

```bash
lychee --offline --no-progress --root-dir "$(git rev-parse --show-toplevel)" './**/*.md'
```

Add `--config lychee.toml` when the repository has one; lychee also loads `./lychee.toml` by itself.

## What the Check Does

`tasks/link-check.sh`:

1. `cd`s to the working-tree root (`git rev-parse --show-toplevel`, so it is correct inside a worktree too)
2. Runs `bunx lychee --config lychee.toml --offline --no-progress --root-dir <repo root> './**/*.md'`
3. Excludes `plugins/statusline-tools/tests/fixtures`, whose links are broken on purpose
4. Prints lychee's summary line, then `✓ every internal link resolves` or `✗ broken internal links found (lychee exit N)`, and exits with lychee's exit code

It checks relative links, root-relative links (`/docs/adr/x.md`, resolved through `--root-dir`) and `#anchor` fragments. It is offline by design: external URL liveness depends on the network and on other sites' uptime, so it is not checked. Nothing is written to disk except lychee's own `.lycheecache`; the result is the terminal output and the exit code.

A path that exists on one machine only (`~/...`, another repository) cannot pass. Write it as inline code instead of a link.

## Requirements

- [lychee](https://github.com/lycheeverse/lychee): `tasks/link-check.sh` runs it through `bunx`, so Bun is enough there; elsewhere install it (`brew install lychee`)

## Configuration

cc-skills keeps one lychee config, `lychee.toml` at the repository root. It holds the path and URL exclusions and `include_fragments = "anchor-only"` (lychee 0.24 rejects the old boolean `true`). The statusline-tools Stop hook reads the same file when it exists.

## Related Checks

- Link portability in skills (absolute repo paths that break once installed): the [link-validator](../link-validator/SKILL.md) skill
- Path policy at session end: the statusline-tools Stop hook runs `lint-relative-paths` and lychee, and writes `.lychee-results.json` for the status line

## History

This skill used to describe a Stop hook, `hooks/stop-link-check.py`, that wrote `.link-check-results.md`. link-tools never had a `hooks.json`, so the hook never ran; it was deleted in issue #33.

## References

- [ADR: Link Checker Plugin Extraction](../../../../docs/adr/2025-12-11-link-checker-plugin-extraction.md)
- [lychee Documentation](https://github.com/lycheeverse/lychee)

---

## Troubleshooting

| Issue                         | Cause                           | Solution                                                        |
| ----------------------------- | ------------------------------- | --------------------------------------------------------------- |
| lychee not found              | Not installed                   | `brew install lychee`, or run through `bunx lychee`             |
| Config fails to load          | `include_fragments = true`      | Use `include_fragments = "anchor-only"` (lychee 0.24 and later) |
| Every `/docs/...` link fails  | No `--root-dir`                 | Pass `--root-dir` with the absolute repository root             |
| A link to `~/...` fails       | Path exists on one machine only | Write it as inline code, not a link                             |
| A fixture's broken link fails | Fixture not excluded            | Add it to `--exclude-path` or the config's `exclude_path`       |

## Post-Execution Reflection

After this skill completes, check before closing:

1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

© terrylica · MIT · terrylica/cc-skills

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
oma-docs First Fluke Сверяет ссылки в документации, обновляет тексты под изменения в коде и находит рассинхрон в переводах. Работает через CLI oma docs или ручной парсинг ссылок. CX Codex +1 ★ 1 472звёзд репо md-validation haowjy Скилл md-validation для Claude Code проверяет ссылки в Markdown и синтаксис Mermaid. Запускайте его после правок документации, до коммита. CX Codex +1 441установок fixing-broken-links spencerpauly Скилл fixing-broken-links находит в файлах проекта битые внешние URL и локальные пути, проверяет их ответы через curl и заменяет на актуальные адреса. CX Codex +1 434установок webflow-mcp:link-checker webflow Скилл webflow-mcp:link-checker для Claude Code находит и исправляет битые, небезопасные и перенаправляющие ссылки на страницах и в CMS Webflow. Проверка используется перед релизом и при регулярном SEO-аудите. CX Codex +1 909установок utm-link-generator OneWave-AI Скилл utm-link-generator генерирует UTM-ссылки с едиными правилами именования, следит за дубликатами и создаёт варианты для LinkedIn, email, соцсетей и рекламы. CX Codex +1 249установок url-link-extractor davila7 Субагент url-link-extractor сканирует проект и собирает полный каталог ссылок: от внутренних маршрутов и ассетов до внешних URL и API-эндпоинтов. Пригодится при миграциях доменов, аудитах безопасности и SEO. CX Codex 799установок

Из того же набора79

Весь набор →
skill-architecture Скилл skill-architecture помогает создавать и менять скиллы, разбираться в YAML и проверять структуру файлов. Внутри — шаблоны задач и рекомендации по устройству скиллов. CX Codex +1 137установок slash-command-factory Скилл slash-command-factory задаёт 5–7 вопросов и создаёт файлы слэш-команд для Claude Code с проверенным синтаксисом YAML и правами на подкоманды. CX Codex +1 136установок backtesting-py-oracle Скилл backtesting-py-oracle настраивает backtesting.py для сверки торговых сигналов с расчётами в ClickHouse SQL. Помогает устранить расхождения в сделках при тестировании паттернов на рендж-барах. CX Codex +1 135установок doppler-secret-validation Скилл doppler-secret-validation помогает добавить секреты в Doppler, проверить их хранение и протестировать API-аутентификацию. Пригодится перед тем, как использовать токен в проекте. CX Codex +1 135установок session-recovery Скилл session-recovery диагностирует и восстанавливает потерянные сессии Claude Code, если команда claude -r не находит историю диалогов или файлы пишутся не туда. CX Codex +1 135установок session-chronicle Скилл session-chronicle для Claude Code связывает находки, решения и изменения в коде с сессиями и их UUID. Ищет происхождение решений и готовит записи о сессиях. CX Codex +1 135установок notion-sdk Скилл notion-sdk для Claude Code и Codex, работает с Notion через официальный Python SDK. Создаёт страницы и базы данных, запрашивает информацию, добавляет блоки контента — всё программно, без ручного ввода. CX Codex +1 133установок hooks-development Скилл hooks-development помогает создавать и отлаживать хуки Claude Code, особенно когда агент не видит их вывод. В нём разобраны форматы ответа и обработка событий. CX Codex +1 133установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой