Bitrix Framework Skills: скиллы для ИИ-агентов на 1С-Битрикс D7 и Битрикс24

Скиллы для Claude Code, Cursor и Codex, чтобы ИИ писал код на 1С-Битрикс по канону D7, а не legacy. 50 скиллов: ORM, контроллеры, кеш, безопасность, инфоблоки, компоненты, интернет-магазин и Битрикс24 (CRM, задачи, REST, MCP). Ставятся одной командой в любой проект.

Зачем: нейросеть пишет на Битриксе по-старому

Без подсказок нейросеть пишет для Битрикса старым API: CIBlockElement::GetList, $DB->Query со склейкой SQL, глобальные $USER и $APPLICATION, код вне /local/. Такой код работает, но его трудно поддерживать, а безопасность и кеш остаются на совести разработчика. Скиллы дают агенту канон D7: ORM, контроллеры, сервисы через DI, проверки CSRF и прав, тегированный кеш. Агент открывает нужный скилл сам, когда задача его касается.

Это не официальная документация Битрикса, а правила, как писать код в /local/. Документация по продукту — на docs.1c-bitrix.ru («1С-Битрикс: Управление сайтом») и apidocs.bitrix24.ru (REST Битрикс24).

Установка в Claude Code, Cursor и Codex

npx skills add bxmaximum/bitrix-framework-skills --skill '*'

Запустите в корне проекта. CLI skills спросит, в какие агенты ставить. Скиллы попадут в .agents/skills/ (для Claude Code — ещё и в .claude/skills/).

Другие способы

Без вопросов, сразу в нужные агенты (Cursor, Codex и другие читают общую папку .agents/skills/):

npx skills add bxmaximum/bitrix-framework-skills --skill '*' -a claude-code cursor -y

Попросить агента:

Добавь в проект скиллы из репозитория https://github.com/bxmaximum/bitrix-framework-skills

Только нужные скиллы или список без установки:

npx skills add bxmaximum/bitrix-framework-skills --skill bitrix-framework bitrix-orm bitrix-controllers
npx skills add bxmaximum/bitrix-framework-skills --list   # список без установки

При выборочной установке PHP-скиллов добавляйте bitrix-framework: он содержит общие правила и политику версий. Клиентский облачный REST можно установить отдельно как bitrix24-rest-api.

Обновление:

npx skills update

Флаг --all не советуем: это --skill '*' --agent '*' -y, скиллы ставятся сразу во все ~60 поддерживаемых агентов, и в проекте появляются десятки папок вроде .windsurf/, .roo/.

AGENTS.md

Общие правила — /local/, D7, границы DI, безопасность, политика версий — лежат в скилле bitrix-framework. При установке всего набора он включён; при выборочной установке его нужно указать. Профильные PHP-скиллы просят прочитать канон один раз перед кодом, поэтому отдельный системный промпт не обязателен.

AGENTS.md — короткая инструкция: язык ответов, порядок работы и индекс скиллов. Индекс нужен агентам, которые не показывают модели список установленных скиллов. Файл можно скопировать в корень проекта или подключить как rule в Cursor. Claude Code читает CLAUDE.md, поэтому рядом положите CLAUDE.md с одной строкой @AGENTS.md, как в этом репозитории.

Другие агенты

Скиллы работают в любом агенте, который видит name/description и умеет открыть SKILL.md и файлы rules/. Весь набор читать не нужно: обычно хватает канона, одного профильного скилла и одной-двух тем. Если агент не выбрал скилл сам, укажите его имя в запросе.

Пример: выборка из инфоблока без скиллов и со скиллами

Задача: 10 активных новостей автора «Иван Петров».

Без скиллов агент часто пишет так:

CModule::IncludeModule('iblock');

$res = CIBlockElement::GetList(
    ['SORT' => 'ASC'],
    ['IBLOCK_ID' => 5, 'ACTIVE' => 'Y', 'PROPERTY_AUTHOR' => 'Иван Петров'],
    false,
    ['nTopCount' => 10],
    ['ID', 'NAME', 'PREVIEW_TEXT', 'PROPERTY_AUTHOR']
);
while ($row = $res->GetNext()) {
    $items[] = $row;
}

Это работает, но ID инфоблока зашит в код и на другом стенде будет другим. Свойства идут через PROPERTY_*, результат — массивы без типов.

Со скиллом bitrix-iblocks агент берёт ORM D7:

use Bitrix\Iblock\Elements\ElementNewsTable;
use Bitrix\Main\Loader;

Loader::includeModule('iblock');

$news = ElementNewsTable::query()
    ->setSelect(['ID', 'NAME', 'PREVIEW_TEXT', 'AUTHOR'])
    ->where('ACTIVE', 'Y')
    ->where('AUTHOR.VALUE', 'Иван Петров')
    ->setOrder(['SORT' => 'ASC'])
    ->setLimit(10)
    ->setCacheTtl(3600)
    ->cacheJoins(true)
    ->fetchCollection();

Класс ElementNewsTable ядро создаёт само для инфоблока с API_CODE = News. Инфоблок находится по коду, без ID.
Свойство AUTHOR — поле ORM: его можно выбрать и отфильтровать (AUTHOR.VALUE).
Кеш запроса включён вместе с JOIN свойств.
Результат — коллекция объектов: $item->getName(), $item->getAuthor()?->getValue().

Скилл заодно предупреждает: ORM не проверяет права на инфоблок и даты активности, это нужно сделать отдельно. Пример взят из skills/bitrix-iblocks/rules/. Оба фрагмента проходят php -l и tools/verify-skills.php на main 26.800.0.

Каталог скиллов

Каждый скилл — skills/<name>/SKILL.md. Большие скиллы разбиты на темы в rules/*.md: агент читает только нужный файл, поэтому 50 скиллов не забивают контекст.

Область	Skill
Каноны, версии, DI, безопасность — начать отсюда	`bitrix-framework`
Структура проекта, Loader, `/local`	`bitrix-project-structure`
Секции `.settings.php` ядра	`bitrix-settings`
Создание модулей, install/uninstall	`bitrix-modules`
CLI, `make:*`, cron, команды	`bitrix-console-commands`
Контроллеры, actions, фильтры	`bitrix-controllers`
Роутинг, генерация URL	`bitrix-routing`
Application, Context, Request/Response	`bitrix-request-response`
Валидация, DTO на атрибутах	`bitrix-validation`
CSRF, XSS, SQL-инъекции, SSRF, права, JWT	`bitrix-security`
Сессии, separated mode	`bitrix-sessions`
ServiceLocator, DI	`bitrix-service-locator`
Result, Error, ErrorCollection	`bitrix-result-and-errors`
События (D7 и legacy)	`bitrix-events`
Агенты, background jobs, Messenger	`bitrix-background-jobs`
PSR-3 logging	`bitrix-logger`
ORM: сущности, запросы, связи, объекты	`bitrix-orm`
SQL, транзакции, SqlHelper	`bitrix-database`
PostgreSQL: подключение, переход с MySQL	`bitrix-postgresql`
Кеш: Data\Cache, тегированный, кеш ORM и компонентов	`bitrix-caching`
Настройки модулей, фича-флаги, хранилище с TTL	`bitrix-storage`
Миграции БД/схемы (sprint.migration)	`bitrix-sprint-migration`
Date/DateTime, часовые пояса	`bitrix-datetime`
Локализация, Loc	`bitrix-localization`
HttpClient, SSRF, GeoIP	`bitrix-http-client`
Почтовые события, SMTP	`bitrix-mail`
Файлы, `CFile`, загрузка	`bitrix-files`
Производительность, композит, реплики	`bitrix-performance`
Компоненты, шаблоны, SEF	`bitrix-components`
JS/CSS extensions	`bitrix-extensions`
UI kit (popup, sidepanel, grid, формы)	`bitrix-ui`
BitrixVue 3	`bitrix-vue`
Pull-сервер, real-time	`bitrix-pull`
CMS: сайты, шаблоны, меню, пагинация, пользовательские поля	`bitrix-cms-basics`
Инфоблоки, свойства, SEO-шаблоны	`bitrix-iblocks`
Highload-блоки	`bitrix-highloadblock`
Landing, конструктор страниц	`bitrix-landing`
sitemap.xml, robots.txt, вебмастера	`bitrix-seo`
Модуль поиска, индексация	`bitrix-search`
Генератор документов	`bitrix-documentgenerator`
Торговый каталог, цены, SKU	`bitrix-catalog`
Интернет-магазин, заказы, оплата	`bitrix-sale`
Бизнес-процессы	`bitrix-bizproc`
Свои REST-методы модуля, REST 3.0	`bitrix-rest`

Битрикс24:

Область	Skill
REST API снаружи: вебхуки, OAuth, batch, лимиты, события, REST 3.0	`bitrix24-rest-api`
Официальный MCP документации, Vibecode	`bitrix24-ai-tools`
CRM в коробке: Factory, Item, смарт-процессы, права, события	`bitrix24-crm`
Задачи в коробке	`bitrix24-tasks`
Чаты, уведомления, боты в коробке	`bitrix24-im`
Кастомизация портала: страницы, меню, структура, диск	`bitrix24-portal`

MCP для Битрикс24: документация REST в агенте

Для работы с REST Битрикс24 подключите официальный MCP-сервер документации: он ищет методы, поля и события в актуальной документации REST. Доступа к данным портала у него нет, авторизация не нужна.

claude mcp add --transport http b24-dev-mcp https://mcp-dev.bitrix24.com/mcp

Настройка для Cursor, Codex и других клиентов — в скилле bitrix24-ai-tools.

Как проверяются скиллы

Проверка выполняется по ядру коробки Битрикс24 main 26.1000.0. Версии остальных модулей указаны в Verified соответствующих скиллов. Каждый PHP-пример проверяется через php -l, а классы, методы, константы и именованные аргументы — по исходникам ядра скриптом tools/verify-skills.php. Скрипт не видит неверного поведения, поэтому рискованные утверждения перепроверяются по коду ядра вручную.

Базовые паттерны рассчитаны на main 23.0+. Всё, что новее, помечено Since с вариантом для старого ядра.

Какая нейросеть лучше пишет код на 1С-Битрикс

Bitrix AI Challenge — бенчмарк BXMax. Связки «приложение + модель + скиллы» (Claude Code, Codex, Cursor и другие) делают один и тот же реальный заказ веб-студии на живом стенде 1С-Битрикс: лендинг с онлайн-записью, инфоблоками и модулем записи. Результат оценивают модель-ревьювер и автор по одной рубрике.

Все участники получают на стенде одни и те же скиллы из этого репозитория, коммит записан в run.yaml каждого прогона: с октября 2026 — релиз 2026-10.

Вклад скиллов отдельно не измеряется: бенчмарк оценивает связку целиком. Методология и код прогонов — в bxmaximum/bitrix_ai_challenge.

Обновления и участие

Скиллы обновляются раз в месяц: после релиза документации, по разборам обновлений ядра и по issue сообщества. Что изменилось — в CHANGELOG.md. Как устроен скилл, как его проверить и как прислать правку — в CONTRIBUTING.md.

php tools/verify-skills.php --kernel=/path/to/bitrix/modules \
    --kernel=/path/to/site/bitrix/modules/sprint.migration
php tools/verify-skills.php --files-only

Модуль sprint.migration не входит в коробку Битрикс24, поэтому его каталог передаётся вторым --kernel. Без него примеры bitrix-sprint-migration дают предупреждения о ненайденных классах.

--files-only проверяет структуру, ссылки и PHP-синтаксис без ядра. Он не подтверждает существование API и не заменяет полный прогон.

Связанные проекты

bxmaximum/bitrix_ai_challenge — исследование AI-моделей на Bitrix; публикации на bxmax.ru/bitrix-ai.
bitrix-tools/best-practice — operational best practices от команды Bitrix Tools.

BXMax

Скиллы поддерживает BXMax — сообщество разработчиков 1С-Битрикс. Мы разбираем ядро и проверяем ИИ-агентов на реальных задачах, по этим задачам и собираем скиллы.

Раздел	Что внутри
Блог	Разборы API, туториалы, мнения о ядре
Кофе && Код	Короткие практические советы по D7
Bitrix × AI	Сравнение AI-моделей на реальных ТЗ
Telegram	Анонсы материалов, скиллов и обновлений

Ссылки: bxmax.ru · Telegram · Bitrix × AI · GitHub

Лицензия

MIT

Navigation Menu

Repository navigation

About

Repository files navigation

Bitrix Framework Skills: скиллы для ИИ-агентов на 1С-Битрикс D7 и Битрикс24

Зачем: нейросеть пишет на Битриксе по-старому

Установка в Claude Code, Cursor и Codex

Другие способы

AGENTS.md

Другие агенты

Пример: выборка из инфоблока без скиллов и со скиллами

Каталог скиллов

MCP для Битрикс24: документация REST в агенте

Как проверяются скиллы

Какая нейросеть лучше пишет код на 1С-Битрикс

Обновления и участие

Связанные проекты

BXMax

Лицензия

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
skills		skills
tools		tools
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation

Bitrix Framework Skills: скиллы для ИИ-агентов на 1С-Битрикс D7 и Битрикс24

Зачем: нейросеть пишет на Битриксе по-старому

Установка в Claude Code, Cursor и Codex

Другие способы

AGENTS.md

Другие агенты

Пример: выборка из инфоблока без скиллов и со скиллами

Каталог скиллов

MCP для Битрикс24: документация REST в агенте

Как проверяются скиллы

Какая нейросеть лучше пишет код на 1С-Битрикс

Обновления и участие

Связанные проекты

BXMax

Лицензия

About

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages