db-dump-cf — Claude Code skill: what it does, how to install
Dumps 1C enterprise configurations and extensions into binary CF or CFE files via PowerShell. Useful when preparing database backups or snapshots.
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsWhat db-dump-cf does
The skill triggers a PowerShell script named db-dump-cf.ps1 to export metadata from a 1C infobase. It inspects .v8-project.json in the project root to resolve connection settings by database alias, identifier, or active Git branch.
Execution supports both local file infobases and client-server setups. Beyond full configuration dumps, the underlying script can extract specific extensions or all extensions at once, passing credentials and extra flags to 1cv8.exe or ibcmd.
PowerShell and the 1C:Enterprise platform must be available locally. The dump fails immediately unless you provide a valid database path or a server-plus-reference pair.
What it helps with
- dump a 1C configuration to a binary CF file
- create an infobase backup before rolling out changes
- export active database extensions to CFE files
- select connection parameters based on current Git branch
Example prompts for the agent
- /db-dump-cf dev config.cf
- /db-dump-cf
- Dump the dev database configuration into backup.cf
How to install db-dump-cf
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 db-dump-cf -a claude-code3Manually: put the files in place
~/.claude/skills/db-dump-cf/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/db-dump-cf/
1Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-dump-cf -a codex2Manually: put the files in place
.agents/skills/db-dump-cf/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/db-dump-cf/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills db-dump-cf2Manually: put the files in place
.github/skills/db-dump-cf/SKILL.mdPlatform CLI
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/db-dump-cfManually: put the files in place
.devin/skills/db-dump-cf/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 db-dump-cf
How to install db-dump-cf in Claude Code?
Run /plugin marketplace add Nikolay-Shirokov/cc-1c-skills and then /plugin install 1c-skills@cc-1c-skills inside Claude Code.
What does db-dump-cf do?
It automates exporting 1C infobase configurations and extensions into CF or CFE files using PowerShell and settings from .v8-project.json.
Can db-dump-cf connect to both file and server databases?
Yes. File databases require the -InfoBasePath parameter, while server setups need both -InfoBaseServer and -InfoBaseRef.
Source text
SKILL.md · MIT
---
name: db-dump-cf
description: Выгрузка конфигурации 1С в CF-файл. Используй когда нужно выгрузить конфигурацию в CF, сохранить конфигурацию, сделать бэкап CF
argument-hint: "[database] [output.cf]"
allowed-tools:
- Bash
- Read
- Glob
- AskUserQuestion
---
# /db-dump-cf — Выгрузка конфигурации в CF-файл
Выгружает конфигурацию информационной базы в бинарный CF-файл.
## Usage
```
/db-dump-cf [database] [output.cf]
/db-dump-cf dev config.cf
/db-dump-cf — база по умолчанию, файл config.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-dump-cf.ps1" <параметры>
```
### Параметры скрипта
| Параметр | Обязательный | Описание |
|----------|:------------:|----------|
| `-V8Path <путь>` | нет | Каталог bin платформы, или полный путь к `1cv8.exe` / `ibcmd.exe` |
| `-InfoBasePath <путь>` | * | Файловая база |
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
| `-UserName <имя>` | нет | Имя пользователя |
| `-Password <пароль>` | нет | Пароль |
| `-OutputFile <путь>` | да | Путь к выходному CF-файлу |
| `-Extension <имя>` | нет | Выгрузить расширение |
| `-AllExtensions` | нет | Выгрузить все расширения |
| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
| `-AdditionalIbcmdArguments <список>` | нет | Доп. аргументы `ibcmd` через запятую, в форме `--ключ=значение` |
> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
## Примеры
```powershell
# Выгрузка конфигурации (файловая база)
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "C:\backup\config.cf"
# Серверная база
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -OutputFile "config.cf"
# Выгрузка расширения
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-cf.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -OutputFile "ext.cfe" -Extension "МоёРасширение"
```
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills
