Skip to main content
skill CX Codex

mxl-info — Claude Code skill: MXL layout analysis and setup

The mxl-info skill summarizes named areas, parameters, and column sets in an MXL spreadsheet layout. Use it while building 1C print forms.

MIT 46 installs ★ 811 updated 2026-10-23

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills
Open on GitHub

What mxl-info does

mxl-info reads a tabular document's Template.xml and reports its named areas, parameters, column sets, and intersections. Areas appear in document order, which helps map a layout to the order used by print-form code. It can also show static cell labels and text templates.

The skill runs the PowerShell script mxl-info.ps1. Give it a file path with -TemplatePath, or provide both -ProcessorName and -TemplateName. Text is the default output format; add -Format json for JSON or -WithText to include cell text. The command uses powershell.exe, so that executable must be available to run the script.

What it helps with

  • list named areas in an MXL template
  • map parameters to each layout area
  • inspect intersections between row and column areas
  • include cell labels and placeholder templates
  • return layout details as JSON

Example prompts for the agent

  • Run /mxl-info <TemplatePath> on src/Documents/Invoice/Template.xml and list its areas and parameters.
  • Inspect src/Documents/Invoice/Template.xml and include the static cell labels and text templates.
  • Run /mxl-info <ProcessorName> <TemplateName> for processor PrintInvoice and template Main, with JSON output.

How to install mxl-info

1Plugin marketplace

/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills

This installs the whole 1c-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-info -a claude-code

3Manually: put the files in place

~/.claude/skills/mxl-info/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mxl-info/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about mxl-info

How do I install mxl-info in Claude Code?

Run these commands in order in Claude Code: /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, then /plugin install 1c-skills@cc-1c-skills.

What does mxl-info do?

It reads Template.xml and summarizes named areas, their parameters, and column sets. The -WithText option also includes static labels and text templates.

How can I point mxl-info to a template?

Pass a file path with -TemplatePath, or supply both -ProcessorName and -TemplateName. The name-based form also accepts -SrcDir to set the source directory.

Source text

SKILL.md · MIT
---
name: mxl-info
description: Анализ структуры макета табличного документа (MXL) — области, параметры, наборы колонок. Используй при разработке печати — получить области и заполняемые параметры макета
argument-hint: <TemplatePath> или <ProcessorName> <TemplateName>
allowed-tools:
  - Bash
  - Read
  - Glob
---

# /mxl-info — Анализ структуры макета

Читает Template.xml табличного документа и выводит компактную сводку: именованные области, параметры, наборы колонок. Заменяет необходимость читать тысячи строк XML.

## Использование

```
/mxl-info <TemplatePath>
/mxl-info <ProcessorName> <TemplateName>
```

## Параметры

| Параметр      | Обязательный | По умолчанию | Описание                                 |
|---------------|:------------:|--------------|------------------------------------------|
| TemplatePath  | нет          | —            | Прямой путь к Template.xml               |
| ProcessorName | нет          | —            | Имя обработки (альтернатива пути)        |
| TemplateName  | нет          | —            | Имя макета (альтернатива пути)           |
| SrcDir        | нет          | `src`        | Каталог исходников                       |
| Format        | нет          | `text`       | Формат вывода: `text` или `json`         |
| WithText      | нет          | false        | Включить статический текст и шаблоны     |
| MaxParams     | нет          | 10           | Макс. параметров в списке на область     |
| Limit         | нет          | 150          | Макс. строк вывода (защита от переполнения) |
| Offset        | нет          | 0            | Пропустить N строк (для пагинации)       |

Укажите либо `-TemplatePath`, либо оба `-ProcessorName` и `-TemplateName`.

## Команда

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -TemplatePath "<путь>"
```

Или по имени обработки/макета:
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-info.ps1" -ProcessorName "<Имя>" -TemplateName "<Макет>" [-SrcDir "<каталог>"]
```

Дополнительные флаги:
```powershell
... -WithText              # включить текстовое содержимое ячеек
... -Format json           # JSON-вывод для программной обработки
... -MaxParams 20          # показать больше параметров на область
... -Offset 150            # пагинация: пропустить первые 150 строк
```

## Чтение вывода

### Области — сортировка сверху вниз

Области перечислены в порядке документа (по позиции строки), а не по алфавиту. Это соответствует порядку вывода областей в коде заполнения — сверху вниз.

```
--- Named areas ---
  Заголовок          Rows     rows 1-4     (1 params)
  Поставщик          Rows     rows 5-6     (1 params)
  Строка             Rows     rows 14-14   (8 params)
  Итого              Rows     rows 16-17   (1 params)
```

Типы областей:
- **Rows** — горизонтальная область (диапазон строк). Получение: `Макет.ПолучитьОбласть("Имя")`
- **Columns** — вертикальная область (диапазон колонок). Получение: `Макет.ПолучитьОбласть("Имя")`
- **Rectangle** — фиксированная область (строки + колонки). Обычно использует отдельный набор колонок.
- **Drawing** — именованный рисунок/штрихкод.

### Пересечения

Когда есть области и Rows, и Columns (этикетки, ценники), скрипт выводит пары пересечений:

```
--- Intersections (use with GetArea) ---
  ВысотаЭтикетки|ШиринаЭтикетки
```

В BSL: `Макет.ПолучитьОбласть("ВысотаЭтикетки|ШиринаЭтикетки")`

### Параметры и detailParameter

Параметры перечислены по областям. Если у параметра есть `detailParameter` (расшифровка), он показан ниже:

```
--- Parameters by area ---
  Поставщик: ПредставлениеПоставщика
    detail: ПредставлениеПоставщика->Поставщик
  Строка: НомерСтроки, Товар, Количество, Цена, Сумма, ... (+3)
    detail: Товар->Номенклатура
```

Это означает: параметр `Товар` отображает значение, а при клике открывает `Номенклатура` (объект расшифровки).

### Параметры из шаблонов (суффикс `[tpl]`)

Некоторые параметры встроены в шаблонный текст: `"Инв № [ИнвентарныйНомер]"`. Они заполняются через fillType=Template, а не fillType=Parameter. Скрипт всегда извлекает их и помечает суффиксом `[tpl]`:

```
  НумерацияЛистов: Номер [tpl], Дата [tpl], НомерЛиста [tpl]
```

В BSL шаблонные параметры заполняются так же, как обычные:
```bsl
Область.Параметры.Номер = НомерДокумента;
Область.Параметры.Дата = ДатаДокумента;
```

Числовые подстановки вроде `[5]`, `[6]` (ссылки на сноски в официальных формах) игнорируются.

### Текстовое содержимое (`-WithText`)

Показывает статический текст (надписи, заголовки) и шаблонные строки с подстановками `[Параметр]`:

```
--- Text content ---
  ШапкаТаблицы:
    Text: "№", "Товар", "Ед. изм.", "Кол-во", "Цена", "Сумма"
  Строка:
    Templates: "Инв № [ИнвентарныйНомер]"
```

- **Text** — статические надписи (fillType=Text). Полезно для понимания назначения колонок.
- **Templates** — текст с подстановками `[ИмяПараметра]` (fillType=Template). Параметр внутри `[]` заполняется программно.

© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills

Similar skills

Everything for 1C →

From the same set81

The whole set →

More in the catalog

Project sponsors

Companies that keep this analytics open