# markdown-formatter

Скилл markdown-formatter приводит markdown-файлы к единому стилю: заголовки, списки, блоки кода, ссылки, пробелы. Проверяет результат скриптом и показывает, что исправлено.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 245 установок · ★ 25 у репозитория
- Автор: markpitt
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/markpitt/claude-skills/tree/HEAD/skills/markdown-formatter/SKILL.md
- Обновлён: 2026-02-19
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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`. Агенту разрешены чтение, правка, поиск и запуск только этого скрипта, других команд он не выполняет.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill markdown-formatter -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill markdown-formatter -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill markdown-formatter -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install markpitt/claude-skills skills/markdown-formatter
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill markdown-formatter -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/markpitt/claude-skills --path skills/markdown-formatter
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add markpitt/claude-skills --skill markdown-formatter -a opencode
```

### Claude.ai

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

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

## Когда брать
- выровнять заголовки в README: один H1, без пропущенных уровней
- заменить смешанные маркеры списков на `-`
- проставить язык у огороженных блоков кода
- дописать alt-текст к скриншотам в документации
- убрать хвостовые пробелы и лишние пустые строки перед коммитом

## Примеры запросов агенту
- Приведи `docs/README.md` к единому стилю: заголовки, списки, блоки кода.
- Прогони `./skills/markdown-formatter/scripts/validate-markdown.sh -- README.md` и почини то, что он найдёт.
- В `CHANGELOG.md` допиши alt-текст картинкам и замени ссылки с текстом `click here` на описательные.

## Похожие
- [markdown-style](https://affpapa.org/nevibecode/skills/markdown-style.md) — скилл · 125 установок
- [verifying-markdown-formatting](https://affpapa.org/nevibecode/skills/verifying-markdown-formatting.md) — скилл · 446 установок
- [markdown-documentation](https://affpapa.org/nevibecode/skills/markdown-documentation.md) — скилл · 1300 установок
- [docs-markdown](https://affpapa.org/nevibecode/rules/docs-markdown.md) — правило · ★ 1198 у репозитория
- [slack-message-formatter](https://affpapa.org/nevibecode/skills/slack-message-formatter.md) — скилл · 354 установки
- [slack-markdown-formatter](https://affpapa.org/nevibecode/skills/slack-markdown-formatter.md) — скилл · 1 установка

Из того же набора: [markpitt/claude-skills](https://affpapa.org/nevibecode/by/markpitt/claude-skills.md) — 10 карточек

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