mxl-decompile — скилл для Claude Code: декомпиляция макетов 1С
Скилл mxl-decompile для Claude Code разбирает Template.xml табличного документа 1С в компактный JSON. JSON используют для анализа и правки существующих макетов через DSL.
MIT 45 установок ★ 811 обновлён 2026-10-23
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsЧто делает mxl-decompile
Скилл принимает путь к Template.xml и возвращает JSON-определение макета — то же, что принимает /mxl-compile. Внутри — PowerShell-скрипт mxl-decompile.ps1, который читает XML и выводит структуру: ячейки, области, стили, объединения. Обратная операция — /mxl-compile, которая собирает Template.xml из JSON.
В разобранном JSON попадаются ключи вроде apply у rowStyle или controlType: "none" у поля ввода — их нет в описании DSL /mxl-compile, но компилятор принимает обратно. Удалять не нужно: без них макет изменится. Правка через DSL — полная перегенерация, а не точечное изменение XML, поэтому diff после цикла «декомпиляция → компиляция» обычно шире фактической доработки.
Не переживают цикл объединения не привязанные к ячейке, настройки диаграмм (Chart, GanttChart) и область печати — сверяйте результат через /mxl-info или diff, если нужно сохранить чужой макет как есть.
Какие задачи решает
- разобрать табличный документ 1С в редактируемый JSON
- проанализировать структуру существующего макета — области, стили, ячейки
- изменить макет через DSL и пересобрать командой
/mxl-compile - получить компактное описание макета для версионирования
Примеры запросов агенту
- Разбери
reports/Invoice/Template.xmlв JSON и покажи структуру - Запусти
/mxl-decompileдляlayouts/PaymentOrder/Template.xml, сохрани вpayment.json - Преобразуй макет
OrderForm/Template.xmlв DSL, чтобы я мог поправить области
Как установить mxl-decompile
1Через маркетплейс плагинов
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills/plugin install 1c-skills@cc-1c-skillsКоманда ставит плагин 1c-skills целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-decompile -a claude-code3Вручную: положить файлы
~/.claude/skills/mxl-decompile/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mxl-decompile/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-decompile -a codex2Вручную: положить файлы
.agents/skills/mxl-decompile/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-decompile -a cursor2Вручную: положить файлы
.cursor/skills/mxl-decompile/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills .claude/skills/mxl-decompile2Вручную: положить файлы
.github/skills/mxl-decompile/SKILL.md1Через Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-decompile -a gemini-cli2Командой платформы
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/mxl-decompileВручную: положить файлы
.devin/skills/mxl-decompile/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mxl-decompile
Как установить mxl-decompile в Claude Code?
Выполните /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, затем /plugin install 1c-skills@cc-1c-skills. Скилл станет доступен сразу.
Что делает mxl-decompile?
Скилл читает Template.xml табличного документа 1С и возвращает JSON-определение: ячейки, области, стили, объединения. Этот JSON можно изменить и собрать обратно в XML командой /mxl-compile.
Почему в разобранном JSON ключи, которых нет в описании DSL?
Ключи вроде apply у rowStyle или controlType: "none" несут состояние исходного файла. Компилятор принимает их обратно, а без них макет изменится. Удалять не нужно.
Исходный текст
SKILL.md · MIT
---
name: mxl-decompile
description: Декомпиляция табличного документа (MXL) в JSON-определение. Используй когда нужно получить редактируемое описание существующего макета
argument-hint: <TemplatePath> [OutputPath]
allowed-tools:
- Bash
- Read
- Write
- Glob
---
# /mxl-decompile — Декомпилятор макета в DSL
Принимает Template.xml табличного документа 1С и генерирует компактное JSON-определение (DSL). Обратная операция к `/mxl-compile`.
## Использование
```
/mxl-decompile <TemplatePath> [OutputPath]
```
## Параметры
| Параметр | Обязательный | Описание |
|--------------|:------------:|-----------------------------------------|
| TemplatePath | да | Путь к Template.xml |
| OutputPath | нет | Путь для JSON (если не указан — stdout) |
## Команда
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-decompile.ps1" -TemplatePath "<путь>/Template.xml" [-OutputPath "<путь>.json"]
```
## Рабочий процесс
Декомпиляция существующего макета для анализа или доработки:
1. Вызвать `/mxl-decompile` для получения JSON из Template.xml
2. Проанализировать или изменить JSON (добавить области, поменять стили)
3. Вызвать `/mxl-compile` для генерации нового Template.xml
4. Вызвать `/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-ом: перечисленное выше нужно вернуть руками.
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills