md-validation · haowjy, claude — скилл для Claude Code: проверка Markdown
Скилл md-validation для Claude Code проверяет ссылки в Markdown и синтаксис Mermaid. Запускайте его после правок документации, до коммита.
Apache-2.0 441 установок ★ 601 обновлён 2026-11-07
npx skills add haowjy/creative-writing-skills --skill md-validation -a claude-codeЧто делает 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-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 plugin/claude/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 plugin/claude/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 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 от других авторов.