# Claude Code Skills 1c

> 112 скилов и 35 правил для Claude Code: агент собирает исходники 1С (метаданные, формы, расширения, роли, СКД, обработки) из компактного JSON и разбирает обратно. Базовые операции - без Конфигуратора.

- **Type:** MCP server
- **Install:** `agentstack add mcp-desko77-claude-code-skills-1c`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Desko77](https://agentstack.voostack.com/s/desko77)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Desko77](https://github.com/Desko77)
- **Source:** https://github.com/Desko77/claude-code-skills-1c

## Install

```sh
agentstack add mcp-desko77-claude-code-skills-1c
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Claude Code Skills for 1C:Enterprise

Набор скилов, правил и команд для [Claude Code](https://docs.anthropic.com/en/docs/claude-code):
агент работает с 1С не вслепую по тексту файлов, а по формату платформы.

[](LICENSE)
[](https://github.com/Desko77/claude-code-skills-1c/releases)
[](https://github.com/Desko77/claude-code-skills-1c/actions/workflows/tests.yml)

Скилы дают агенту готовые операции над исходниками: собрать объект метаданных, форму, роль, схему
компоновки, расширение, внешнюю обработку - и разобрать их обратно. Правила задают, как он это
делает: стандарты BSL, антипаттерны, требования EDT, работа с БСП. Скрипты правят XML-выгрузку
напрямую, поэтому базовые операции идут без запущенной платформы и без Конфигуратора. Вместе с нашим
плагином [AI-EDT](https://github.com/Desko77/ai-edt) агент получает еще и семантическую модель самой
1C:EDT - об этом ниже.

Кому пригодится: разработчику 1С, который держит исходники под git и готов отдать агенту рутину -
scaffold объектов, разбор чужих обработок, выгрузку и загрузку конфигурации, ревью, тесты.

Отдельный класс - **справочники API прикладных конфигураций**. Агент не угадывает, какой метод
типовой вызвать, а берет его из справочника. Первый такой скил - `zup-hr-api-reference` для
1С:ЗУП 3.1: кадровый учет, средний заработок и начисления, пособия и обмен с СФР,
регламентированная отчетность.

## Что умеет

| Группа | Что делает | Скилов |
|--------|------------|--------|
| Маршрутизатор | подсказывает, каким скилом решать задачу | 1 |
| Конфигурация | создать с нуля, изменить свойства, проанализировать, прочитать состояние поддержки | 7 |
| Объекты метаданных | собрать из JSON, разобрать обратно в JSON, править реквизиты и табличные части | 6 |
| Управляемые формы | собрать из DSL или по метаданным объекта, править, разобрать, проверить | 8 |
| Расширения | создать, заимствовать объект, поставить перехватчик на метод, сверить с основной | 6 |
| Обработки и отчеты | собрать .epf и .erf из исходников и разобрать обратно | 10 |
| Базы данных | создать, выгрузить и загрузить .cf, .dt и XML, обновить, запустить | 11 |
| Роли, подсистемы, макеты, СКД, XDTO | сборка и разбор своим DSL под каждый вид | 25 |
| Веб-публикация и тестирование | опубликовать базу через Apache, прогнать сценарий в браузере | 5 |
| БСП, 1С 7.7, обмены | поиск функций БСП, разработка под 7.7, правила КД 2.0 и 3.1 | 7 |
| Справочные и утилитарные | документация платформы, справочники API типовых, транскрибация, docx и xlsx, окружение агента | 26 |

Полный перечень с описанием каждого скила - в разделе [Скилы](#скилы-112) ниже.

И **35 правил** - подключаются один раз и действуют во всех задачах, без напоминаний в каждом
промпте:

- **код и запросы** - стандарты BSL, антипаттерны вроде запроса в цикле, оптимизация, чеклист ревью;
- **формы, метаданные, EDT** - требования к XML форм, целостность MDO, ограничения экспорта из EDT;
- **БСП и типовые** - переиспользовать готовое вместо своего велосипеда, размечать правки типовых;
- **процесс и сам агент** - SDD-workflow, выбор модели под задачу, рабочая память, безопасность git.

## Как это выглядит

Справочник с реквизитами и табличной частью. На входе пятнадцать строк JSON:

```json
{
  "type": "Справочник",
  "name": "Контрагенты",
  "codeLength": 11,
  "descriptionLength": 150,
  "hierarchical": true,
  "attributes": [
    "ИНН: Строка(12), index",
    "Покупатель: Булево",
    "ОсновнойМенеджер: СправочникСсылка.Пользователи"
  ],
  "tabularSections": {
    "КонтактныеЛица": ["ФИО: Строка(150), req", "Телефон: Строка(20)"]
  }
}
```

Один вызов скила `1c-meta-compile` - и на диске почти шестьсот строк корректного XML:

- `Catalogs/Контрагенты.xml` - 580 строк со всеми обязательными секциями, стандартными реквизитами
  и сгенерированными UUID;
- `Catalogs/Контрагенты/Ext/ObjectModule.bsl` - заготовка модуля объекта;
- запись `Контрагенты` в `Configuration.xml`, то есть объект сразу в составе
  конфигурации, а не сиротой на диске;
- `Validation OK: Catalog.Контрагенты (11 checks)` от валидатора набора.

Структуру файла агент не выдумывает и не подсматривает в чужих выгрузках: формат зашит в скил и
закреплен снапшот-тестами, которые сравнивают результат с эталоном.

## Установка

Два пути на выбор: попросить агента или сделать руками.

### Вариант 1: попросить агента, без единой команды

Скопируйте текст ниже, подставьте свой каталог вместо `` и отдайте агенту в новой сессии.
Дальше он все сделает сам: склонирует репозиторий, снимет опись машины, покажет план и поставит
только то, что вы выберете.

```
Установи мне набор скилов, правил и связанных инструментов для работы с 1С
из репозитория https://github.com/Desko77/claude-code-skills-1c

Порядок:
1. Склонируй репозиторий в , если он уже там - выполни git pull.
2. Прочитай в нем skills/claude-env-setup/SKILL.md и ОБА файла из
   skills/claude-env-setup/references/ - safety.md и components.md.
   Дальше действуй строго по ним.
3. Сними опись моей машины: что уже установлено, какие MCP-серверы
   прописаны, какие порты заняты, что есть из зависимостей
   (Python, Node, Docker, ffmpeg, платформа 1С).
4. Покажи план таблицей и дождись моего выбора. Ничего не ставь
   до моего ответа.

Ограничения:
- Ничего не перезаписывай молча. Файл, который у меня уже есть
  и отличается, - покажи diff и спроси.
- Конфигурацию MCP (~/.claude/settings.json, ~/.claude.json,
  .mcp.json проекта) правь СЛИЯНИЕМ: добавляй только отсутствующие
  ключи, файл целиком не переписывай.
- Не трогай мои скилы и правила, которых нет в наборе.
- Не завершай запущенные сеансы 1С и EDT, не пересоздавай
  существующие venv и Docker-контейнеры.
- Перед первой правкой любого конфига сделай резервную копию
  с меткой времени.

В конце дай отчет: что поставлено, что не встало и почему,
и отдельным списком - что мне нужно сделать руками: перезапустить
клиент, вписать ключи API, поставить плагин в EDT.
```

Этот же путь годится для обновления: агент доставит недостающее и не тронет ваши правки. Готовые
промпты под остальные случаи - обновление рабочей машины, проверка без установки, установка одного
компонента - лежат в [`skills/claude-env-setup/PROMPT.md`](skills/claude-env-setup/PROMPT.md).

### Вариант 2: руками, если вы знаете, что делаете

```bash
cp -r skills/* ~/.claude/skills/     # или один скил: cp -r skills/1c-meta-compile ~/.claude/skills/
cp rules/*.md ~/.claude/rules/
cp commands/* ~/.claude/commands/
```

> Копирование затрет ваши правки, если вы дорабатывали скилы под себя. На такой машине берите
> вариант 1: он показывает diff и спрашивает по каждому расхождению.

## Первая задача

Откройте Claude Code в каталоге с исходниками 1С и скажите задачу обычными словами: «создай
справочник Контрагенты с ИНН и табличной частью контактных лиц». Скил агент подберет сам.

Проверить, что набор работает: `node tests/skills/runner.mjs cases/meta-compile` (нужен Node.js 18+).

## AI-EDT: агентная разработка прямо в 1C:EDT

Набор раскрывается полностью вместе с **[AI-EDT](https://github.com/Desko77/ai-edt)** - MCP-сервером,
который работает плагином **внутри запущенной 1C:EDT** и дает ассистенту не текст файлов, а
семантическую модель самой среды.

| | |
|---|---|
| Репозиторий | **https://github.com/Desko77/ai-edt** |
| Установка | update site **https://desko77.github.io/ai-edt/** (в EDT: Help -> Install New Software) |
| Требования | 1C:EDT 2026.2 или 2026.1 |

Что это меняет на практике: ассистент разрешает ссылки на объекты метаданных, строит иерархии
вызовов, спрашивает у EDT выведенный тип в позиции BSL, правит метаданные без ручного XML, ставит
точки останова и читает переменные в приостановленной сессии - а результат тут же проверяет
валидаторами самой EDT. Ошибка всплывает на месте, а не при первой загрузке конфигурации в базу.
Больше сотни операций собраны в фасады `code_search`, `edit_metadata`, `launch_debugger`,
`diagnostics`, `insights`, `security_audit`, поэтому клиент видит компактный набор инструментов
вместо длинного списка почти одинаковых команд.

Скил `ai-edt-tools` в этом наборе - каталог этих инструментов и типовых сценариев: что вызывать под
задачу, в каком порядке и какие проверки обязательны после правки.

## Типовые сценарии

| Задача | Чем решается |
|--------|--------------|
| Добавить в конфигурацию документ, а к нему форму | `1c-meta-compile`, затем `1c-form-compile` |
| Доработать типовую, не снимая с поддержки | `1c-cfe-init`, `1c-cfe-borrow`, `1c-cfe-patch-method` |
| Собрать внешнюю обработку из исходников и загрузить в базу | `1c-epf-build`, `1c-db-load-cf` |
| Разобрать чужую .epf, чтобы понять, что она делает | `1c-epf-dump`, затем `1c-form-info` |
| Выгрузить конфигурацию в XML и положить под git | `1c-db-dump-xml` |
| Написать запрос и проверить его до запуска | скил `composing-1c-queries`, проверка через `validate_query` из AI-EDT |
| Не угадывать, каким скилом решать задачу | `1c-config-router` |

## Зависимости

| Компонент | Обязательно | Для чего |
|-----------|-------------|----------|
| PowerShell 5.1+ (Windows) | Да | Скрипты скилов (.ps1) |
| Python 3.8+ | Нет | Альтернативные скрипты (.py), `v8unpack-cf`, `check-uuid`, `img-grid-analysis` |
| [v8unpack](https://pypi.org/project/v8unpack/) | Нет | Распаковка/сборка CF/CFE/EPF без платформы |
| 1C:Enterprise 8.3 | Нет | Скилы группы `db-*`, сборка EPF/ERF |
| Node.js + npm-пакет `docx` | Нет | `md-to-docx` (конвертация Markdown → DOCX) |
| `ffmpeg`, `ffprobe` | Нет | `transcribe`, `transcribe-audio-local` (извлечение аудио, разбивка длинных файлов) |
| NVIDIA GPU + CUDA 12 + cuDNN 9 | Нет | `transcribe`, `transcribe-audio-local` (локальный движок faster-whisper + sherpa-onnx). CPU тоже работает, но в 10+ раз медленнее |
| `gcomp` | Нет | `1c77-dev` (разбор/сборка .ert и 1Cv7.MD для 1С 7.7) |
| Node.js + `@mermaid-js/mermaid-cli` (mmdc) | Нет | `mermaid-render` (рендер диаграмм в PNG/SVG/PDF) |
| Обработка `MCP_Toolkit.epf` ([ROCTUP](https://github.com/ROCTUP/1c-mcp-toolkit)) | Нет | `1c-mcp-toolkit` (HTTP API к живой запущенной базе 1С) |
| MCP-серверы (см. таблицу ниже) | Нет | Анализ кода, валидация запросов, документация ИТС/платформы/конфигураций |

Скилы спроектированы по слоям - базовые (генерация XML) работают без платформы, продвинутые требуют 1С или MCP.

### MCP-серверы, на которые ссылаются скилы

Сами серверы в этот репозиторий не входят - они ставятся и настраиваются отдельно, в `.mcp.json`
проекта или в пользовательских настройках Claude Code. Здесь перечислены ключи ровно в том виде, в
каком они пишутся в скилах и правилах, чтобы ссылки читались однозначно.

| Ключ сервера | Для чего | Кто использует |
|--------------|----------|----------------|
| [`ai-edt`](https://github.com/Desko77/ai-edt) | BSL-код, метаданные, формы, валидация запросов, ошибки проекта, отладка, обновление ИБ. Плагин внутри 1C:EDT, 100+ операций в фасадах. [Update site](https://desko77.github.io/ai-edt/) | `ai-edt-tools`, `composing-1c-queries`, `1c-query-optimization` |
| [`bsl-platform-help`](https://github.com/Desko77/mcp-bsl-platform-help-context) | API платформы: методы, типы, сигнатуры, конструкторы, стиль и строгая типизация | `1c-platform-docs` |
| [`1c-naparnik`](https://github.com/Desko77/1c-ai-mcp) | Ревью кода, стандарты ИТС, документация платформы и конфигураций | `1c-naparnik` |
| `1c-mcp_ssl_server` | Поиск функций БСП по описанию задачи | `1c-ssl-patterns` |
| [`1c-forms-mcp`](https://github.com/Desko77/1c-formsserver) | Генерация обычных (неуправляемых) форм вне EDT-проекта | правило `forms_generation.md` |
| `1c77-metadata` | Конфигурация 1С 7.7: объекты, реквизиты, модули ([установка](https://github.com/ivanarama/77MCP)) | `1c77-dev` |
| `1c-syntax-checker-mcp` | Проверка синтаксиса BSL без запущенной EDT | правило `mcp-tool-priority.md` |
| [`1c-templates-mcp`](https://github.com/Desko77/1c-templates-mcp) | Семантический поиск по 2200+ шаблонам кода BSL | правило `mcp-tool-priority.md` |

Скил `ai-edt-tools` и правила написаны под **AI-EDT**: ключ сервера `ai-edt`, инструменты свернуты
в фасады с маршрутизацией через `operation=`. Если у вас подключен другой MCP-плагин для EDT, каталог
из `references/` к нему неприменим - имена инструментов и их состав там свои: берите фактические из
`tools/list` своей сессии.

Отдельно: `1c-mcp-toolkit` - это скил репозитория, а не MCP-сервер. Он ходит в живую базу по HTTP через
обработку `MCP_Toolkit.epf`, поэтому в `.mcp.json` его прописывать не нужно.

## Совместимые сторонние плагины

Основной спутник набора - собственный **[AI-EDT](https://github.com/Desko77/ai-edt)** (см. раздел в начале).
Кроме него с набором сочетаются:

**[bsl-language-server](https://github.com/1c-syntax/claude-code-bsl-lsp)** - полноценная интеграция
BSL Language Server в Claude Code как LSP: диагностики, go to definition, find references, hover,
форматирование, code actions для `.bsl` и `.os`.

```
/plugin marketplace add 1c-syntax/claude-code-bsl-lsp
/plugin install bsl-language-server@bsl-language-server
```

**Плагины Anthropic** - `code-review` и `pr-review-toolkit` для ревью PR агентами, `mcp-server-dev`
для разработки MCP-серверов, `claude-md-management` для поддержания CLAUDE.md, `security-guidance`
для security-ревью.

```
/plugin marketplace add anthropics/claude-plugins-official
/plugin install @claude-plugins-official
```

## Скилы (112)

Начать проще всего с `1c-config-router`: он сам определяет, каким скилом или workflow
решать задачу.

СкилОписание

Маршрутизатор
1c-config-routerОпределяет нужный workflow или скил для задачи
Конфигурация (cf-*, support-*)
1c-cf-initСоздать пустую конфигурацию (scaffold XML), версии формата 2.17-2.21
1c-cf-infoАнализ структуры конфигурации
1c-cf-editИзменить свойства конфигурации
1c-cf-validateВалидация конфигурации
1c-cf-add-objectWorkflow: добавить объект в конфигурацию
1c-cf-new-projectWorkflow: создать конфигурацию с нуля
1c-support-stateСостояние поддержки в XML-выгрузке: чтение, editable/off-support/locked, возможность изменения
Объекты метаданных (meta-*)
1c-meta-compileСоздать объект метаданных из JSON DSL (37 типов)
1c-meta-decompileДекомпиляция объекта в JSON-заготовку формата meta-compile - черновик нового объекта по образцу
1c-meta-editИзменить реквизиты, ТЧ, свойства объекта
1c-meta-infoАнализ структуры объекта
1c-meta-removeУдалить объект из конфигурации
1c-meta-validateВалидация объекта метаданных
Формы (form-*)
1c-form-compileСоздать форму из JSON DSL
1c-form-decompileРазобрать Form.xml в JSON-черновик DSL
1c-form-editДобавить элементы, реквизиты, команды в форму
1c-form-addДобавить форму к объекту конфигурации
1c-form-infoАнализ структуры формы
1c-form-patternsПаттерны проектирования форм
1c-form-removeУдалить форму
1c-form-validateВалидация формы
Расширения (cfe-*)
1c-cfe-initСоздать расширение конфигурации
1c-cfe-borrowЗаимствовать объект из конфигурации
1c-cfe-patch-methodПерехватить метод (Before/After/ModificationAndControl)
1c-cfe-diffАнализ расширения
1c-cfe-validateВалидация расширения
1c-cfe-full-cycleWorkflow: полный цикл создания расширения
Обработки и отчеты (epf-*, erf-*)
1c-epf-scaffoldСоздать пустую обработку
1c-epf-add-formДобавить форму к обработке
1c-epf-buildСобрать EPF из XML-исходников
1c-epf-dumpРазобрать EPF в XML-исходники
1c-epf-validateВалидация обработки
1c-epf-full-cycleWorkflow: полный цикл создания обработки
1c-erf-initСоздать пустой отчет
1c-erf-buildСобрать ERF
1c-erf-dumpРазобрать ERF
1c-erf-validateВалидация отчета
Пакеты XDTO (xdto-*)
1c-xdto-compileСоздать пакет XDTO из XML-схемы (XSD)
1c-xdto-decompileВыгрузить пакет XDTO обратно в XSD
1c-xdto-editТочечная правка типов и свойств пакета
1c-xdto-infoСтруктура пакета: типы, свойства, точки входа
1c-xdto-validateВалидация пакета XDTO
Подсистемы и интерфейс
1c-subsystem-compileСоздать подсистему
1c-subsystem-editИзменить состав подсистемы
1c-subsystem-infoАнализ подсистемы
1c-subsystem-validateВалидация подсистемы
1c-interface-editНастроить командный интерфейс
1c-interface-validateВалидация интерфейса
Макеты (mxl-*, template-*)
1c-mxl-compileСоздать м

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Desko77](https://github.com/Desko77)
- **Source:** [Desko77/claude-code-skills-1c](https://github.com/Desko77/claude-code-skills-1c)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-desko77-claude-code-skills-1c
- Seller: https://agentstack.voostack.com/s/desko77
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.