mxl-expert

Convert 1C SpreadsheetDocument MXL templates between JSON DSL and Template.xml.

151|20|Updated Feb 11, 2026
One-click install
npx skills add https://github.com/Arman-Kudaibergenov/1c-ai-development-kit --skill mxl-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mxl-expert
Source: https://github.com/Arman-Kudaibergenov/1c-ai-development-kit/tree/main/.claude/skills/mxl-expert
Command: npx skills add https://github.com/Arman-Kudaibergenov/1c-ai-development-kit --skill mxl-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Этот скилл решает проблему ручного и ошибкоемкого управления MXL-макетами 1С и их шаблонами, позволяя быстро конвертировать между JSON DSL и Template.xml, а также добавлять или удалять макеты в XML метаданных объекта.

Core Features & Use Cases

  • Compile JSON DSL → MXL (Template.xml): генерирует корректный Template.xml из компактного JSON-описания табличного документа.
  • Decompile MXL (Template.xml) → JSON DSL: восстанавливает JSON DSL из существующего Template.xml.
  • Template management for 1C objects: добавляет макет в корневой XML объекта (создаёт метаданные макета и содержимое) и удаляет макет (включая очистку регистрации).

Use cases:

  • Автоматизация создания печатных форм/табличных документов 1С из декларативного JSON DSL вместо ручного XML.
  • Быстрое редактирование макетов: decompile для правок в JSON, затем compile для обратной сборки.
  • Массовое обновление/переиспользование макетов для печати разных объектов (обработка/справочники/документы и т.п.).

Quick Start

Используй команду /mxl-expert compile path/to/template.json path/to/Template.xml, чтобы сгенерировать Template.xml из JSON DSL.

Frequently Asked Questions about mxl-expert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert 1C MXL templates to JSON for easier editing?

You can decompile existing 1C MXL templates from Template.xml back into a compact JSON DSL. This allows you to edit spreadsheet documents declaratively and then compile them back into XML.

Can I generate 1C print form templates from JSON instead of XML?

Yes, you can compile a compact JSON DSL description directly into a valid 1C Template.xml. This generates the correct spreadsheet document structure, including palettes, fonts, styles, and lines.

How do I register a new MXL template inside 1C object metadata?

You can add a template directly into the root XML metadata of 1C objects like documents or catalogs. The process handles template creation, content generation, and proper registration within ChildObjects.

What is the best way to manage 1C spreadsheet document palettes and styles?

When compiling JSON DSL to Template.xml, the process ensures correct handling of palettes, fonts, styles, and lines. This deterministic execution guarantees accurate style preservation for 1C print forms.

Does decompiling 1C Template.xml preserve namespaces and ChildObjects registration?

Decompiling Template.xml to JSON DSL correctly handles XML namespaces and template registration in ChildObjects. This ensures the reverse-engineered JSON accurately reflects the original 1C metadata structure.

How do I remove a print form template from 1C object root metadata?

You can remove an MXL template from 1C object root XML, which includes cleaning up its registration. This ensures the object metadata remains valid after deleting the spreadsheet document layout.