# slack-markdown-formatter

Скилл slack-markdown-formatter переводит обычный markdown в формат Slack mrkdwn: жирный текст, ссылки, упоминания и код. Срабатывает, когда просишь оформить сообщение или уведомление для Slack.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 5 у репозитория
- Автор: sirkitree
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/sirkitree/slack-markdown-formatter/tree/HEAD/SKILL.md
- Обновлён: 2025-10-17
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/slack-markdown-formatter

## Что делает

Скилл подключается, когда нужно написать или переделать текст под Slack: заменяет `**bold**` на `*bold*`, markdown-ссылки `[текст](url)` переводит в формат `<url|текст>`, убирает заголовки и таблицы — Slack их не рендерит. Также добавляет упоминания пользователей и каналов (`<@U12345678>`, `<#C12345678>`), спецотметки `<!here>`, `<!channel>`, `<!everyone>` и формат даты `<!date^...>`.

Для сложных сообщений с кнопками, меню и структурированными блоками скилл советует переходить на Block Kit вместо обычного mrkdwn и указывает Block Kit Builder по адресу `https://api.slack.com/block-kit/building`. Внутри mrkdwn-текст вставляется в поле `text` с `"type": "mrkdwn"`.

Блоки кода в тройных кавычках Slack принимает, но без подсветки синтаксиса по языку — это отличается от GitHub-style markdown, где `python` после трёх кавычек задаёт раскраску.

## Требования
- Работает с: Slack

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sirkitree/slack-markdown-formatter slack-markdown-formatter
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- перевести жирный и курсивный текст из markdown в синтаксис Slack
- оформить ссылку в формате `<url|текст>` для сообщения в Slack
- собрать уведомление о деплое с упоминанием `<!here>` и статусом
- убрать из текста заголовки и таблицы, которые Slack не показывает
- вставить mrkdwn-текст в блок Block Kit с полем `type: mrkdwn`

## Примеры запросов агенту
- Оформи это сообщение для Slack: *жирный текст* и обычная ссылка на документацию
- Сделай уведомление в Slack о завершении деплоя с упоминанием `<!here>`
- Переведи этот код на Python в блок для отправки в Slack-канал

## Похожие
- [slack-bot](https://affpapa.org/nevibecode/skills/slack-bot.md) — скилл · 441 установка
- [slack-message-formatter](https://affpapa.org/nevibecode/skills/slack-message-formatter.md) — скилл · 354 установки
- [slack-messaging](https://affpapa.org/nevibecode/skills/slack-messaging.md) — скилл · 4100 установок
- [slack-channel](https://affpapa.org/nevibecode/skills/slack-channel.md) — скилл · ★ 79 у репозитория
- [slack](https://affpapa.org/nevibecode/plugins/slack.md) — плагин · ★ 172 у репозитория
- [slack-expert](https://affpapa.org/nevibecode/agents/slack-expert.md) — субагент · 246 установок

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

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