db-run — Claude Code skill: what it does, how to install
Launches a 1C:Enterprise infobase in user mode directly from the assistant, resolving connection parameters from project configuration files.
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsWhat db-run does
This skill opens a 1C:Enterprise database using the db-run.ps1 PowerShell script. It inspects .v8-project.json in the workspace root to pick the target database by alias, server parameters, or by matching the active Git branch against configured branch patterns.
It can launch an external .epf data processor on startup, navigate to an e1cib internal URL, or pass a /C parameter. Execution runs in the background via Start-Process without blocking the terminal, so the assistant yields control right away.
Running the command requires PowerShell and a local 1C platform installation configured via v8path. If the target database is missing from configuration, the assistant prompts to add it with /db-list add.
What it helps with
- Launch a 1C infobase mapped to the current Git branch
- Open an external
.epfdata processor immediately on application startup - Navigate directly to an object using an
e1ciblink - Forward a
/Claunch parameter to a client-server infobase
Example prompts for the agent
- /db-run dev
- /db-run dev /Execute process.epf
- Launch 1C for the active branch and run the import.epf tool
How to install db-run
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-run -a claude-code3Manually: put the files in place
~/.claude/skills/db-run/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/db-run/
1Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-run -a codex2Manually: put the files in place
.agents/skills/db-run/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/db-run/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills db-run2Manually: put the files in place
.github/skills/db-run/SKILL.mdPlatform CLI
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/db-runManually: put the files in place
.devin/skills/db-run/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-run
How to install db-run in Claude Code?
Add the marketplace source with /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, then run /plugin install 1c-skills@cc-1c-skills.
What does db-run do?
It launches 1C:Enterprise in user mode for file or client-server databases according to settings defined in .v8-project.json.
How does db-run select which database to launch?
The assistant matches the requested name, alias, or current Git branch against database records in .v8-project.json, falling back to the default entry.
Source text
SKILL.md · MIT
---
name: db-run
description: Запуск 1С:Предприятие. Используй когда нужно запустить 1С, открыть базу, запустить предприятие
argument-hint: "[database]"
allowed-tools:
- Bash
- Read
- Glob
- AskUserQuestion
---
# /db-run — Запуск 1С:Предприятие
Запускает информационную базу в режиме 1С:Предприятие (пользовательский режим).
## Usage
```
/db-run [database]
/db-run dev
/db-run dev /Execute process.epf
/db-run dev /C "параметр запуска"
```
## Параметры подключения
Прочитай `.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-run.ps1" <параметры>
```
### Параметры скрипта
| Параметр | Обязательный | Описание |
|----------|:------------:|----------|
| `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) |
| `-InfoBasePath <путь>` | * | Файловая база |
| `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) |
| `-InfoBaseRef <имя>` | * | Имя базы на сервере |
| `-UserName <имя>` | нет | Имя пользователя |
| `-Password <пароль>` | нет | Пароль |
| `-Execute <файл.epf>` | нет | Запуск внешней обработки сразу после старта |
| `-CParam <строка>` | нет | Параметр запуска (/C) |
| `-URL <ссылка>` | нет | Навигационная ссылка (формат `e1cib/...`) |
| `-AdditionalV8Arguments <список>` | нет | Доп. аргументы запуска `1cv8.exe` через запятую, напр. `/UseHwLicenses+` |
> `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef`
## Важно
Скрипт запускает 1С в фоне (`Start-Process` без `-Wait`) — управление возвращается сразу.
## Примеры
```powershell
# Простой запуск
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"
# Запуск с обработкой
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Execute "C:\epf\МояОбработка.epf"
# Открыть по навигационной ссылке
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -URL "e1cib/data/Справочник.Номенклатура"
# Серверная база с параметром запуска
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-run.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -CParam "ЗапуститьОбновление"
```
© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills
