SkillFoxx

Bitrix24 business process template debugger skill

bitrix-bizproc

A Claude Code skill that parses and validates Bitrix24 business process bpt templates and finds broken activity and constant references

  • 0 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • In the base mode it only works with local bpt files and does not write to Bitrix24
  • With the gateway module enabled it can read and rewrite templates right on the portal, and a CodeActivity node in a template holds PHP code that runs on the server
All reasons and checks
Russian stack

shydamn/bitrix-bizproc-skillAuthor:ShyDamn

Install

Services

Manual install

pip install phpserialize

The only dependency. After installing it, place the skill folder in your Claude Code skills directory.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • In the base mode it only works with local bpt files and does not write to Bitrix24
  • With the gateway module enabled it can read and rewrite templates right on the portal, and a CodeActivity node in a template holds PHP code that runs on the server

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

What it does

The skill parses the bpt format: a tree of PHP arrays, serialized with serialize() and compressed with zlib, which the Bitrix24 visual process editor uses to store a template. Bitrix does not validate references inside this file, so a link to a deleted activity or an undeclared constant silently turns into an empty string, invisible in the interface. By default the skill works with exported bpt files: it prints a summary and tree of the template, searches activities by type or title, and checks reference integrity. If a portal has a separate bizproc-agent gateway module installed and its URL and token are set as environment variables, the same skill reads and writes templates directly on the live portal, with automatic snapshots before every write and rollback to a previous version. The author verified the parse-and-rebuild cycle on 31 production templates from several portals and on all 2584 templates of one working portal, with zero discrepancies from the source.

Who it is for. For Bitrix24 developers who maintain complex business processes and want to catch hidden template defects before they surface in production.

Good fit when

  • You need to understand an unfamiliar bpt template before editing it
  • A process misbehaves but the Bitrix24 log shows nothing wrong
  • You need to find every reference to a deleted activity or a stale constant
  • The portal already has the gateway module installed and you want to edit templates without manually exporting files

Not a fit when

  • You need to fix an already running process instance rather than the template
  • You need to verify the process tree is actually executable, not just referentially consistent

Example request

Parse process.bpt and check whether it has references to deleted activities

Limitations

The repository is new with a single author and no stars. Reference validation is only partly semantic: it finds broken references but does not guarantee the tree is executable. Without the gateway module the skill does not write to the Bitrix24 database and does not fix running processes: importing the fixed file back is a manual step in the UI. With the gateway module the server can read and rewrite process templates on the portal, and the CodeActivity node inside a template holds arbitrary PHP that runs on the portal server, so such edits should always be shown to the user in full and confirmed separately. Requires Python with the phpserialize package.

How to disable. Remove the skill folder from your Claude Code skills directory and, if it was used, remove the bizproc-agent module from the portal.

FAQ

Can the skill fix broken references itself?

It provides a model of the format and tools for structural tree edits via scripts/bpt.py, but it does not make edits automatically without a person involved.

Does it need access to a live portal?

No, by default the skill works with exported bpt files. Direct portal access only works if the separate bizproc-agent gateway module is installed on it.

Discussion

No questions or reviews yet.

All Bitrix24 tools
Russian stack

A CLI that turns Bitrix24's binary .bpt business-process files into readable JSON for git and diffing

CLIExtended access1
Russian stack

A skill for administering, diagnosing and developing boxed Bitrix24 and Bitrix Framework, built from official documentation

SkillExtended access1
Russian stack

Four skills for Bitrix24 apps: install and OAuth, a batching REST client, events and iframe placements, CRM business processes and calendar

SkillExtended access

Bitrix24 BI Reports Skill

Claude Skills для Битрикс24

Russian stack

A skill for Bitrix24's BI constructor on Trino and Superset: datasets, SQL patterns and a table of common pitfalls

SkillMinimal access1

Bitrix BPT CLI tool

Bitrix BPT CLI Tool

Russian stack

A .NET command-line tool that unpacks, rebuilds and inspects Bitrix business-process template files (*.bpt)

CLIExtended access1

README in short

The README and the full SKILL.md explain the bpt format and that Bitrix24 does not validate references inside it, which can let a process run with a silent hole. They describe four node dialects, the difference between a plain tree and a state machine, a discovery workflow that avoids loading the whole template into context, an optional gateway mode with versioning and rollback, and a warning that CodeActivity runs arbitrary PHP on the portal server. MIT license.

README badge

Original SKILL.md

---
name: bitrix-bizproc
description: Чтение, разбор, проверка и правка шаблонов бизнес-процессов Битрикс24 (.bpt-файлы и содержимое b_bp_workflow_template). Используй этот скилл всегда, когда речь заходит о бизнес-процессах Битрикса, БП, шаблонах согласования, роботах, маршрутах согласования, .bpt-файлах, автоматизации в CRM или смарт-процессах, даже если пользователь не называет формат и просто просит «поменять маршрут» или «починить согласование». Также используй, если видишь zlib-сжатый PHP serialize с ключами TEMPLATE, VARIABLES, CONSTANTS.
---

# Шаблоны бизнес-процессов Битрикс24

Визуальный редактор БП рисует квадратики, а хранит дерево PHP-массивов,
сериализованное serialize() и сжатое zlib. Ни в интерфейсе, ни в базе нет
проверки ссылок: шаблон со ссылкой на удаленную активность или на необъявленную
константу спокойно сохранится, импортируется и запустится, просто подставив
пустую строку. Ошибки здесь тихие: процесс идет, письмо уходит с дыркой,
согласующий не назначается, в журнале чисто.

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

## Два режима работы

Скилл работает либо с файлами .bpt, либо с живым порталом через шлюз.

Файлы. Пользователь выгрузил шаблон из интерфейса. Работают
inspect_bpt.py, validate_bpt.py, bpt.py. Ничего настраивать не надо.

Живой портал. На портале установлен модуль-шлюз, и есть переменные
BPAGENT_URL и BPAGENT_TOKEN. Тогда все идет через bpagent.py.

Report a problem