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

link-validator — скилл для Claude Code: проверка портативности ссылок

Скилл link-validator проверяет markdown-ссылки в навыках на предмет абсолютных путей, которые сломаются при установке в другое место. Нужен перед распространением навыка или после добавления новых ссылок.

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

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

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

link-validator ищет в markdown-файлах абсолютные пути вроде /skills/foo/SKILL.md и предлагает заменить их на относительные (./references/guide.md, ../sibling/SKILL.md). Внешние URL и якоря остаются без внимания.

Скилл работает через команду uv run scripts/validate_links.py с путём к навыку или плагину. Выдаёт отчёт с номерами строк и готовыми исправлениями. Возвращает код 0, если все ссылки портативны, код 1 при нарушениях, код 2 при ошибке пути.

Сам скилл нужно обновлять сразу, если параметры инструмента дрейфуют или понадобился workaround — откладывать не имеет смысла.

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

  • найти абсолютные пути в markdown-ссылках навыка
  • проверить, поломаются ли ссылки после установки в другую папку
  • получить список нарушений с номерами строк и готовыми исправлениями
  • валидировать весь плагин с несколькими навыками за раз

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

  • Проверь портативность ссылок в навыке по пути ~/.claude/skills/my-skill/
  • Валидируй весь плагин в ~/.claude/plugins/my-plugin/ и покажи, какие ссылки сломаны
  • Запусти сухой запуск валидатора на текущей директории

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о link-validator

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

Выполни npx skills add terrylica/cc-skills --skill link-validator -a claude-code, затем открой файл ~/.claude/skills/link-validator/SKILL.md.

Что проверяет link-validator?

Ищет абсолютные пути в markdown-ссылках (например, /skills/foo/SKILL.md), которые не сработают при переносе навыка. Пропускает внешние URL и якоря.

Какие коды выхода возвращает скилл?

Код 0 — все ссылки портативны, код 1 — найдены нарушения (абсолютные пути), код 2 — ошибка (неправильный путь или нет markdown-файлов).

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

SKILL.md · MIT
---
name: link-validator
description: Validate markdown link portability in skills. TRIGGERS - check links, validate portability, fix broken links, relative paths.
allowed-tools: Bash, Read, Edit, Glob
---

# Link Validator

Validates markdown links in Claude Code skills for portability across installation locations.

> **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.

## The Problem

Skills with absolute repo paths break when installed elsewhere:

| Path Type       | Example                 | Works When Installed?   |
| --------------- | ----------------------- | ----------------------- |
| Absolute repo   | `/skills/foo/SKILL.md`  | No - path doesn't exist |
| Relative        | `./references/guide.md` | Yes - always resolves   |
| Relative parent | `../sibling/SKILL.md`   | Yes - always resolves   |

## When to Use This Skill

- Before distributing a skill/plugin
- After creating new markdown links in skills
- When CI reports link validation failures
- To audit existing skills for portability issues

---

## TodoWrite Task Templates

### Template A: Validate Single Skill

```
1. Identify skill path to validate
2. Run: uv run scripts/validate_links.py <skill-path>
3. Review violation report (if any)
4. For each violation, apply suggested fix
5. Re-run validator to confirm all fixed
```

### Template B: Validate Plugin (Multiple Skills)

```
1. Identify plugin root directory
2. Run: uv run scripts/validate_links.py <plugin-path>
3. Review grouped violations by skill
4. Fix violations skill-by-skill
5. Re-validate entire plugin
```

### Template C: Fix Violations

```
1. Read violation report output
2. Locate file and line number
3. Review suggested relative path
4. Apply fix using Edit tool
5. Re-run validator on file
```

---

## Post-Change Checklist

After modifying this skill:

1. [ ] Script remains in sync with latest patterns
2. [ ] References updated if new patterns added
3. [ ] Tested on real skill with violations

---

## Quick Start

```bash
# Validate a single skill
uv run scripts/validate_links.py ~/.claude/skills/my-skill/

# Validate a plugin with multiple skills
uv run scripts/validate_links.py ~/.claude/plugins/my-plugin/

# Dry-run in current directory
uv run scripts/validate_links.py .
```

## Exit Codes

| Code | Meaning                                 |
| ---- | --------------------------------------- |
| 0    | All links valid (relative paths)        |
| 1    | Violations found (absolute repo paths)  |
| 2    | Error (invalid path, no markdown files) |

## What Gets Checked

**Flagged as Violations:**

- `/skills/foo/SKILL.md` - Absolute repo path
- `/docs/guide.md` - Absolute repo path

**Allowed (Pass):**

- `./references/guide.md` - Relative same directory
- `../sibling/SKILL.md` - Relative parent
- `https://example.com` - External URL
- `#section` - Anchor link

## Reference Documentation

- [Link Patterns Reference](./references/link-patterns.md) - Detailed pattern explanations and fix strategies

---

## Troubleshooting

| Issue                     | Cause                         | Solution                                          |
| ------------------------- | ----------------------------- | ------------------------------------------------- |
| Script not found          | Path or plugin not installed  | Verify plugin installed with `claude plugin list` |
| Exit code 2               | Invalid path or no .md files  | Check target path exists and contains markdown    |
| False positive on URL     | Regex matched external link   | URLs starting with `http` should be ignored       |
| Anchor link flagged       | Script treating `#` as path   | Anchor links (`#section`) are allowed by design   |
| Relative path still fails | Wrong relative direction      | Use `./` for same dir, `../` for parent           |
| Validation passes locally | CI uses different working dir | Ensure CI runs from correct repo root             |
| Too many violations       | Legacy codebase               | Fix incrementally, prioritize high-impact files   |
| Can't determine fix       | Complex path structure        | Read link-patterns.md for detailed fix strategies |


## 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

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

Все скиллы по теме «Код-ревью и рефакторинг» →
md-validation haowjy Скилл md-validation для Claude Code проверяет ссылки в Markdown и синтаксис Mermaid. Запускайте его после правок документации, до коммита. CX Codex +1 441установок 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установок conductor-validator Seth Hobson Субагент conductor-validator проверяет файлы проекта Conductor на полноту и согласованность. Пригодится после настройки и перед началом работы. CX Codex ★ 42 780звёзд репо Web Validator by DigestSEO digestseo MCP-сервер Web Validator by DigestSEO для Claude Code проверяет HTML, CSS, SEO-метаданные, JSON-LD и публичные ссылки. Проводит аудит разметки и живых страниц. CX Codex +1 317установок

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

Весь набор →
clickhouse-pydantic-config Скилл clickhouse-pydantic-config для Claude Code собирает файл подключений DBeaver для ClickHouse из Pydantic-модели и переменных окружения. Локальная и облачная базы открываются в клиенте без ручного ввода. CX Codex +1 130установок issue-create Скилл issue-create превращает черновое описание в оформленный GitHub issue: определяет тип, подбирает метки из таксономии репозитория и предупреждает о дублях. CX Codex +1 129установок asciinema-streaming-backup Скилл asciinema-streaming-backup организует потоковую выгрузку терминальных записей asciinema в orphan-ветку репозитория GitHub со сжатием zstd и brotli. CX Codex +1 128установок multi-agent-e2e-validation Скилл multi-agent-e2e-validation для Claude Code и других AI-редакторов запускает несколько агентов параллельно, чтобы комплексно протестировать рефакторинг базы данных. CX Codex +1 128установок session-info Скилл session-info определяет UUID текущей сессии Claude Code и находит файл реестра цепочки. Пригодится при отладке и сопоставлении стенограмм. CX Codex +1 127установок asciinema-analyzer Скилл asciinema-analyzer для Claude Code ищет ключевые слова, команды и ошибки в текстовых расшифровках asciinema. Разбирает историю терминальных сессий. CX Codex +1 127установок research-archival Скилл research-archival скрейпит ссылки на исследования из ChatGPT, Gemini и Claude, складывает их в markdown с YAML-фронтматтером и заводит связанные GitHub Issues после проверки аккаунта. CX Codex +1 127установок iterm2-layout Скилл iterm2-layout настраивает рабочие вкладки и панели iTerm2 через TOML-конфиг. Помогает агенту прописать пути проектов и включить автопоиск git worktree. CX Codex +1 126установок

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

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