# md-validation

Проверяет относительные ссылки между страницами и диаграммы Mermaid до коммита. Пригодится тем, кто собирает многостраничные документы и базы знаний.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 383 установки · ★ 541
- Автор: haowjy
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/haowjy/creative-writing-skills/tree/HEAD/cw/skills/md-validation/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/md-validation

## Что делает

Скилл закрывает две вещи, которые ломаются тихо. Первая — относительные ссылки между страницами: в многостраничном артефакте или базе знаний битые перекрёстные ссылки гниют незаметно, поэтому каждую цель проверяют до коммита. Вторая — диаграммы Mermaid: их открывают в браузере и смотрят глазами, потому что ошибка синтаксиса даёт сломанный рендер, а не сообщение об ошибке.

Внутри описан список частых провалов парсера. Метки с пунктуацией без кавычек рвут разбор. Голое `end` в нижнем регистре конфликтует с терминатором `subgraph`. Идентификаторы узлов, начинающиеся с `o` или `x` после маркеров рёбер, читаются неверно. Кастомные заливки без подходящего цвета текста делают подписи нечитаемыми. Полные правила авторства — кавычки, переносы строк, зарезервированные слова, темы — лежат в `resources/mermaid-authoring.md`.

Проверка визуальная, автоматического парсера здесь нет. Это значит, что скилл не поймает ошибку за вас в CI — открывать артефакт и сверять диаграммы придётся вручную.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill md-validation -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/md-validation/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/md-validation/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill md-validation -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/md-validation/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill md-validation -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/md-validation/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install haowjy/creative-writing-skills md-validation
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/md-validation/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill md-validation -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/haowjy/creative-writing-skills --path cw/skills/md-validation
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/md-validation/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add haowjy/creative-writing-skills --skill md-validation -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/haowjy/creative-writing-skills/tree/HEAD/cw/skills/md-validation/SKILL.md

## Когда брать
- проверить относительные ссылки между страницами до коммита
- найти битые перекрёстные ссылки в базе знаний
- отловить сломанный рендер диаграммы Mermaid
- разобраться, почему метка с пунктуацией ломает парсер
- починить нечитаемые подписи из-за кастомной заливки

## Примеры запросов агенту
- проверь относительные ссылки в docs/ перед коммитом
- посмотри диаграммы Mermaid в собранном HTML и скажи, что сломалось
- почему эта диаграмма не рендерится — проверь по правилам из resources/mermaid-authoring.md

## Похожие
- [codebase-documenter](https://affpapa.org/nevibecode/skills/mhattingpete-codebase-documenter.md) — скилл · 587 установок
- [mermaidjs-v11](https://affpapa.org/nevibecode/skills/mermaidjs-v11.md) — скилл · 362 установки
- [mermaid-diagram-generator](https://affpapa.org/nevibecode/skills/mermaid-diagram-generator.md) — скилл · 331 установка
- [design-doc-mermaid](https://affpapa.org/nevibecode/skills/design-doc-mermaid.md) — скилл · 80700 установок
- [utility-mermaid-diagrams](https://affpapa.org/nevibecode/skills/utility-mermaid-diagrams.md) — скилл · 736 установок
- [mermaid-diagrams](https://affpapa.org/nevibecode/skills/hoodini-mermaid-diagrams.md) — скилл · 406 установок

Из того же набора: [haowjy/creative-writing-skills](https://affpapa.org/nevibecode/by/haowjy/creative-writing-skills.md) — 22 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md