# block-kit

Собирает и проверяет Block Kit JSON для сообщений, модалок и Home tab в Slack. Пригодится, когда нужно быстро получить валидную раскладку без чтения документации вручную.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 500 установок · ★ 155
- Автор: slackapi
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/slackapi/slack-skills-plugin/tree/HEAD/skills/block-kit/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/block-kit

## Что делает

Скилл ведёт разработчика по шагам: выбрать поверхность, спланировать раскладку, сгенерировать JSON и прогнать его через `blocks.validate`. Типы блоков и элементов агент берёт из живых страниц `docs.slack.dev`, а не из памяти, поэтому схемы полей и примеры всегда актуальные.

Есть два режима. Если запрос конкретный, шаги сворачиваются в один проход: определить поверхность, подтянуть нужные страницы, собрать JSON, проверить. Если разработчик присылает готовый JSON, включается режим правки: агент разбирает блоки по индексам, спрашивает, что менять, и сохраняет существующие `block_id` и `action_id` — по ним завязаны обработчики событий в приложении.

Поверхность задаётся аргументом `[message | modal | home-tab]`. Для сообщения лимит 50 блоков, для модалки и Home tab — 100. У сообщений нужен верхнеуровневый `text`: `blocks.validate` его отсутствие не поймает, но именно это поле уходит в уведомления и скринридеры.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add slackapi/slack-skills-plugin --skill block-kit -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add slackapi/slack-skills-plugin --skill block-kit -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add slackapi/slack-skills-plugin --skill block-kit -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install slackapi/slack-skills-plugin block-kit
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add slackapi/slack-skills-plugin --skill block-kit -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/slackapi/slack-skills-plugin --path skills/block-kit
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add slackapi/slack-skills-plugin --skill block-kit -a opencode
```

### Claude.ai

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

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

## Когда брать
- собрать раскладку сообщения из секций и кнопок
- сделать форму в модалке с полями ввода
- опубликовать Home tab для пользователя
- поправить существующий Block Kit JSON, не сломав обработчики
- проверить блоки перед отправкой в Slack

## Примеры запросов агенту
- собери модалку с формой обратной связи через block-kit
- добавь в это сообщение actions block с двумя кнопками
- проверь мой Block Kit JSON и покажи ошибки

## Похожие
- [slack-bot](https://affpapa.org/nevibecode/skills/slack-bot.md) — скилл · 424 установки
- [slack-expert](https://affpapa.org/nevibecode/agents/slack-expert.md) — субагент · 246 установок
- [generative-ui](https://affpapa.org/nevibecode/skills/assistant-ui-generative-ui.md) — скилл · 1000 установок
- [chat-sdk](https://affpapa.org/nevibecode/skills/vercel-chat-sdk.md) — скилл · 5400 установок
- [slack-messaging](https://affpapa.org/nevibecode/skills/slack-messaging.md) — скилл · 4000 установок
- [slack-search](https://affpapa.org/nevibecode/skills/slack-search.md) — скилл · 3200 установок

Из того же набора: [slackapi/slack-skills-plugin](https://affpapa.org/nevibecode/by/slackapi/slack-skills-plugin.md) — 4 карточки

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

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