Bitrix Best Practice
Скиллы-маршрутизаторы с операционными правилами кода для 1С-Битрикс и Битрикс24: контроллеры, ORM, кеш, роутинг
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Только справочные правила кода, не выполняет действий на портале или сервере
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/bitrix-best-practiceОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале в папке проекта
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .claude/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .claude/skills/bitrix-best-practice-coreКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .github/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .github/skills/bitrix-best-practice-coreКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .devin/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .devin/skills/bitrix-best-practice-coreКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Бывший Windsurf.
Выполните в терминале в папке проекта
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .cline/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .cline/skills/bitrix-best-practice-coreКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .roo/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .roo/skills/bitrix-best-practice-coreКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита c2783e7
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/bitrix-tools/best-practice.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/bitrix-best-practice-core/
git -C "$tmp" checkout c2783e74d12312794f19d53332e913176e15670f
mkdir -p .agents/skills
cp -R "$tmp/skills/bitrix-best-practice-core" .agents/skills/bitrix-best-practice-coreКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполни npx skills add bitrix-tools/best-practice для установки обоих скиллов, либо npx skills add bitrix-tools/best-practice --skill bitrix-best-practice-core для конкретного.
Другие способы из описания автора
npx skills add bitrix-tools/best-practiceСтавит оба скилла сразу через библиотеку оркестрации skills.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Проект дает два скилла-маршрутизатора для агентов: bitrix-best-practice-core про базовые сущности продукта (контроллеры, роутинг, конфигурация, кеш, логгер, JWT, валидация и другое) и bitrix-best-practice-sql про работу с базами данных и ORM Битрикса (DataManager, Objectify, построение запросов, запись через ORM). Каждый скилл помогает агенту понять, какой конкретный rule-файл в папке rules открыть под задачу, и не держит правила в себе, что экономит контекст. Это не официальная документация Битрикс, а операционные правила: как писать, ревьюить и принимать решения в коде, оформленные как обычные Markdown-файлы правил.
Для кого. Для 1С-Битрикс и Битрикс24 разработчиков, которые хотят, чтобы агент писал и ревьюил код по единым внутренним правилам команды.
Подходит, если
- Нужны единые правила работы с контроллерами, кешем, ORM и роутингом Битрикс для всей команды
- Хотите, чтобы агент открывал только нужный rule-файл под задачу, а не грузил все правила разом
- Есть свой процесс расширения правил и нужен готовый шаблон для добавления нового rule-файла
Не подходит, если
- Нужна официальная документация продукта, а не операционные правила команды: смотрите docs.1c-bitrix.ru или apidocs.bitrix24.ru
- Разрабатываете не на 1С-Битрикс или Битрикс24
- Нужны готовые примеры кода целиком, а не короткие правила по темам
Пример запроса к агенту
Проверь этот контроллер и запрос к базе на соответствие best practice Битрикс из этого скиллаОграничения
Это не официальная документация Битрикс, а набор мнений и правил одной команды, часть решений может не совпадать с вашими соглашениями. Правила описаны в основном для PHP-разработки на платформе, других языков стека здесь нет. Есть отдельный служебный скилл add-rule-to-best-practice для расширения набора своими правилами.
Как отключить. Удалите папки skills/bitrix-best-practice-core и skills/bitrix-best-practice-sql из установки агента.
Проверка безопасности
- Только справочные правила кода, не выполняет действий на портале или сервере
Коротко о README
Короткий README на русском объясняет, что каждый скилл работает как маршрутизатор к rule-файлам, а не как единый монолитный документ, и явно отмечает, что это не официальная документация Битрикс со ссылками на docs.1c-bitrix.ru и apidocs.bitrix24.ru. Показаны три способа установки: прямой запрос агенту, npx skills add для всех скиллов сразу и с флагом --skill для конкретного.
Частые вопросы
Как добавить свое правило?
Есть служебный скилл .ai/skills/add-rule-to-best-practice с примерами простого и сложного rule-файла и шаблоном записи в роутер скилла.
Можно установить только один скилл?
Да, npx skills add поддерживает флаг --skill с именем конкретного скилла: bitrix-best-practice-core или bitrix-best-practice-sql.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything