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

md-validation · haowjy, claude — скилл для Claude Code: проверка Markdown

Скилл md-validation для Claude Code проверяет ссылки в Markdown и синтаксис Mermaid. Запускайте его после правок документации, до коммита.

Apache-2.0 441 установок ★ 601 обновлён 2026-11-07

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

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

md-validation работает в Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Он проверяет ссылки в Markdown, связи между страницами базы знаний и синтаксис диаграмм Mermaid. После перестройки дерева страниц скилл предлагает сверить граф ссылок до и после изменений.

Для проверок используются валидаторы проекта или среды; их команды и правила подавления предупреждений зависят от конкретного инструмента. Если среда содержит инструкции по проверке Markdown, скилл предлагает прочитать их перед запуском. Исправьте найденные проблемы и повторите проверку; о тех проверках, которые запустить не удалось, нужно сообщить.

Сгенерированные и сторонние файлы можно исключить, но сломанную страницу из дерева исключать нельзя. Для диаграмм с намеренно использованной конструкцией предупреждение подавляют только по нужной категории и с пояснением рядом с диаграммой. Правила создания диаграмм описаны в resources/mermaid-authoring.md.

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

  • найти битые ссылки в Markdown
  • сверить граф ссылок после перестройки дерева страниц
  • проверить синтаксис диаграммы Mermaid
  • повторять проверки после исправления замечаний

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

  • Проверь ссылки в Markdown и найди страницы с ошибками перед коммитом.
  • Сверь граф ссылок до и после перестройки дерева документации.
  • Проверь синтаксис Mermaid в изменённых диаграммах и исправь замечания.

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

1Через Skills CLI (Vercel)

npx skills add haowjy/creative-writing-skills --skill md-validation -a claude-code

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

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

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

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

Вопросы о md-validation

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

Выполните npx skills add haowjy/creative-writing-skills --skill md-validation -a claude-code. Файл скилла находится по пути ~/.claude/skills/md-validation/SKILL.md.

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

Скилл проверяет Markdown-ссылки, граф ссылок базы знаний и синтаксис Mermaid. После изменений он помогает найти проблемы и повторить проверку после исправлений.

Какие файлы можно исключить из проверок?

Можно исключать сгенерированные и сторонние материалы. Сломанные страницы, принадлежащие дереву документации, исключать нельзя.

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

SKILL.md · Apache-2.0
---
name: md-validation
description: 'Load after writing, moving, or linking markdown pages or Mermaid diagrams, before committing them: validates links, the KB link graph, and diagram syntax.'
metadata:
  type: reference
---

# Markdown Validation

Validate links before committing documentation changes, and read the link graph
before and after restructuring a tree. Validate Mermaid syntax and style after
diagram edits. Fix every reported issue and repeat the validation until it is clean.

Use the validators your project or runtime provides. Their commands, warning
categories, suppression comments, and ignore files belong to that tool: when
the runtime offers Markdown-validation guidance, read it before running them.
Report any check you could not run.

When a warning marks a construct you meant, suppress only that category, as
narrowly as the validator allows, with the reason beside the diagram. Exclude
generated or vendored material from validation; never exclude a broken page
that belongs to the tree.

See `resources/mermaid-authoring.md` for diagram authoring rules.

© haowjy · Apache-2.0 · haowjy/creative-writing-skills

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

Все скиллы по теме «Тексты и документация» →

Сначала — md-validation от других авторов.

md-validation haowjy Скилл md-validation для Claude Code проверяет ссылки в Markdown и диаграммы Mermaid. Он включается по запросу проверить ссылки или Mermaid перед сдачей материала. CX Codex +1 441установок link-validation terrylica Скилл link-validation проверяет ссылки в markdown-файлах проекта офлайн через lychee: относительные пути, корневые пути и якоря. Пригодится перед коммитом документации. CX Codex +1 135установок docs-maintenance davila7 Команда docs-maintenance для Claude Code проверяет документацию, ссылки, структуру и стиль и помогает подготовить обновления. Проводит регулярный аудит Markdown-файлов. CX Codex +1 1 146установок fixing-broken-links spencerpauly Скилл fixing-broken-links находит в файлах проекта битые внешние URL и локальные пути, проверяет их ответы через curl и заменяет на актуальные адреса. CX Codex +1 434установок dart-doc-validation kevmoo Скилл dart-doc-validation учит агента проверять комментарии документации в Dart-коде командой dart doc и включать линт comment_references, чтобы ловить битые ссылки на классы, методы и макросы. CX Codex +1 291установок link-validator terrylica Скилл link-validator проверяет markdown-ссылки в навыках на предмет абсолютных путей, которые сломаются при установке в другое место. Нужен перед распространением навыка или после добавления новых ссылок. CX Codex +1 127установок oma-docs First Fluke Сверяет ссылки в документации, обновляет тексты под изменения в коде и находит рассинхрон в переводах. Работает через CLI oma docs или ручной парсинг ссылок. CX Codex +1 ★ 1 472звёзд репо

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

Весь набор →
zoom-out Скилл zoom-out для Claude Code помогает освоиться в незнакомой части проекта. Он собирает карту структуры, знаний и истории решений по запросу сориентировать в коде. CX Codex +1 443установок structured-artifact Скилл structured-artifact для сборки структурированных HTML-артефактов: помогает агенту решить, как подать материал, и только потом выбрать инструменты. CX Codex +1 443установок qi-layer Скилл qi-layer задаёт правила описания контекста и ролей агентов в файлах AGENTS.md и .context/CONTEXT.md. Включается при настройке и поддержке системных инструкций проекта. CX Codex +1 441установок knowledge-layers Скилл knowledge-layers для Claude Code распределяет знания проекта между локальной документацией, базой знаний и рабочими папками. Активируется при чтении или записи постоянной документации и выборе места для новых сведений. CX Codex +1 441установок md-validation Скилл md-validation для Claude Code проверяет ссылки в Markdown и диаграммы Mermaid. Он включается по запросу проверить ссылки или Mermaid перед сдачей материала. CX Codex +1 441установок knowledge-layers Скилл knowledge-layers для Claude Code решает, в какой слой проекта писать знание: AGENTS.md, .context/, KB, docs/ или рабочий каталог. Устраняет путаницу агента при поиске контекста. CX Codex +1 441установок qi-layer Скилл qi-layer задаёт правила, по которым агент пишет и поддерживает AGENTS.md и .context/CONTEXT.md, чтобы инструкции оставались короткими и рабочими. CX Codex +1 441установок reflect Скилл reflect проверяет результат работы перед финальным отчётом и направляет сохранённые знания в файлы проекта. Пригодится, чтобы сверить ожидания и зафиксировать важные детали сессии. CX Codex +1 438установок

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

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