Bitrix Agent Skill
A Claude Code and Codex skill for 1C-Bitrix and on-premise Bitrix24 development: check the project core first, then answer
Install
curl -fsSL https://raw.githubusercontent.com/Poliklot/bitrix-agent-skill/master/install.sh | bashFlags --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 stockLimitations
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.
Related
The official FastAPI skill, bundled with the package, teaching agents to write code for the installed version
Official skills and agents from the .NET team: performance, MSBuild, NuGet, upgrades, testing, ASP.NET Core, Blazor and MAUI
Firebase MCP Server
Firebase CLI and MCP Server
Official Firebase MCP server from the Firebase CLI: projects, Firestore, Auth, Crashlytics, Remote Config and function logs
Laravel's official MCP server, guidelines and skills: the agent sees the DB schema, logs and package versions and searches ecosystem docs