Управление реестром баз данных 1С (.v8-project.json). An agent skill from Nikolay-Shirokov/cc-1c-skills.

MITAuto-check passed

Install DB List

skills CLI
$ npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-list -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Nikolay-Shirokov/cc-1c-skills db-list --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Nikolay-Shirokov/cc-1c-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/db-list .claude/skills/db-list && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
db-list
GitHub stars
671
Token cost
~2.2k tokens
SKILL.md length
745 words
Files
1
Skills in repo
81
Repo updated
First seen
Licence
MIT

At a glance

Управление реестром баз данных 1С (.v8-project.json). An agent skill from Nikolay-Shirokov/cc-1c-skills.

  • Works in 6 steps: Если пользователь указал параметры… → Если пользователь указал базу по имени —… → Если пользователь не указал базу —… → …
  • SKILL.md covers Usage, Формат .v8-project.json, Алгоритм разрешения базы данных and Операции, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

DB List is an agent skill from Nikolay-Shirokov/cc-1c-skills. Управление реестром баз данных 1С (.v8-project.json). Используй когда нужно работать с реестром баз — список баз, зарегистрировать базу в реестре, какие базы есть

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Набор навыков для AI(ИИ)-агентов (Claude Code, Cursor, Codex и др.), помогающий охватить полный цикл разработки на платформе 1С:Предприятие 8.3. Даёт модели абстракции над… The licence is MIT.

Example prompts

  • “/db-list”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Glob, AskUserQuestion

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
  2. Если пользователь указал базу по имени — ищи совпадение в таком порядке
  3. Если пользователь не указал базу — сопоставь текущую ветку Git с databases[].branches
  4. Если ветка не совпала — используй default
  5. Если не найдено или неоднозначно — спроси пользователя
  6. Если файл .v8-project.json не найден — спроси параметры подключения и предложи создать файл

What it can do on your machine

Read from SKILL.md and the folder at commit 1fa205b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Glob
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json and powershell).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

DB List loads about 2.2k tokens when it runs. Until then it costs about 43 tokens; SKILL.md has 745 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~43
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Nikolay-Shirokov/cc-1c-skills at commit 1fa205b, republished under its MIT licence (© Nikolay-Shirokov). 745 words, ~2,178 tokens.

Download SKILL.mdSave it as .claude/skills/db-list/SKILL.md (or your agent's skills folder).
name
db-list
description
Управление реестром баз данных 1С (.v8-project.json). Используй когда нужно работать с реестром баз — список баз, зарегистрировать базу в реестре, какие базы есть
allowed-tools
Read, Write, Glob, AskUserQuestion
argument-hint
[add|remove|show]

/db-list — Управление реестром баз данных

Управляет файлом .v8-project.json — реестром информационных баз проекта. Файл хранит параметры подключения, алиасы, привязку к веткам Git.

Usage

/db-list                    — показать список баз
/db-list add                — добавить базу (интерактивно)
/db-list remove <id>        — удалить базу из реестра
/db-list show <id|alias>    — подробности по базе

Формат .v8-project.json

Файл размещается в корне проекта (рядом с .git/).

json
{
  "v8path": "C:\\Program Files\\1cv8\\8.3.25.1257\\bin",
  "v8args": ["/UseHwLicenses+"],
  "databases": [
    {
      "id": "dev",
      "name": "Разработка",
      "type": "file",
      "path": "C:\\Bases\\MyApp_Dev",
      "v8path": "C:\\Program Files\\1cv8\\8.3.27.1688\\bin",
      "user": "Admin",
      "password": "",
      "aliases": ["dev", "разработка"],
      "branches": ["dev", "develop", "feature/*"],
      "configSrc": "C:\\WS\\myapp\\cfsrc",
      "repository": {
        "path": "\\\\srv01\\repo\\MyApp",
        "user": "Ivanov",
        "password": ""
      },
      "extensions": [
        {
          "name": "МоёРасширение",
          "src": "src\\cfe\\МоёРасширение",
          "repository": { "path": "\\\\srv01\\repo\\MyApp_Ext", "user": "Ivanov", "password": "" }
        }
      ]
    },
    {
      "id": "test",
      "name": "Тестовая",
      "type": "server",
      "server": "srv01",
      "ref": "MyApp_Test",
      "user": "Admin",
      "password": "123",
      "aliases": ["test", "тест"]
    }
  ],
  "default": "dev"
}
Поля корневого объекта
ПолеТипОписание
v8pathstringКаталог bin платформы 1С. Необязательный — если не задан, автоопределение
v8argsarrayДоп. аргументы запуска 1cv8.exe для всех навыков, напр. ["/UseHwLicenses+"]
ibcmdargsarrayДоп. аргументы ibcmd (форма --ключ=значение)
newObjectPosition"end" / "byName"Куда попадает новый объект в составе конфигурации: в конец своего вида (по умолчанию) или на место по имени. Переопределяется в databases[]
extensionApplyCheckboolПроверять ли применимость расширения после загрузки в базу (по умолчанию true). Разово отключается ключом -NoApplyCheck
externalCheckboolПроверять ли исходники внешней обработки/отчёта платформой перед сборкой (по умолчанию true). Разово отключается ключом -Checks off
xsdPathstringКаталог XSD-схем платформы для проверки выгрузок по версиям формата; по умолчанию .v8-xsd рядом с этим файлом. Наполняется /v8-xsd-fetch
databasesarrayМассив баз данных
defaultstringid базы по умолчанию
Поля объекта базы данных
ПолеТипОбязательноеОписание
idstringдаУникальный идентификатор (латиница, без пробелов)
namestringдаЧеловекочитаемое имя
type"file" / "server"даТип подключения
pathstringдля fileПуть к каталогу файловой базы
serverstringдля serverАдрес сервера 1С
refstringдля serverИмя базы на сервере
v8pathstringнетПлатформа именно этой базы — перекрывает корневой v8path (см. ниже)
userstringнетИмя пользователя 1С
passwordstringнетПароль
aliasesstring[]нетАльтернативные имена для быстрого доступа
branchesstring[]нетGit-ветки или glob-паттерны (release/*, feature/*), привязанные к этой базе
configSrcstringнетКаталог XML-выгрузки конфигурации
repositoryobjectнетХранилище конфигурации: path, user, password (см. ниже)
extensionsarrayнетРасширения: name, src, необязательное repository (см. ниже)
Хранилище конфигурации

База, подключённая к хранилищу конфигурации 1С, не принимает ни одной операции конфигуратора без реквизитов доступа к хранилищу — это касается не только /db-repo, но и /db-load-xml, /db-dump-xml, /db-update, /db-load-git. Реквизиты берутся из repository записи базы, передавать их в каждом вызове не нужно.

ПолеТипОбязательноеОписание
repository.pathstringдаКаталог хранилища или tcp://<хост>[:<порт>]/<имя>
repository.userstringнетПользователь хранилища. Не наследуется от user базы
repository.passwordstringнетПароль пользователя хранилища

У расширения своё хранилище со своим путём, поэтому одного repository мало:

ПолеТипОбязательноеОписание
extensions[].namestringдаИмя расширения, как в конфигурации
extensions[].srcstringнетКаталог XML-исходников расширения
extensions[].repositoryobjectнетХранилище расширения. Расширение без хранилища — обычный случай

Пароль хранилища — такой же секрет, как password базы; .v8-project.json в .gitignore.

Сетевое хранилище. Адрес — tcp://<хост>[:<порт>]/<имя>, порт по умолчанию 1542. Обслуживается сервером хранилища. Если он недоступен, платформа отвечает «Соединение с хранилищем конфигурации не установлено» — тем же сообщением, что и при отсутствии реквизитов.

Show full SKILL.md (319 more words)Show less

Алгоритм разрешения базы данных

Этот алгоритм используется ВСЕМИ навыками (db-*, epf-build, epf-dump, erf-build, erf-dump) для определения целевой базы.

  1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
  2. Если пользователь указал базу по имени — ищи совпадение в таком порядке:
    1. По id (точное совпадение)
    2. По aliases (совпадение в массиве с учётом морфологии: «тестовую» = «тестовая» = «тестовой»)
    3. По name (нечёткое совпадение с учётом морфологии и регистра)
  3. Если пользователь не указал базу — сопоставь текущую ветку Git с databases[].branches:
    • Точное совпадение: ветка dev → "branches": ["dev"]
    • Glob-паттерн: ветка release/2.1 → "branches": ["release/*"]
  4. Если ветка не совпала — используй default
  5. Если не найдено или неоднозначно — спроси пользователя
  6. Если файл .v8-project.json не найден — спроси параметры подключения и предложи создать файл

После выполнения: если использованная база не зарегистрирована — предложи добавить через /db-list add.

Выбор платформы

Порядок: явный -V8Path в вызове → v8path записи базы → корневой v8path → автоопределение. Запись базы находит сам скрипт, сопоставляя параметры соединения с databases[], — передавать -V8Path руками не нужно. Поле у базы нужно, когда базы проекта живут на разных версиях платформы: формат XML-выгрузки задаёт та платформа, которая выгружает, а автоопределение берёт самую старшую установленную.

Если v8path не задан нигде:

powershell
$v8 = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort-Object -Descending | Select-Object -First 1

Операции

Показать список баз

Прочитай .v8-project.json, выведи таблицу:

ID      Имя           Тип      Путь/Сервер              По умолч.
dev     Разработка    file     C:\Bases\MyApp_Dev       ✓
test    Тестовая      server   srv01/MyApp_Test
Добавить базу

Спроси у пользователя через AskUserQuestion:

  • id, name, type (file/server)
  • path (для file) или server + ref (для server)
  • user, password (необязательно)
  • aliases, branches (необязательно)
  • если база под хранилищем конфигурации — repository: путь, пользователь, пароль

Добавь в массив databases. Если это первая база — установи как default.

Удалить базу

Удали из массива databases по id. Если удаляемая была default — спросить новый default.

Подробности по базе

Выведи все поля конкретной базы.

Формирование строки подключения

Для использования в шаблонах команд других навыков:

Файловая база:

/F "<path>"

Серверная база:

/S "<server>/<ref>"

Аутентификация (добавляется если user задан):

/N"<user>" /P"<password>"

Важно: между /N и именем пробела нет. Между /P и паролем пробела нет. Если пароль пустой — опусти /P целиком.

Хранилище конфигурации (если у базы задан repository) — скрипты навыков подставляют сами, сопоставляя параметры соединения с записью реестра:

/ConfigurationRepositoryF"<path>" /ConfigurationRepositoryN"<user>" /ConfigurationRepositoryP"<password>"

© Nikolay-Shirokov, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/db-list of Nikolay-Shirokov/cc-1c-skills.

Open the folder on GitHubat commit 1fa205b

Compare with similar skills

DB List next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

DB List compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
DB List this skillNikolay-Shirokov/cc-1c-skills671—~2.2kAutomated safety check: PassMIT
DB ListArman-Kudaibergenov/1c-ai-development-kit166—~1.3kAutomated safety check: PassAGPL-3.0
Cronsmixs/agent-second-brain392—~856Automated safety check: PassMIT
Data SeparationIngvarConsulting/unica215—~744Automated safety check: PassCustom licence
Dcs CompileIngvarConsulting/unica215—~4.5kAutomated safety check: NotesCustom licence
Dcs EditIngvarConsulting/unica215—~4.1kAutomated safety check: NotesCustom licence

Similar skills

  • DB List

    Arman-Kudaibergenov/1c-ai-development-kit

    Этот скилл MUST быть вызван когда пользователь говорит про базы данных, список баз, "добавь базу", "какие базы есть", управление реестром .v8-project.json.

    166 GitHub stars~1.3k tokensUpdated 4 mo ago
    Agent WorkflowsAuto-check passed
  • Cron

    smixs/agent-second-brain

    Управление собственным расписанием — напоминания, рутины, периодические задачи.

    392 GitHub stars~856 tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Data Separation

    IngvarConsulting/unica

    Разделение данных 1С. An agent skill from IngvarConsulting/unica.

    215 GitHub stars~744 tokensUpdated yesterday
    Auto-check passed
  • Dcs Compile

    IngvarConsulting/unica

    Компиляция схемы компоновки данных 1С (СКД) из компактного JSON-определения.

    215 GitHub stars~4.5k tokensUpdated yesterday
    Auto-check: notes
  • Dcs Edit

    IngvarConsulting/unica

    Точечное редактирование схемы компоновки данных 1С (СКД). An agent skill from IngvarConsulting/unica.

    215 GitHub stars~4.1k tokensUpdated yesterday
    Auto-check: notes
  • Yandex Webmaster

    artwist-polyakov/polyakov-claude-skills

    Управление сайтами через Yandex Webmaster API: индексация, поисковые запросы, сайтмапы, переобход, ссылки, фиды, диагностика.

    206 GitHub stars~2k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes

More from Nikolay-Shirokov/cc-1c-skills

All 81 skills in this repo
  • DB Repo

    Nikolay-Shirokov/cc-1c-skills

    Работа с хранилищем конфигурации 1С. An agent skill from Nikolay-Shirokov/cc-1c-skills.

    671 GitHub stars~2.4k tokensUpdated 4 days ago
    Auto-check: notes
  • Form Compile

    Nikolay-Shirokov/cc-1c-skills

    Компиляция управляемой формы 1С из JSON-определения или из метаданных объекта.

    671 GitHub stars~4.5k tokensUpdated 4 days ago
    Auto-check: notes
  • Cf Edit

    Nikolay-Shirokov/cc-1c-skills

    Точечное редактирование конфигурации 1С. An agent skill from Nikolay-Shirokov/cc-1c-skills.

    671 GitHub starsUsed in 1 repo~706 tokens
    Auto-check: notes
  • Form Edit

    Nikolay-Shirokov/cc-1c-skills

    Правка существующей управляемой формы 1С — элементы, реквизиты, команды и свойства самой формы.

    671 GitHub stars~2.9k tokensUpdated 4 days ago
    Auto-check: notes
  • Cf Init

    Nikolay-Shirokov/cc-1c-skills

    Создать пустую конфигурацию 1С (scaffold XML-исходников). An agent skill from Nikolay-Shirokov/cc-1c-skills.

    671 GitHub starsUsed in 1 repo~603 tokens
    Auto-check: notes
  • Cfe Init

    Nikolay-Shirokov/cc-1c-skills

    Создать расширение конфигурации 1С (CFE) — scaffold XML-исходников.

    671 GitHub starsUsed in 1 repo~717 tokens
    Auto-check: notes

Questions about DB List

What does DB List do?

Управление реестром баз данных 1С (.v8-project.json). An agent skill from Nikolay-Shirokov/cc-1c-skills. DB List is an agent skill from Nikolay-Shirokov/cc-1c-skills.json).

How do I install DB List in Claude Code?

Run `npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-list -a claude-code`. Or copy the skill folder (.claude/skills/db-list in Nikolay-Shirokov/cc-1c-skills) into .claude/skills/db-list in your project. Claude Code loads it when a task matches its description.

How do I install DB List in Codex?

Run `npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-list -a codex`. Or copy the skill folder (.claude/skills/db-list in Nikolay-Shirokov/cc-1c-skills) into .agents/skills/db-list in your project. Codex loads it when a task matches its description.

Can I use DB List in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-list -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/db-list, .gemini/skills/db-list, .github/skills/db-list and .opencode/skills/db-list in your project.

What does DB List need to run?

SKILL.md names no scripts, command-line tools or credentials: DB List is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Glob, AskUserQuestion.

Does DB List access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is DB List safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does DB List use?

DB List is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does DB List use?

About 2.2k tokens (SKILL.md is roughly 8.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to DB List?

Skills that share tags, products or a category with DB List: DB List (Arman-Kudaibergenov/1c-ai-development-kit, 166 stars), Cron (smixs/agent-second-brain, 392 stars), Data Separation (IngvarConsulting/unica, 215 stars) and Dcs Compile (IngvarConsulting/unica, 215 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains DB List?

Nikolay-Shirokov (a GitHub user) maintains it in Nikolay-Shirokov/cc-1c-skills, which has 671 GitHub stars. The repository holds 81 skills in this directory. The repository was last updated on October 5, 2026.

Source: Nikolay-Shirokov/cc-1c-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.