bitrix24-vibecode

Скилл для разработки на VibeCode Битрикс24: навигация по документации, ключи и авторизация, деплой на Black Hole и частые ошибки

СкиллНизкий рискРоссийский стек

lucky-naty/bitrix24-vibecode

Установка

Склонируй github.com/lucky-naty/bitrix24-vibecode в ~/.claude/skills/bitrix24-vibecode (для Codex в ~/.codex/skills/bitrix24-vibecode), чтобы SKILL.md и references лежали в корне папки.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл помогает агенту уверенно работать с платформой VibeCode Битрикс24, не перечитывая всю документацию. Он сначала определяет тип задачи и открывает нужный раздел, а сведения о платформе подгружает только при необходимости. В справочниках разобраны три типа ключей и когда какой нужен, различие между API VibeCode и нативным REST Битрикс24, пошаговый деплой приложения с ожиданием статусов и таблицей ошибок, приложения во фрейме с идентификацией оператора, роботы бизнес-процессов и лимиты запросов. Отдельный чеклист перечисляет предсказуемые ошибки, найденные автором на практике.

Для кого. Для разработчиков, которые делают интеграции, ботов и приложения Битрикс24 на платформе VibeCode.

Подходит, если

  • Нужно задеплоить приложение в VibeCode и понять, почему оно недоступно
  • Нужно выбрать правильный тип ключа для интеграции
  • Нужно сделать приложение во вкладке карточки CRM или робота для бизнес-процесса

Не подходит, если

  • Работаете с коробочным Битрикс24 или обычным REST без VibeCode
  • Нужна интеграция с Битрикс24 через MCP-сервер

Пример запроса к агенту

Задеплой это приложение в VibeCode и разберись, почему после деплоя оно недоступно

Ограничения

Скилл собран из публичной документации VibeCode и наблюдений автора, часть кодов ошибок и лимитов помечена как наблюдаемая, а не документированная. Платформа меняется, поэтому точные параметры агент должен сверять с живой документацией. Сам скилл ничего не запускает, но задачи, для которых он нужен, требуют ключей VibeCode.

Как отключить. Удалите папку bitrix24-vibecode из ~/.claude/skills или ~/.codex/skills.

Проверка безопасности

  • Скилл состоит только из инструкций и справочников

Коротко о README

README описывает минимальную структуру: корень репозитория и есть папка скилла, внутри SKILL.md и шесть справочников. Объяснено, какие ошибки скилл помогает не повторять: выбор ключа, путаница API, модель деплоя, массовые операции. Подробный журнал изменений фиксирует результаты проверки платформы, новые подводные камни и исправления по документации. В конце перечислены разделы документации VibeCode, из которых собран скилл. Лицензия MIT.

SKILL.md

---
name: bitrix24-vibecode
description: Use when working with VibeCode Bitrix24 apps, integrations, bots, or AI Router workflows.
---

# VibeCode Docs

## Overview

Use this skill to route through VibeCode docs quickly, keep platform invariants straight, and avoid re-deriving basics.

## Workflow

1. Identify the task type before reading docs in depth.
2. Load [references/section-routing.md](references/section-routing.md) and open only the most relevant section first.
3. Load [references/universal-knowledge.md](references/universal-knowledge.md) only when the task touches build, deploy, auth, API conventions, scaling, or error handling.
4. Load [references/anti-footguns.md](references/anti-footguns.md) only before implementation or debugging.
5. Confirm endpoint-level details from the live docs only when the answer depends on exact parameter names, current limits, or current behavior.
6. Distinguish VibeCode platform behavior from native Bitrix24 behavior.

## Load Minimally

- For explanation-only questions, start with `section-routing` and stop unless the answer needs platform invariants.
- For implementation or debugging, read `universal-knowledge` before writing code.
- For exact request shapes or current behavior, verify against the live docs instead of relying on memory.

## Task Patterns

### App, Bot, Or Integration Build

Use quick start plus the target domain section. Default flow:

1. Inspect capabilities with `/v1/me`
2. Build against Entity API or another target API
3. Create infrastructure if deployment is needed
4. Deploy and wait for `running` plus `CONNECTED`

### Auth And Access Questions

Open keys/auth first. Decide from the key prefix whether the task is personal (`vibe_api_`), OAuth app (`vibe_app_`), or management (`vibe_live_`). For OAuth app requests, remember that a bearer session token may also be required for user-context calls.

Частые вопросы

Чем помогает при деплое?

В deploy-playbook описан линейный порядок: упаковка, деплой с ожиданием статусов running и CONNECTED, повторный деплой и таблица симптомов, причин и исправлений.

Есть ли версия для Codex?

Да, скилл нейтральный к платформе, а для Codex есть необязательный agents/openai.yaml.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний риск286,6 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск262 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Выбор редакции

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,3 тыс.
Выбор редакции

Актуальная документация и примеры кода нужной версии библиотеки прямо в контексте агента, через MCP или CLI со скиллом

MCP-серверСредний риск62 тыс.