mxl-validate — Claude Code skill: what it does, how to install
Validates 1C spreadsheet document (MXL) templates. Catches structural errors in Template.xml after modifications or automated generation.
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsWhat mxl-validate does
This skill inspects Template.xml files inside 1C spreadsheet document templates. It detects broken palette references and misaligned merged cell boundaries. It also checks named area ranges and input field consistency.
Under the hood, the skill executes mxl-validate.ps1 via PowerShell. It requires a <TemplatePath> parameter pointing to the template directory or the Template.xml file. You can pass -Detailed to inspect passing checks, or stop execution early with -MaxErrors (defaults to 20).
The validator runs directly through powershell.exe. Therefore, a working PowerShell binary must be available in your path.
What it helps with
- validate
Template.xmlintegrity after editing a spreadsheet layout - detect broken palette references and invalid cell indices
- find corrupted merged cell boundaries and named area ranges
- verify input field cell consistency across report templates
Example prompts for the agent
- /mxl-validate "Catalogs/Products/Templates/PrintForm"
- Validate template "src/Reports/Invoice/Templates/Layout" with -Detailed output
- Check "Templates/PriceList" for layout errors with -MaxErrors 5
How to install mxl-validate
1Plugin marketplace
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills/plugin install 1c-skills@cc-1c-skillsThis installs the whole 1c-skills plugin with all its skills
2Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-validate -a claude-code3Manually: put the files in place
~/.claude/skills/mxl-validate/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mxl-validate/
1Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-validate -a codex2Manually: put the files in place
.agents/skills/mxl-validate/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/mxl-validate/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills mxl-validate2Manually: put the files in place
.github/skills/mxl-validate/SKILL.mdPlatform CLI
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/mxl-validateManually: put the files in place
.devin/skills/mxl-validate/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about mxl-validate
How to install mxl-validate in Claude Code?
First add the catalog by running /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, then install the bundle with /plugin install 1c-skills@cc-1c-skills. Alternatively, execute npx skills add Nikolay-Shirokov/cc-1c-skills --skill mxl-validate -a claude-code in your terminal.
What checks does mxl-validate run on Template.xml?
It verifies XML structural consistency, focusing on cell indices, palette color lookups, merged cell limits, named area bounds, and input field integrity.
What prerequisites are needed to run mxl-validate?
The skill relies on powershell.exe to run its validation script, alongside Bash, Read, and Glob tools configured in your agent environment.
Source text
SKILL.md · MIT
---
name: mxl-validate
description: Валидация макета табличного документа (MXL). Используй после создания или модификации макета для проверки корректности
argument-hint: <TemplatePath> [-Detailed] [-MaxErrors 20]
allowed-tools:
- Bash
- Read
- Glob
---
# /mxl-validate — валидация макета табличного документа (MXL)
Проверяет Template.xml на структурные ошибки: индексы, ссылки на палитры, диапазоны именованных областей и объединений, согласованность ячеек-полей ввода.
## Параметры
| Параметр | Обяз. | Умолч. | Описание |
|---------------|:-----:|---------|--------------------------------------------|
| TemplatePath | да | — | Путь к макету (директория или Template.xml) |
| Detailed | нет | — | Подробный вывод (все проверки, включая успешные) |
| MaxErrors | нет | 20 | Остановиться после N ошибок |
## Команда
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-validate.ps1" -TemplatePath "Catalogs/Номенклатура/Templates/Макет"
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/mxl-validate.ps1" -TemplatePath "src/МояОбработка/Templates/ПечатнаяФорма"
```
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills
