Skip to main content
affpapa.org
RU EN
skill CX Codex

db-load-cf — Claude Code skill: load a 1C configuration from CF

Loads a 1C configuration from a binary CF file into an infobase. Useful when restoring a database from a backup or standing up a config on a test server.

Install into Claude Code · Plugin marketplace All methods and platforms ↓ 
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills
Open on GitHub

What db-load-cf does

The skill resolves connection details from .v8-project.json in the project root: it looks up the base by id, alias or name, and when no name is given it matches the current Git branch against databases[].branches. No branch match means the default entry is used. The platform path comes from v8path on the matched base record, falling back to the root v8path.

Everything runs through the PowerShell script scripts/db-load-cf.ps1. Pass either -InfoBasePath for a file infobase or the pair -InfoBaseServer and -InfoBaseRef for a server one. Extension flags are there too: -Extension loads a CFE as an extension, -AllExtensions unpacks every extension in the archive, -NoApplyCheck skips the applicability check after loading.

Loading a CF replaces the configuration in the base outright, so the skill asks for confirmation first. That is a good moment to double-check you are pointed at the right base and not at production. Only the main configurator configuration gets updated — applying it to the database needs /db-update. If .v8-project.json is missing, the skill suggests /db-list add.

What it helps with

  • push a configuration from a CF backup into an infobase
  • stand up a config on a test server from an archive
  • load an extension from a CFE file into a base
  • pick the right base from the current Git branch
  • restore a configuration after a failed update

Example prompts for the agent

  • /db-load-cf config.cf dev
  • /db-load-cf C:\backup\config.cf
  • Load ext.cfe into the MyDB base as an extension

How to install db-load-cf

1Plugin marketplace

/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills

This installs the whole 1c-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-load-cf -a claude-code

3Manually: put the files in place

~/.claude/skills/db-load-cf/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/db-load-cf/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about db-load-cf

How do I install db-load-cf in Claude Code?

Through the marketplace: run /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, then /plugin install 1c-skills@cc-1c-skills.

What does db-load-cf do?

It loads a 1C configuration from a binary CF file into an infobase, including as an extension. It asks for confirmation before running, since the load replaces the configuration entirely.

What does the skill need to find a base?

A .v8-project.json file in the project root. The skill looks up the base by id, alias or name, and without an explicit name it uses the current Git branch. If the file is absent, it suggests /db-list add.

Source text

SKILL.md · MIT 
---
name: db-load-cf
description: Загрузка конфигурации 1С из CF-файла. Используй когда нужно загрузить конфигурацию из CF, восстановить из бэкапа CF
argument-hint: <input.cf> [database]
allowed-tools:
  - Bash
  - Read
  - Glob
  - AskUserQuestion
---

# /db-load-cf — Загрузка конфигурации из CF-файла

Загружает конфигурацию из бинарного CF-файла в информационную базу.

## Usage

```
/db-load-cf <input.cf> [database]
/db-load-cf config.cf dev
```

> **Внимание**: загрузка CF **полностью заменяет** конфигурацию в базе. Перед выполнением запроси подтверждение у пользователя.

## Параметры подключения

Прочитай `.v8-project.json` из корня проекта и разреши базу:
1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
4. Если ветка не совпала — используй `default`
Платформа — `v8path` найденной записи базы, иначе корневой `v8path`. Не задан ни там, ни там — `-V8Path` не передавай.
Если файла нет — предложи `/db-list add`.
Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`.

## Команда

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" <параметры>
```

### Параметры скрипта

| Параметр | Обязательный | Описание |
|----------|:------------:|----------|
| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
| `-InfoBasePath <путь>` | * | Файловая база |
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
| `-UserName <имя>` | нет | Имя пользователя |
| `-Password <пароль>` | нет | Пароль |
| `-InputFile <путь>` | да | Путь к CF-файлу |
| `-Extension <имя>` | нет | Загрузить как расширение |
| `-NoApplyCheck` | нет | Не проверять применимость расширения после загрузки |
| `-AllExtensions` | нет | Загрузить все расширения из архива |
| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |

> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`

## После выполнения

**Предложи выполнить `/db-update`** — загрузка CF обновляет только «основную» конфигурацию конфигуратора, для применения к БД нужен `/UpdateDBCfg`

## Примеры

```powershell
# Файловая база
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "C:\backup\config.cf"

# Серверная база
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Test" -UserName "Admin" -Password "secret" -InputFile "config.cf"

# Загрузка расширения
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-load-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -InputFile "ext.cfe" -Extension "МоёРасширение"
```

© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills

Similar skills

SKILL.md skills catalog →
load-balancing devops-skills Configures traffic distribution, SSL termination, and health checks across backend servers. Useful when scaling web applications horizontally behind a single endpoint. CX Codex +1 338installs load-test-builder patricio0312rev Builds load, stress and spike tests with k6, Artillery or autocannon, then wires performance gates into CI. CX Codex +1 316installs pohuy smixs pohuy makes agent replies use idiomatic Russian profanity while keeping technical details exact. Use it for debugging, reviews, logs, and deployments. CX Codex +1 738installs rag-blueprint NVIDIA RAG This skill deploys, configures, troubleshoots, and manages NVIDIA RAG Blueprint. Use it when RAG services run through Docker, Kubernetes, or library workflows. CX Codex +1 3,300installs cli-setup cheaper-inference Helps the agent configure OmniRoute, manage autostart, apply CLI updates, and adjust session environment variables. CX Codex +1 1,200installs principle-minimize-reader-load backnotprop A skill that spots unnecessary layers of abstraction and hidden state slowing down code comprehension. Use it when reviewing complex code where the logic is hard to trace. CX Codex +1 5,200installs

From the same set14

epf-build Builds a 1C external data processor into an EPF or ERF file from XML sources, checking modules before the build. CX Codex 47installs erf-init Generates the minimal XML source set for a 1C external report: a root metadata file and the report directory. Useful when you start a new report and don't want to build the skeleton by hand. CX Codex 46installs form-compile Compiles a 1C managed form into Form.xml from a JSON definition or straight from object metadata. Useful when you need a form from scratch or a standard one. CX Codex 45installs web-publish Writes default.vrd, edits httpd.conf and starts Apache so a 1C infobase opens in the browser. Running it again just refreshes the config. CX Codex 44installs db-update Applies changes from the main 1C configuration to the database configuration. Useful when loading XML or a Git branch and applying the update are separate steps. CX Codex 44installs web-unpublish Deletes a 1C web publication from Apache: the block in httpd.conf and the publish/{appname} directory. Useful when a database should stop being reachable over the web. CX Codex 43installs db-dump-dt This skill dumps a whole 1C infobase into a single DT file: configuration plus data. Handy for backups and rollback points before an update. CX Codex 38installs meta-decompile Reads a 1C metadata object XML and emits a compact JSON draft in the meta-compile format. Useful when a new object is easier to build from an existing one than to write from scratch. CX Codex 36installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor