Набор скиллов @bitrix24/b24jssdk
@bitrix24/b24jssdk skills
Семь официальных скиллов Битрикс24 для JS/TS SDK: выбор B24Hook, B24Frame или B24OAuth, REST-вызовы, фильтры, iframe-менеджеры и 12 готовых мини-приложений
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Сгенерированный код через B24Hook или B24OAuth обращается к боевому порталу Битрикс24
- Рецепты включают массовую рассылку и синхронизацию с ERP, ошибка в сгенерированном коде может задеть много записей
Установка
Ручная установка
mkdir -p .claude/skills
cp -R path/to/b24jssdk/skills/b24jssdk-* .claude/skills/Устанавливает скиллы на уровень проекта, поделиться с командой можно закоммитив .claude/skills. Для личной установки на все проекты используйте ~/.claude/skills вместо .claude/skills.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
В папке skills репозитория лежат семь скиллов для @bitrix24/b24jssdk. b24jssdk-core объясняет, какую точку входа выбрать: B24Hook для Node-скриптов на вебхуке, B24Frame для приложения внутри iframe Битрикс24, B24OAuth для серверных приложений с обновлением токена, и как настроить логирование и политику повтора при ошибках. Остальные скиллы покрывают REST-вызовы через actions.v2/v3, два диалекта фильтров, доступные только в iframe UI-менеджеры вроде диалогов выбора пользователя, хелперы вроде форматирования валюты и Pull-клиента, а также b24jssdk-recipes с двенадцатью законченными мини-приложениями: CRM-аналитика, синхронизация с ERP, Telegram-бот, массовая рассылка, автоматизация задач, ИИ-ассистент и другие. Снипеты во всех скиллах компилируются в CI.
Для кого. Для JS/TS-разработчиков, которые пишут приложения и скрипты для Битрикс24 на @bitrix24/b24jssdk.
Подходит, если
- Начинаете новую интеграцию и не уверены, какую точку входа SDK выбрать
- Пишете фильтр для списка сущностей Битрикс24 и путаетесь между v2 и v3 синтаксисом
- Нужен готовый образец: телеграм-бот, синхронизация с ERP или обработчик вебхука на b24jssdk
Не подходит, если
- Нужен UI-кит компонентов, а не сам SDK: для интерфейса есть отдельный скилл b24-ui-nuxt в репозитории b24ui
- Проект не использует @bitrix24/b24jssdk
Пример запроса к агенту
Напиши серверный скрипт на b24jssdk через B24Hook, который фильтрует сделки CRM по дате создания за последнюю неделюОграничения
Снипеты в скиллах проверены компиляцией в CI, но, по признанию авторов, еще не верифицированы на живом портале Битрикс24, кроме случаев, покрытых веб-хуком, это отдельная открытая задача проекта. Скиллы нужно вручную скопировать в свой проект, готового пакетного менеджера установки нет.
Как отключить. Удалите папки b24jssdk-* из .claude/skills вашего проекта или личной папки ~/.claude/skills.
Проверка безопасности
- Сгенерированный код через B24Hook или B24OAuth обращается к боевому порталу Битрикс24
- Рецепты включают массовую рассылку и синхронизацию с ERP, ошибка в сгенерированном коде может задеть много записей
Коротко о README
Документация проекта на странице AI Skills перечисляет все семь скиллов с кратким назначением и статусом верификации, объясняет два способа использования: инлайн-ссылку на файл внутри репозитория SDK и установку копированием в .claude/skills личного или проектного уровня, с примерами команд mkdir и cp -R.
SKILL.md
---
name: b24jssdk-core
description: Pick and initialize the right b24jssdk entry point (B24Hook for backends, B24Frame for in-iframe apps, B24OAuth for OAuth-installed apps), wire up logging, handle errors, and tune restriction-manager retry behaviour (hardErrorCodes, softErrorCodes, retryOnNetworkError). Load first when generating any b24jssdk code.
---
# b24jssdk core
Three entry points share the same REST surface, exposed via $b24.actions.v{2,3}.*. Pick by where the code runs:
| Entry point | Where | Auth source |
| --- | --- | --- |
| B24Hook | Node.js / scripts / serverless | inbound webhook URL (/rest/<userId>/<secret>) |
| B24Frame | Browser, inside a Bitrix24 placement iframe | postMessage handshake with the parent window |
| B24OAuth | Server side of an OAuth-installed Bitrix24 app | accessToken + refreshToken from Bitrix24 install events |
Once initialized, write the rest of your code against the abstract type TypeB24 so the same logic runs on any of the three.Частые вопросы
Какой скилл загружать первым?
b24jssdk-core: он выбирает точку входа B24Hook, B24Frame или B24OAuth, а остальные скиллы пишутся уже поверх выбранного клиента $b24.
Можно ли использовать скиллы вне Claude Code?
Да, каждый SKILL.md это обычный markdown-файл по открытому стандарту Agent Skills, его читают и другие агенты, например Cursor или GitHub Copilot.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything