# markdown-style

Скилл markdown-style проверяет Markdown в два прохода: сначала синтаксис по канону, потом стиль. Показывает находки построчно и правит только то, что вы одобрили.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 125 установок · ★ 66 у репозитория
- Автор: JosiahSiegel
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/JosiahSiegel/claude-plugin-marketplace/tree/HEAD/plugins/doc-master/skills/markdown-style/SKILL.md
- Обновлён: 2026-06-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/markdown-style

## Что делает

Скилл держит два набора правил: канон синтаксиса по Markdown Guide и стилевой слой по стайлгайду Google. Полные списки лежат в `references/syntax-canon.md` и `references/style-overlay.md`, а в самом файле скилла — короткие таблицы частых нарушений.

Проверка идёт в два прохода. Сначала синтаксис: заголовки setext вместо ATX, блок кода без ограждения, пустая строка вокруг блока, `)` вместо `.` в нумерованном списке. Находки выдаются по одной: номер строки, исходный фрагмент, правило, исправленный вариант и вопрос, применять ли. Скилл ждёт ответа и массовых правок не делает. Второй проход стилевой: один H1, `[TOC]` в длинном документе, строки длиннее 80 символов, ссылки с текстом «здесь». Тут это советы, отказаться можно без объяснений.

Одобренные правки вносятся одним заходом. Пометок и штампов вроде `[reviewed]` в файле не остаётся, след виден в диффе. Если хочется разом переписать все нарушения, придётся отвечать на каждую находку: молча скилл не правит.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install JosiahSiegel/claude-plugin-marketplace plugins/doc-master/skills/markdown-style
```

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

### Gemini CLI

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

2. **Командой платформы**
```bash
gemini skills install https://github.com/JosiahSiegel/claude-plugin-marketplace --path plugins/doc-master/skills/markdown-style
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add JosiahSiegel/claude-plugin-marketplace --skill markdown-style -a opencode
```

### Claude.ai

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

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

## Когда брать
- поймать битую разметку в README до публикации
- переделать заголовки setext в ATX
- выровнять отступы во вложенных списках и коде внутри пункта
- найти строки длиннее 80 символов и ссылки с текстом «здесь»
- решить, нужен ли `[TOC]` в длинном документе

## Примеры запросов агенту
- Проверь `README.md`: сначала синтаксис, потом стиль.
- Пролинтуй `docs/adr-004.md` и выдай находки с номерами строк.
- Поправь заголовки и отступы списков в `CONTRIBUTING.md`.

## Похожие
- [markdown-formatter](https://affpapa.org/nevibecode/skills/markdown-formatter.md) — скилл · 245 установок
- [markdown-documentation](https://affpapa.org/nevibecode/skills/markdown-documentation.md) — скилл · 1300 установок
- [docs-markdown](https://affpapa.org/nevibecode/rules/docs-markdown.md) — правило · ★ 1198 у репозитория
- [technical-documentation](https://affpapa.org/nevibecode/skills/technical-documentation.md) — скилл · 1900 установок
- [brand-style-guide](https://affpapa.org/nevibecode/skills/brand-style-guide.md) — скилл · 486 установок
- [docs-review](https://affpapa.org/nevibecode/skills/docs-review.md) — скилл · 2000 установок

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

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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