md-validation — скилл для Claude Code: проверка ссылок и Mermaid
Проверяет относительные ссылки между страницами и диаграммы Mermaid до коммита. Пригодится тем, кто собирает многостраничные документы и базы знаний.
npx skills add haowjy/creative-writing-skills --skill md-validation -a claude-codeЧто делает md-validation
Скилл закрывает две вещи, которые ломаются тихо. Первая — относительные ссылки между страницами: в многостраничном артефакте или базе знаний битые перекрёстные ссылки гниют незаметно, поэтому каждую цель проверяют до коммита. Вторая — диаграммы Mermaid: их открывают в браузере и смотрят глазами, потому что ошибка синтаксиса даёт сломанный рендер, а не сообщение об ошибке.
Внутри описан список частых провалов парсера. Метки с пунктуацией без кавычек рвут разбор. Голое end в нижнем регистре конфликтует с терминатором subgraph. Идентификаторы узлов, начинающиеся с o или x после маркеров рёбер, читаются неверно. Кастомные заливки без подходящего цвета текста делают подписи нечитаемыми. Полные правила авторства — кавычки, переносы строк, зарезервированные слова, темы — лежат в resources/mermaid-authoring.md.
Проверка визуальная, автоматического парсера здесь нет. Это значит, что скилл не поймает ошибку за вас в CI — открывать артефакт и сверять диаграммы придётся вручную.
Какие задачи решает
- проверить относительные ссылки между страницами до коммита
- найти битые перекрёстные ссылки в базе знаний
- отловить сломанный рендер диаграммы Mermaid
- разобраться, почему метка с пунктуацией ломает парсер
- починить нечитаемые подписи из-за кастомной заливки
Примеры запросов агенту
- проверь относительные ссылки в docs/ перед коммитом
- посмотри диаграммы Mermaid в собранном HTML и скажи, что сломалось
- почему эта диаграмма не рендерится — проверь по правилам из resources/mermaid-authoring.md
Как установить md-validation
1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill md-validation -a claude-code2Вручную: положить файлы
~/.claude/skills/md-validation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/md-validation/
1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill md-validation -a codex2Вручную: положить файлы
.agents/skills/md-validation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill md-validation -a cursor2Вручную: положить файлы
.cursor/skills/md-validation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install haowjy/creative-writing-skills md-validation2Вручную: положить файлы
.github/skills/md-validation/SKILL.md1Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill md-validation -a gemini-cli2Командой платформы
gemini skills install https://github.com/haowjy/creative-writing-skills --path cw/skills/md-validationВручную: положить файлы
.devin/skills/md-validation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add haowjy/creative-writing-skills --skill md-validation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о md-validation
Как установить md-validation в Claude?
Выполните npx skills add haowjy/creative-writing-skills --skill md-validation -a claude-code. Скилл окажется в ~/.claude/skills/md-validation/SKILL.md.
Что делает md-validation?
Проверяет относительные ссылки между страницами и диаграммы Mermaid. Диаграммы смотрят в браузере, потому что синтаксическая ошибка проявляется сломанным рендером.
Нужен ли отдельный инструмент для проверки Mermaid?
Нет. Скилл советует открыть HTML-артефакт в браузере и проверить каждую диаграмму визуально — ошибки показываются как сломанный рендер, а не текстом.
Исходный текст
SKILL.md · Apache-2.0
--- name: md-validation description: Use when validating markdown links or Mermaid diagrams. --- # md-validation ## Mermaid Diagrams Validate Mermaid diagrams render correctly before shipping. Open the HTML artifact in a browser and check every diagram visually — syntax errors show as broken renders, not error messages. Common failure modes: - Unquoted labels with punctuation break the parse - Bare lowercase `end` collides with subgraph terminator - Node IDs starting with `o` or `x` after edge markers get misparsed - Custom fills without matching text color make labels unreadable See `resources/mermaid-authoring.md` for the full authoring rules (quoting, line breaks, reserved words, themes). ## Markdown Links Check that relative links between pages resolve. When building a multi-page artifact or KB, broken cross-references silently rot — verify each link target exists before committing.
© haowjy · Apache-2.0 · haowjy/creative-writing-skills
