mxl-decompile
Декомпиляция табличного документа (MXL) в JSON-определение. Используй когда нужно получить редактируемое описание существующего макета
How do I install this agent skill?
npx skills add https://github.com/nikolay-shirokov/cc-1c-skills --skill mxl-decompileIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a specialized utility for decompiling 1C spreadsheet (MXL) documents into JSON definitions. It operates locally using PowerShell and Python scripts to perform data transformation and does not contain any malicious patterns, network exfiltration, or unsafe command executions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
/mxl-decompile — Декомпилятор макета в DSL
Принимает Template.xml табличного документа 1С и генерирует компактное JSON-определение (DSL). Обратная операция к /mxl-compile.
Использование
/mxl-decompile <TemplatePath> [OutputPath]
Параметры
| Параметр | Обязательный | Описание |
|---|---|---|
| TemplatePath | да | Путь к Template.xml |
| OutputPath | нет | Путь для JSON (если не указан — stdout) |
Команда
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-decompile.ps1" -TemplatePath "<путь>/Template.xml" [-OutputPath "<путь>.json"]
Рабочий процесс
Декомпиляция существующего макета для анализа или доработки:
- Вызвать
/mxl-decompileдля получения JSON из Template.xml - Проанализировать или изменить JSON (добавить области, поменять стили)
- Вызвать
/mxl-compileдля генерации нового Template.xml - Вызвать
/mxl-validateдля проверки
Формат JSON на выходе — тот же DSL, что принимает /mxl-compile; его описание живёт в навыке /mxl-compile.
Ключи, которых нет в описании DSL
В разобранном макете попадаются ключи, которых нет в инструкции /mxl-compile: например,
у rowStyle — модификатор apply, у ячейки-поля ввода — controlType: "none". Они несут
состояние исходного файла, которое иначе не выразить. Писать их самому не нужно; удалять
из разобранного JSON — тоже: компилятор принимает их обратно как есть, а без них макет
изменится.
Что нужно знать о пересборке
Правка через DSL — это полная перегенерация макета, а не точечное изменение XML. Поэтому diff после цикла «декомпиляция → компиляция» обычно шире фактической доработки, даже когда содержание сохранено целиком.
Побайтового совпадения с исходником ждать не всегда стоит. В макетах, которые долго правили в Конфигураторе, остаются следы прежних состояний: например, формат ячейки несёт ширину колонки, которая с тех пор изменилась. Из итогового документа такие значения не выводятся, и в пересобранный файл они не возвращаются.
Не переживают цикл вовсе (в JSON не попадают, в XML не возвращаются):
- объединения, не привязанные к ячейке — по всей высоте или ширине документа;
- настройки диаграмм (
Chart,GanttChart) — сам рисунок сохраняется, его содержимое нет; - область печати.
Если задача — сохранить чужой макет как есть и поправить в нём малое, сверяйте результат
/mxl-info или diff-ом: перечисленное выше нужно вернуть руками.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/nikolay-shirokov/cc-1c-skills/mxl-decompile">View mxl-decompile on skillZs</a>