erf-init

Creates an empty 1C external report scaffold with object module and optional managed form.

1|2|Updated Jul 19, 2026
One-click install
npx skills add https://github.com/IngvarConsulting/unica-marketplace --skill erf-init-ingvarconsulting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: erf-init
Source: https://github.com/IngvarConsulting/unica-marketplace/tree/main/plugins/unica/skills/erf-init
Command: npx skills add https://github.com/IngvarConsulting/unica-marketplace --skill erf-init-ingvarconsulting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new 1C:Enterprise external report (ERF) from scratch requires correctly structured Designer platform-XML descriptors, an object module, and proper source-set registration in v8project.yaml. Doing this by hand is error-prone and easy to get wrong, especially around source-set paths and format compatibility. ## Core Features & Use Cases - ERF Scaffold Generation: Creates the descriptor XML, Ext/ObjectModule.bsl, and optionally an empty managed form via the unica.erf.init MCP tool. - Source-Set Registration: Ensures the EXTERNAL_REPORTS source-set exists in v8project.yaml and verifies registration through unica.project.map. - Safe Preview Workflow: Supports dryRun preview of the exact file list before any applied creation, plus a dry-run preview of the future make build command. - Use Case: A developer needs a new external report "Остатки" with a managed form in a Designer-mode project; the skill scaffolds the XML/BSL files in src/external-reports and validates the form with unica.form.validate. ## Quick Start Ask the assistant to create a new external report named Остатки with a managed form in the src/external-reports source-set, previewing the file list with dry run first.

Frequently Asked Questions about erf-init

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

FAQPage Schema
How do I create a new 1C external report from scratch?▼

Use the unica.erf.init MCP tool with a Name, OutputDir pointing at the EXTERNAL_REPORTS source-set root, and dryRun set to true first to preview the file list. It generates the descriptor XML and Ext/ObjectModule.bsl, plus form files if FormName is provided.

How do I add a managed form to a 1C external report scaffold?▼

Pass the FormName parameter to unica.erf.init alongside Name and OutputDir. The scaffold then creates three form files under <Name>/Forms/, which you can verify with unica.form.validate against the form's Ext/Form.xml.

Does erf-init work with EDT format projects?▼

No, erf-init only supports Designer platform-XML format. If v8project.yaml declares format: EDT, the skill stops and explains the incompatibility rather than creating Designer XML inside an EDT source-set.

Why does unica.erf.init need a source-set in v8project.yaml?▼

v8-runner looks for external report descriptors directly in the root of a source-set with type EXTERNAL_REPORTS. If none exists, the skill scaffolds into a new directory and registers it as a Designer source-set, verified via unica.project.map.

Can I preview the scaffold before files are actually created?▼

Yes, call unica.erf.init with dryRun: true to see the exact planned file list with no side effects. Repeat with dryRun: false only after explicit user confirmation to perform the applied creation.