cf-edit — Claude Code skill: edit 1C configuration XML directly
The cf-edit skill for Claude Code makes targeted edits to Configuration.xml in 1C exports: properties, object registry, default roles, panel layout and home page.
MIT 46 installs ★ 811 updated 2026-10-23
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsWhat cf-edit does
The skill invokes a PowerShell script, cf-edit.ps1, which modifies Configuration.xml in place. It supports nine operations: changing configuration properties (modify-property), adding and removing objects in ChildObjects (add-childObject, remove-childObject), sorting objects by name (sort-childObjects), managing default roles (add-defaultRole, remove-defaultRole, set-defaultRoles), rewriting panel layout (set-panels) and home page (set-home-page).
You can batch multiple values in a single command using the ;; separator. cf-edit does not create new metadata objects — it registers files that already exist. Use other skills from the same repository (meta-compile, role-compile, subsystem-compile) to generate new objects; they register automatically. JSON object formats for panels and home page are documented in the repository's reference.md.
Requires PowerShell. Without the -NoValidate flag, the script validates the resulting XML before writing.
What it helps with
- update version and vendor in 1C configuration properties
- register a new catalog or document in ChildObjects
- remove an obsolete object from the configuration
- set default roles for new users
- sort the object list by name within a metadata type
Example prompts for the agent
- Change the configuration version to 2.1.0.5 and set vendor to “My Company” in
src/Configuration.xml - Add
Catalog.CounterpartiesandDocument.PurchaseInvoiceto ChildObjects - Remove the
TestRolerole from default roles
How to install cf-edit
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 cf-edit -a claude-code3Manually: put the files in place
~/.claude/skills/cf-edit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cf-edit/
1Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill cf-edit -a codex2Manually: put the files in place
.agents/skills/cf-edit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill cf-edit -a cursor2Manually: put the files in place
.cursor/skills/cf-edit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills .claude/skills/cf-edit2Manually: put the files in place
.github/skills/cf-edit/SKILL.md1Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill cf-edit -a gemini-cli2Platform CLI
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/cf-editManually: put the files in place
.devin/skills/cf-edit/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 cf-edit
How do I install cf-edit in Claude Code?
Run /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, then /plugin install 1c-skills@cc-1c-skills. The skill will be available after reloading the plugin.
What does cf-edit do?
It makes point edits to Configuration.xml in 1C exports: changes properties like version and vendor, adds and removes objects in ChildObjects, configures default roles, panel layout and home page.
Can cf-edit create a new metadata object?
No. cf-edit registers existing object files in ChildObjects. To create a new catalog, document or role, use meta-compile, role-compile or subsystem-compile from the same repository.
Source text
SKILL.md · MIT
---
name: cf-edit
description: Точечное редактирование конфигурации 1С. Используй когда нужно изменить свойства конфигурации, добавить или удалить объект из состава, настроить роли по умолчанию, поменять раскладку панелей, настроить начальную страницу
argument-hint: -ConfigPath <path> -Operation <op> -Value <value>
allowed-tools:
- Bash
- Read
- Write
- Glob
---
# /cf-edit — редактирование конфигурации 1С
Точечное редактирование Configuration.xml: свойства, состав ChildObjects, роли по умолчанию.
## Параметры и команда
| Параметр | Описание |
|----------|----------|
| `ConfigPath` | Путь к Configuration.xml или каталогу выгрузки |
| `Operation` | Операция (см. таблицу) |
| `Value` | Значение для операции (batch через `;;`) |
| `DefinitionFile` | JSON-файл с массивом операций |
| `NoValidate` | Пропустить авто-валидацию |
```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/cf-edit.ps1" -ConfigPath '<path>' -Operation modify-property -Value 'Version=1.0.0.1'
```
## Операции
| Операция | Формат Value | Описание |
|----------|-------------|----------|
| `modify-property` | `Ключ=Значение` (batch `;;`) | Изменить свойство |
| `add-childObject` | `Type.Name` (batch `;;`) | Зарегистрировать уже существующий файл объекта в ChildObjects. Для создания нового объекта используй `/meta-compile`, `/role-compile`, `/subsystem-compile` — они регистрируют автоматически |
| `remove-childObject` | `Type.Name` (batch `;;`) | Удалить объект из ChildObjects |
| `sort-childObjects` | вид, напр. `Catalog` (batch `;;`), либо пусто | Упорядочить ChildObjects по имени внутри вида. Без значения — все виды, кроме четырёх (см. reference) |
| `add-defaultRole` | `Role.Name` или `Name` | Добавить роль по умолчанию |
| `remove-defaultRole` | `Role.Name` или `Name` | Удалить роль по умолчанию |
| `set-defaultRoles` | Имена через `;;` | Заменить список ролей по умолчанию |
| `set-panels` | JSON-объект (см. [reference.md](reference.md)) | Перезаписать `Ext/ClientApplicationInterface.xml` (раскладка панелей) |
| `set-home-page` | JSON-объект (см. [reference.md](reference.md)) | Перезаписать `Ext/HomePageWorkArea.xml` (начальная страница) |
Допустимые значения свойств, формат DefinitionFile (JSON), каноничный порядок: [reference.md](reference.md)
## Примеры
```powershell
# Изменить версию и поставщика
... -ConfigPath src -Operation modify-property -Value "Version=1.0.0.1 ;; Vendor=Фирма 1С"
# Добавить объекты
... -ConfigPath src -Operation add-childObject -Value "Catalog.Товары ;; Document.Заказ"
# Удалить объект
... -ConfigPath src -Operation remove-childObject -Value "Catalog.Устаревший"
# Роли по умолчанию
... -ConfigPath src -Operation add-defaultRole -Value "ПолныеПрава"
... -ConfigPath src -Operation set-defaultRoles -Value "ПолныеПрава ;; Администратор"
```
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills