Bitrix Agent Skill

A Claude Code and Codex skill for 1C-Bitrix and on-premise Bitrix24 development: check the project core first, then answer

SkillMedium riskRussian stack

poliklot/bitrix-agent-skill

Install

curl -fsSL https://raw.githubusercontent.com/Poliklot/bitrix-agent-skill/master/install.sh | bash

Flags --claude, --codex or --both pick the agent, --version pins a release. Restart the agent after installing.

This is third-party code. Review the repository files before installing.

What it does

The skill teaches the agent to work from the live Bitrix codebase: check installed modules and versions, standard components, templates and local overrides, and only then apply its references. It holds more than eighty narrow reference files on the core, infoblocks, ORM, caching, events, REST, e-commerce, 1C exchange via CommerceML and operations, loaded on demand. After a project audit the agent maintains BITRIX_PROJECT_CONTEXT.md with a snapshot of modules, components, integrations and risks. The shop route turns on only after catalog, sale and currency are confirmed in the project.

Who it is for. For PHP developers maintaining sites and shops on 1C-Bitrix or on-premise Bitrix24.

Good fit when

  • You need to find out why a product exists in admin but not on the site
  • You need a change that survives core updates
  • You need a project audit or a cache and query optimization review

Not a fit when

  • The project is cloud Bitrix24 with no code access
  • You only need a REST integration with Bitrix24 and no PHP code

Example request

/bitrix Find out why 1C exported a product but the site shows no price or stock

Limitations

The skill is instructions and references and does not scan Bitrix by itself: without a working copy the agent warns that versions and overrides are unverified. References match specific module versions, and with other versions the project code stays the source of truth. Installation runs a script fetched with curl.

How to disable. Run bash ~/.claude/skills/bitrix/uninstall.sh or the same script in the Codex skills directory.

Security check

  • Installation runs a remote script via curl
  • The skill checks GitHub for updates on first use
  • The agent reads core and project files

README in short

The README explains the core-first principle and uses a table to show agent behavior with and without project access. It covers the project audit with a context file, installation on macOS, Linux and Windows, a compact MCP Market version and a coverage table from the core to 1C and operations. It includes runtime verification scripts, sample prompts, safety rules and update and uninstall commands. MIT license.

SKILL.md

---
name: bitrix
description: >-
  Core-first Bitrix / 1C-Bitrix / Битрикс / БУС / boxed Bitrix24 expertise. Use when
  a task mentions or a repo contains Bitrix markers: `www/bitrix`, `/bitrix`, `/local`,
  `bitrix/modules`, components/templates, `CIBlock*`, `CUser`, `CModule`, `Loader::includeModule`,
  `Bitrix\Main`, D7, legacy `C*`, инфоблоки/iblock, HL/highloadblock, UF. Use for Bitrix PHP
  inspection, debugging, changes, migrations, integrations, optimization, testing, security and operations;
  for meta title/description, `ShowHead`, `ShowTitle`, assets,
  breadcrumbs, includes, `.section.php`, project layout, `.env`/`Option`, stable entity IDs, current user; for production best practices, pitfalls,
  cache/index/SEO/search/perf optimization audits; and for shop/1C/REST:
  `catalog`, `sale`, `currency`, SKU/offers, prices, stocks, basket/cart, orders, payments, delivery,
  discounts, marketing/mail/SMS, bizproc/workflow, webhooks, sale/catalog REST, 1C/CommerceML. Inspect
  local core and `local/*`; missing optional modules are deferred.
metadata:
  author: poliklot
  version: "1.35.0"
---

# Bitrix Expert Skill

Designed for Claude Code and Codex on 1C-Bitrix CMS projects.

Эксперт по 1C-Bitrix CMS. Работаешь от живого проекта: сначала проверяешь установленное ядро, стандартные компоненты и проектные оверрайды, потом предлагаешь решение. Если в проекте есть `BITRIX_PROJECT_CONTEXT.md`, читай его после `AGENTS.md` как сохранённый снимок проекта.

## Текущая фаза

В текущей фазе есть два подтверждённых маршрута:

FAQ

How do I install for Codex only?

Pass --codex to the installer, or --both for both agents.

How do I update?

The update.sh script in the skill folder checks GitHub releases and installs a new version.

Editors’ pick

The official FastAPI skill, bundled with the package, teaching agents to write code for the installed version

SkillLow risk102.3K
Editors’ pick

Official skills and agents from the .NET team: performance, MSBuild, NuGet, upgrades, testing, ASP.NET Core, Blazor and MAUI

PluginMedium risk5.4K

Firebase MCP Server

Firebase CLI and MCP Server

Editors’ pick

Official Firebase MCP server from the Firebase CLI: projects, Firestore, Auth, Crashlytics, Remote Config and function logs

MCP serverHigh risk4.5K
Editors’ pick

Laravel's official MCP server, guidelines and skills: the agent sees the DB schema, logs and package versions and searches ecosystem docs

MCP serverMedium risk3.6K