comol/1c-metadata-manage

1C Metadata Manage — Skill Dispatch

Use this skill when the task involves 1C metadata structure (creating, editing, validating, or removing configuration objects, forms, reports, layouts, roles, extensions, or databases).

Recommendation. For any change to metadata XML — prefer this skill (or the metadata-manager subagent) over hand-editing Configuration.xml, Form.xml, Role.xml and similar files. The PowerShell tools under tools/ handle BOM, encodings, UUID regeneration, ChildObjects ordering and cross-references that are easy to break manually. Direct XML edits are acceptable only for unambiguous one-line fixes (e.g. correcting a synonym typo).

Path conventions

PowerShell examples in this skill (SKILL.md and every docs/*.md) use the prefix skills/1c-metadata-manage/tools/.... That prefix is relative to the active tool's skills directory, not to the repository root:

• After installation: the script lives under <tool>/skills/1c-metadata-manage/tools/... (e.g. .cursor/skills/1c-metadata-manage/tools/..., .claude/skills/1c-metadata-manage/tools/..., .kilo/skills/1c-metadata-manage/tools/..., .ai-agent/skills/1c-metadata-manage/tools/...). Active tools that load this skill resolve the prefix automatically.
• In the 1c-rules source repository (when editing the skill itself): the same script lives under content/skills/1c-metadata-manage/tools/.... Prepend content/ when running the example outside of an installed project.

The same convention applies to docs/*.md references like skills/1c-metadata-manage/tools/1c-skd-info/modes-reference.md.

Dispatch Strategy

Determine task complexity, then choose the execution mode:

Direct execution — simple / read-only tasks

Use when the task is a single lightweight query: checking metadata info, a quick lookup, one validation call. In this case identify the task domain from the table below, read the corresponding file, and follow its instructions directly.

Subagent delegation — complex / mutation tasks

Delegate to the 1c-metadata-manager subagent (defined in content/agents/metadata-manager.md, or in the installed agents directory for the active tool) when any of the following is true:

• The task creates, scaffolds, or compiles metadata (objects, forms, SKD, MXL, roles, EPF, CF, CFE, databases)
• The task edits multiple files or spans multiple domains
• The task involves a multi-step workflow (create → edit → validate → fix → re-validate)
• The task requires reading large domain docs (forms, meta-manage, SKD, MXL, roles, EPF, DB — each 200–800 lines)

The subagent already knows how to read the skill docs, execute PowerShell scripts, and validate results. Provide it with the full task description including object names, attributes, types, and any business context from the conversation.

Task Domain Table

| Task Domain | Keywords | File | |---|---|---| | Metadata objects — create, edit, analyze, remove, validate | catalog, document, register, enum, constant, module, attribute, tabular section | meta-manage.md | | Managed forms — design, create, edit, analyze, validate | form, Form.xml, UI, elements, commands, events | form-manage.md | | Managed-form layout patterns — archetypes, naming conventions, advanced patterns | form patterns, archetype, layout, naming, ERP form, list form, document form, wizard | form-patterns.md | | Form-compile DSL reference — full JSON DSL spec for 1c-form-compile, --from-object mode, presets | form DSL, form-compile, autoCmdBar, columnGroup, RadioButtonField, --from-object, form preset | form-compile-dsl.md | | Data Composition Schema (DCS/SKD) — create, edit, analyze, decompile, validate | report, DCS, SKD, data composition, data set, query, decompile | skd-manage.md | | Spreadsheet documents (MXL) — create, decompile, analyze, validate | MXL, spreadsheet, template, print form, layout | mxl-manage.md | | Roles and access rights — create, analyze, validate | role, rights, RLS, access, permissions | role-manage.md | | External processors/reports (EPF/ERF) — scaffold, build, dump, validate | EPF, ERF, data processor, external report, build, dump | epf-manage.md | | BSP/SSL registration and commands | BSP, SSL, ExternalDataProcessorInfo, registration, command | bsp-manage.md | | Configuration (CF) — create, edit, analyze, validate | configuration, Configuration.xml, CF | cf-manage.md | | Extensions (CFE) — create, borrow, diff, patch, validate | extension, CFE, borrow, interceptor, patch | cfe-manage.md | | Databases — registry, create, run, load, dump | database, infobase, .v8-project.json, create DB, run 1C | db-manage.md | | Subsystems — create, edit, analyze, validate | subsystem, command interface, ChildObjects | subsystem-manage.md | | Command interface — edit, validate | CommandInterface.xml, commands visibility, groups | interface-manage.md | | Templates/layouts management — add, remove | template, layout, SpreadsheetDocument, HTML template | template-manage.md | | Help pages — add, manage | help, built-in help, documentation | help-manage.md | | SSL/BSP subsystems patterns | SSL patterns, standard subsystems, BSP events | ssl-patterns.md | | Query writing — compose new queries from scratch | write query, build query, query template, ВЫБРАТЬ, ИЗ, СОЕДИНЕНИЕ, virtual tables, batch queries | query-writing.md | | Query optimization | query, temporary table, join, DCS optimization | query-optimization.md | | Web publishing — publish, unpublish, status, smoke test | web, publish, Apache, IIS, web client, webdav, default.vrd | web-manage.md | | Unpack / rebuild CF, CFE, EPF binaries without 1C platform | v8unpack, binary unpack, headless extract, no platform | v8unpack-cf.md |

If the task spans multiple domains, the subagent will read all relevant docs automatically (or read each one directly for simple tasks).