1c-forms-compile

Compile 1C managed form Form.xml files from JSON DSL definitions.

Updated Jun 26, 2026
One-click install
npx skills add https://github.com/pavelvdo/universal-xml-exchange2 --skill 1c-forms-compile-pavelvdo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 1c-forms-compile
Source: https://github.com/pavelvdo/universal-xml-exchange2/tree/main/.cursor/skills/1c-forms/compile
Command: npx skills add https://github.com/pavelvdo/universal-xml-exchange2 --skill 1c-forms-compile-pavelvdo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Writing 1C managed form layouts (Form.xml) by hand is verbose and error-prone. This Skill compiles a concise JSON DSL into a valid Form.xml for an existing form, but only in the controlled "assisted" artifact mode, preventing unsafe raw XML edits. ## Core Features & Use Cases - JSON DSL to Form.xml compilation: Converts a declarative JSON form description into the Ext/Form.xml file of an already-existing form in the metadata. - Strict safety gates: Forbids -FromObject, form-add, ChildObjects edits, and creation of new metadata objects; halts if the form does not already exist in the configuration. - Preset-driven layouts: Supports layout presets (e.g. erp-standard) with deep-merge overrides at project level for documents, catalogs, registers, and charts of accounts. - Use Case: During a 1C change request, after the form was created manually in Configurator, run the compile script with a JSON DSL to populate the form layout, then pass the result to the 1c-forms/validate step. ## Quick Start Ask the assistant to compile the prepared JSON DSL into the existing form's Form.xml using the 1c-forms compile script with the erp-standard preset.

Frequently Asked Questions about 1c-forms-compile

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

FAQPage Schema
How do I generate a 1C managed form Form.xml from JSON?

Write a JSON DSL describing the form layout, then run form-compile.ps1 with -JsonPath pointing to the DSL and -OutputPath pointing to the existing form's Ext/Form.xml. The script writes the compiled XML for that form only.

What is the assisted artifact mode in 1C form generation?

Assisted mode is a gate that permits compiling Form.xml from JSON DSL only for forms that already exist in the configuration metadata. If the form is missing, the workflow halts and falls back to manual editing in Configurator.

Can the compile script create a new form or metadata object?

No. The skill explicitly forbids creating new metadata objects, editing ChildObjects, using -FromObject, or borrowing forms. The target form must be created beforehand in Configurator.

Which PowerShell version is required for form-compile.ps1?

The script requires Windows built-in PowerShell 5.1 only. It is invoked via powershell.exe -NoProfile and is not designed for PowerShell Core or other shells.

How do form layout presets work in the compile script?

Presets are JSON files keyed by object type and form purpose, such as document.item or catalog.list. Hardcoded defaults merge with the built-in erp-standard preset and an optional project-level preset found by scanning upward from the output path.

What should run after compiling a 1C form from DSL?

After compilation, the result must be passed to the 1c-forms/validate skill. Raw writing of Form.xml by the orchestrator outside the compile script is prohibited.