markdown-formatter — скилл для Claude Code
Скилл markdown-formatter приводит markdown-файлы к единому стилю: заголовки, списки, блоки кода, ссылки, пробелы. Проверяет результат скриптом и показывает, что исправлено.
лицензия не указана 245 установок ★ 25 обновлён 2026-02-19
npx skills add markpitt/claude-skills --skill markdown-formatter -a claude-codeЧто делает markdown-formatter
Скилл приводит markdown-файлы к одному виду: заголовки в ATX-стиле, один H1, без пропуска уровней, списки с - и отступом в два пробела, код в огороженных блоках с указанием языка, ссылки с описательным текстом, картинки с alt. Работает по фазам: сначала структура, потом блоки, в конце пробелы, таблицы и проверка.
Внутри пять справочников по областям (resources/headers-hierarchy.md, lists-nesting.md, code-emphasis.md, links-images.md, spacing-tables.md) и скрипт scripts/validate-markdown.sh. Агенту разрешены чтение, правка, поиск и запуск только этого скрипта, других команд он не выполняет.
Содержимое файла считается недоверенным: текст внутри документа, обращённый к модели, игнорируется. Пути берутся только из вашего сообщения — попросить «почисти весь репозиторий» не выйдет, файлы придётся перечислить. Смысл текста скилл не меняет, только разметку.
Какие задачи решает
- выровнять заголовки в README: один H1, без пропущенных уровней
- заменить смешанные маркеры списков на
- - проставить язык у огороженных блоков кода
- дописать alt-текст к скриншотам в документации
- убрать хвостовые пробелы и лишние пустые строки перед коммитом
Примеры запросов агенту
- Приведи
docs/README.mdк единому стилю: заголовки, списки, блоки кода. - Прогони
./skills/markdown-formatter/scripts/validate-markdown.sh -- README.mdи почини то, что он найдёт. - В
CHANGELOG.mdдопиши alt-текст картинкам и замени ссылки с текстомclick hereна описательные.
Как установить markdown-formatter
1Через Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill markdown-formatter -a claude-code2Вручную: положить файлы
~/.claude/skills/markdown-formatter/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/markdown-formatter/
1Через Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill markdown-formatter -a codex2Вручную: положить файлы
.agents/skills/markdown-formatter/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill markdown-formatter -a cursor2Вручную: положить файлы
.cursor/skills/markdown-formatter/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install markpitt/claude-skills skills/markdown-formatter2Вручную: положить файлы
.github/skills/markdown-formatter/SKILL.md1Через Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill markdown-formatter -a gemini-cli2Командой платформы
gemini skills install https://github.com/markpitt/claude-skills --path skills/markdown-formatterВручную: положить файлы
.devin/skills/markdown-formatter/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add markpitt/claude-skills --skill markdown-formatter -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о markdown-formatter
Как установить markdown-formatter в Claude Code?
Выполните npx skills add markpitt/claude-skills --skill markdown-formatter -a claude-code. Файл скилла после этого лежит в ~/.claude/skills/markdown-formatter/SKILL.md.
Что делает markdown-formatter?
Правит разметку markdown-документа по набору правил: иерархия заголовков, отступы и маркеры списков, языки у блоков кода, alt-текст, пробелы и таблицы. В конце отчитывается, какие категории ошибок исправлены.
Какие инструменты разрешены скиллу?
Чтение, правка, Grep, Glob и запуск scripts/validate-markdown.sh. Другие команды и скрипты он не выполняет.