Публикация плагина
Как собрать плагин из навыков, правил и подключений и опубликовать его в каталоге «Разума» — формат, проверки и ревью.
Плагин из каталога видят все пользователи «Разума»: они ставят его одной кнопкой в «Персонализация → Плагины → Магазин». Опубликовать можно набор навыков, правил и сценариев или удалённое подключение к своему сервису.
Что можно опубликовать
| Часть | Где лежит | Что это |
|---|---|---|
| Навыки | skills/<имя>/SKILL.md | Инструкции для типовых задач, description во frontmatter обязателен. → Навыки |
| Правила | rules/*.mdc | Как работать в области плагина. → Правила |
| Сценарии | playbooks/*.md | Пошаговые сценарии работы |
| Подключения | mcp.json | Удалённые MCP-серверы по https. → Подключения |
Пока не принимаем: исполняемый код и локальные (stdio) MCP-серверы, пакеты через
npx/uvx, hooks, inProcess, вход через сессию «Разума» (auth.session) и
OAuth-клиенты «Разума» (clientRef), systemAdminOnly.
Раскладка
my-plugin/
├── .razum-plugin/
│ └── plugin.json манифест
├── skills/
│ └── crm/SKILL.md
├── rules/ *.mdc
├── playbooks/ *.md
├── mcp.json
├── assets/ картинки
└── README.mdВ каталог попадают только эти папки и файлы. Остальное в репозитории — CI, исходники сервера, тесты — не берётся.
Манифест
{
"name": "my-crm",
"version": "1.0.0",
"description": "Клиенты, сделки и задачи из CRM.",
"author": { "name": "ООО «Пример»", "email": "dev@example.ru" },
"homepage": "https://example.ru/razum",
"auth": {
"token": {
"header": { "name": "Authorization", "value": "Bearer {token}" },
"docsUrl": "https://crm.example.ru/settings/api"
}
}
}name— строчная латиница, цифры, точка и дефис. Имена, начинающиеся сrazum, и имена плагинов «Разума» зарезервированы; имя, занятое другим автором, не пройдёт.auth.token— пользователь вставит свой токен API, а «Разум» подставит его в заголовок вместо{token}.docsUrl— страница, где взять токен; ссылка появится рядом с полем ввода. Если сервер сам проводит вход по OAuth, блокauthне нужен.
Подключение
{
"mcpServers": {
"crm": {
"url": "https://mcp.crm.example.ru/mcp",
"mutatingTools": ["create_deal", "update_contact"]
}
}
}Отметьте инструменты, которые меняют данные: перечислите их в mutatingTools или
поставьте readOnlyHint у читающих инструментов на стороне сервера. Перед вызовом
пишущего инструмента пользователь подтверждает действие.
Проверить у себя
Перед отправкой поставьте плагин из папки: «Персонализация → Плагины → Загрузить из
папки» и выберите папку с .razum-plugin/plugin.json. Попросите агента выполнить задачу,
ради которой плагин делался, и убедитесь, что навыки подхватываются по описанию.
Отправить в каталог
Положите плагин на GitHub
Нужен публичный репозиторий — плагин может лежать в корне или в подпапке, в любой ветке.
Откройте заявку
«Персонализация → Плагины → Магазин → Отправить в каталог». Укажите репозиторий:
ссылку или owner/repo. Ссылка на папку в ветке (или owner/repo@ветка) сама заполнит
папку и ветку.
Пройдите проверку
Нажмите «Проверить»: платформа возьмёт последний коммит ветки и прогонит автоматическую проверку. Ошибки исправьте в репозитории и проверьте снова.
Заполните карточку
- Карточка — название, описание в одно-два предложения, категория, автор, страница плагина.
- Работа с данными — какие данные плагин читает, куда отправляет, хранит ли их у себя и работает ли с персональными данными.
- Соответствие — почта для связи, компания или ИП и согласие с правилами каталога.
Отправьте на проверку
Заявку посмотрит модератор каталога. Статус и переписка с модератором — в «Мои заявки».
| Статус | Что значит |
|---|---|
| Черновик | Заявка ещё не отправлена |
| На проверке | Заявку смотрит модератор, ответ придёт в «Мои заявки» |
| Нужны правки | Модератор просит доработать — подробности в переписке |
| Опубликован | Плагин в каталоге |
| Новая версия на проверке | Новый коммит ждёт ревью, пользователи пока видят прежнюю версию |
| Отклонён | Заявка не прошла ревью |
Автоматическая проверка
- Манифест
.razum-plugin/plugin.jsonна месте, имя допустимо и свободно. - Лимиты: до 400 файлов и 5 МБ всего, файл — до 1 МБ. Без двоичных файлов (картинки можно) и символических ссылок.
- Секреты: токены GitHub, OpenAI, Anthropic, AWS, Slack, Google, Яндекса, Telegram и приватные ключи блокируют заявку. Утёкший ключ выпустите заново — удалить его из истории недостаточно.
- Подключения: только
httpsи не на адрес платформы «Разума». - Внешние адреса: все хосты, которые встречаются в файлах, попадают в отчёт проверяющему.
Критерии ревью
- Безопасность. Навыки и правила не велят агенту отправлять данные пользователя туда, где они плагину не нужны, обходить подтверждения, запускать команды или скрывать действия.
- Честность. Хосты подключений принадлежат заявленному сервису; работа с данными в заявке совпадает с файлами. Плагин делает то, что написано в карточке.
- Польза. В описании навыков сказано, когда их звать; плагин не заглушка и не копия плагина «Разума»; карточка понятна.
- Права. У вас есть права на содержимое репозитория.
Обновления
После публикации выбранная ветка отслеживается: каждый новый коммит проходит автоматическую проверку и ревью, прежде чем дойдёт до пользователей. Установленные копии обновляются сами. «Разум» может снять плагин с публикации, если он перестанет соответствовать правилам каталога.