XBSL Skills AI-инструменты для 1С:Элемент
Каталог15 навыковGitHub Pages ready

XBSL Skills — AI-инструменты для 1С:Элемент

Набор скиллов для работы с проектами 1С:Элемент, с удобным каталогом и живыми страницами по каждому навыку.

15
Скиллов в каталоге
10
Тестовых модулей в репозитории
MIT
Лицензия и открытый исходный код

Видео

Запись живого созвона: подключаем Claude Code и Codex к проекту на 1С:Элемент, работаем со скиллами, создаём объекты конфигурации и доводим всё до деплоя в 1CmyCloud.

Видео на YouTube

YouTube ВКонтакте

Каталог скиллов

Отдельные страницы собираются прямо из файлов `SKILL.md`, поэтому сайт остаётся синхронным с исходниками репозитория.

xbsl-uuid python3
Генерация UUID v4 для объектов конфигурации 1С:Элемент. Вызывай этот скилл всякий раз, когда нужно сгенерировать один или несколько UUID для Ид объектов, реквизитов, элементов перечислений, табличных частей и т.д.
Открыть скилл →
xbsl-init Без требований
Инициализация нового проекта 1С:Элемент (XBSL) с нуля. Используй этот скилл когда пользователь хочет создать новый проект: создаёт корректную структуру папок, Проект.yaml, Проект.xbsl и Подсистема.yaml по эталонному формату. Вызывай при запросах «создай проект», «новый проект», «инициализируй проект», «init проект», «с нуля». Работает даже если в репозитории уже есть другие проекты. НЕ для: создания объектов метаданных, добавления форм, движений по регистрам.
Открыть скилл →
xbsl-subsystem-add python3
Добавление новой подсистемы в существующий проект 1С:Элемент (XBSL). Используй этот скилл когда пользователь хочет создать подсистему (раздел проекта): создаёт папку и Подсистема.yaml. Вызывай при запросах «добавь подсистему», «создай подсистему», «новый раздел», «новая подсистема». НЕ для: создания нового проекта с нуля (xbsl-init), создания объектов метаданных (xbsl-meta-add), добавления форм (xbsl-form-add).
Открыть скилл →
xbsl-explore python3
Разведка структуры проекта 1С:Элемент. Используй этот скилл перед созданием любого объекта конфигурации — находит проекты, подсистемы, существующие объекты, проверяет конфликты имён. Принимает тип объекта и опциональное имя.
Открыть скилл →
xbsl-meta-add python3
Создание объекта конфигурации в 1С:Элемент (XBSL). Используй этот скилл когда пользователь хочет создать новый объект метаданных в проекте
Открыть скилл →
xbsl-form-info python3
Анализ объекта конфигурации 1С:Элемент: возвращает object_path, fields, tc, namespace, suggested_layout, existing_forms. Используется скиллами xbsl-form-add и xbsl-file-add перед созданием или изменением форм и реквизитов. Вызывай этот скилл всякий раз, когда нужно узнать структуру объекта (реквизиты, ТЧ, пространство имён, существующие формы) перед добавлением компонентов интерфейса или реквизитов-вложений.
Открыть скилл →
xbsl-form-add python3
Создание формы интерфейса (КомпонентИнтерфейса) для объектов 1С:Элемент. Используй этот скилл когда пользователь хочет создать форму объекта (ФормаОбъекта), форму списка (ФормаСписка), форму отчёта (ФормаОтчета), или обе формы для Справочника, Документа, РегистрСведений, Отчета или другого объекта конфигурации. Также применяй при запросах типа "создай интерфейс", "добавь форму", "сделай список", "нужна карточка редактирования", "форма для отчёта".
Открыть скилл →
xbsl-file-add python3
Добавление файловых вложений (компонент СписокФайлов) к существующему объекту конфигурации 1С:Элемент. Поддерживает 4 паттерна: P1 — стандартные вложения через встроенный реквизит Файлы (новых реквизитов нет); P2 — одиночный файл (ДвоичныйОбъект.Ссылка?, макс. 1); P3 — категория файлов (Массив<ДвоичныйОбъект.Ссылка> с лимитами и фильтрами); P4 — несколько категорий (несколько P3). Вызывай когда пользователь хочет добавить вложения, загрузку файлов, скан договора, логотип, прикреплённые документы к справочнику или документу. НЕ для работы с изображениями (используй xbsl-image-add).
Открыть скилл →
xbsl-image-add python3
Добавление фото и изображений (аватар, фото товара, иконка) к объекту конфигурации 1С:Элемент. Поддерживает 2 паттерна: P5 — простое фото без обработки (ВыборФайлов + Картинка); P6 — фото с серверной обработкой (ресайз, обрезка по кругу через ОбрабатываемоеИзображение). Вызывай когда пользователь хочет добавить аватар сотрудника, фото товара, логотип компании, изображение профиля или любое одиночное изображение к справочнику или документу. НЕ для файловых вложений (используй xbsl-file-add).
Открыть скилл →
xbsl-deploy python3
Используй этот скилл для любых операций с приложениями на платформе 1С:Предприятие.Элемент (1cmycloud.com): создать приложение, задеплоить ветку из внешнего git-репозитория (GitHub, GitLab и др.), обновить, проверить статус, запустить, остановить, удалить, принять изменения (merge). Вызывай скилл всякий раз, когда пользователь упоминает деплой, запуск, остановку или управление приложением на Элементе — даже если он не говорит явно "задеплой", а просто спрашивает "как дела с приложением" или "смёрджи ветку".
Открыть скилл →
xbsl-pattern-register python3
Паттерны XBSL для работы с регистрами в 1С:Элемент — синтаксис существенно отличается от классической 1С, используй до написания кода. Вызывай когда: документ делает движения по регистру; нужен приход/расход/списание/ поступление на склад; проведение документа меняет остатки или обороты; нужна отмена проведения; документ записывает данные в регистр сведений при проведении. РегистрНакопления (паттерны A1–A5, B): приход, расход или проводки при проведении документа (ПослеЗаписи, НаборЗаписей); замена старых движений при повторном проведении; отмена проведения (очистка движений); контроль / запрет отрицательных остатков. РегистрСведений (паттерны C1–C4): запись/обновление данных по измерениям (Замещать = Истина); добавление без перезаписи (Замещать = Ложь); удаление записей по фильтру; срез последних для периодических регистров (СрезПоследних). НЕ для: отчётов по регистрам, создания объектов РН/РС, форм, справочников.
Открыть скилл →
xbsl-form-cards python3
Создаёт форму списка в виде карточек (ПроизвольныйСписок с матричной компоновкой) для объекта конфигурации 1С:Элемент. Создаёт два файла: ФормаСписка.yaml и СтрокаСписка<Объект>.yaml. Вызывай когда пользователь хочет отображать список в виде карточек, плиток, kanban-вида, новостной ленты или grid-сетки (не таблицей). Работает для Справочников и Документов.
Открыть скилл →
xbsl-rename python3
Безопасное переименование объекта конфигурации 1С:Элемент и обновление всех ссылок на него во всём проекте: типы реквизитов (Имя.Ссылка?), формы (ФормаОбъекта<Имя.Объект>), поля Интерфейс.*.Форма, XBSL-код, сами файлы объекта и его форм. Вызывай при запросах «переименуй», «rename», «поменяй имя объекта». Поддерживает два сценария: A — переименование базового объекта (Справочник, Документ, Регистр и т.д.); B — переименование формы (КомпонентИнтерфейса), при этом обновляет ссылку Форма: в YAML владельца.
Открыть скилл →
xbsl-form-dashboard python3
Создаёт главную страницу приложения 1С:Элемент (КомпонентИнтерфейса типа Форма) с виджетами СтандартнаяКарточка: KPI-счётчики, навигационные карточки, таблицы данных, баннеры, диаграммы, карусели и бенто-сетки. Генерирует два файла: ГлавнаяСтраница.yaml и ГлавнаяСтраница.xbsl с обработчиком ПослеСоздания. Вызывай когда пользователь хочет создать главную страницу, дашборд, стартовый экран приложения или лендинг с карточками.
Открыть скилл →
xbsl-lib-connect python3
Подключение внешней библиотеки (.xlib) к проекту 1С:Элемент. Автоматизирует полный цикл: получить .xlib (из файла, папки с исходниками или GitHub/GitLab URL), загрузить в панель управления через Console API, попросить пользователя выпустить релиз, прописать зависимость в Проект.yaml и дать рекомендации по использованию типов библиотеки. Вызывай когда нужно подключить внешнюю библиотеку, использовать типы другого поставщика, или добавить зависимость к проекту. НЕ для: создания объектов конфигурации — используй xbsl-meta-add.
Открыть скилл →

XBSL Skills — AI-инструменты для 1С:Элемент

Docs License Python

Набор скиллов для работы с проектами на платформе 1С:Элемент (XBSL).

Скиллы совместимы с Claude Code и другими AI-агентами, поддерживающими формат скиллов.

Скиллы

Скилл Описание
xbsl-uuid Генерация UUID v4 для объектов конфигурации
xbsl-init Инициализация нового проекта: создаёт Проект.yaml, Проект.xbsl и Подсистема.yaml в правильном формате
xbsl-subsystem-add Добавление новой подсистемы в существующий проект: создаёт папку и Подсистема.yaml
xbsl-explore Разведка структуры проекта: находит проекты, подсистемы, объекты, проверяет конфликты имён
xbsl-meta-add Создание объекта конфигурации (Справочник, Документ, Перечисление и др.) по описанию
xbsl-form-info Анализ объекта конфигурации: возвращает реквизиты, ТЧ, пространство имён и существующие формы
xbsl-form-add Создание формы интерфейса (ФормаОбъекта и/или ФормаСписка) для объекта конфигурации
xbsl-file-add Добавление файловых вложений (СписокФайлов) к объекту конфигурации: стандартные вложения, одиночный файл, категории
xbsl-image-add Добавление фото/изображений (аватар, фото товара, иконка) к объекту конфигурации: P5 — простая загрузка, P6 — ресайз и обрезка по кругу
xbsl-deploy Управление приложениями на 1С:Предприятие.Элемент: деплой, запуск, остановка, статус, merge
xbsl-pattern-register Движения по регистру накопления (приход, расход, обороты, контроль остатков) и регистру сведений (запись, удаление, срез последних)
xbsl-form-cards Создание формы списка в виде карточек (матричная компоновка) для Справочников и Документов
xbsl-rename Безопасное переименование объекта конфигурации и обновление всех ссылок во всём проекте
xbsl-form-dashboard Создание главной страницы приложения с виджетами: KPI-счётчики, навигационные карточки, таблицы, диаграммы, карусели и бенто-сетки
xbsl-lib-connect Подключение внешней библиотеки (.xlib) к проекту: из файла, папки с исходниками или GitHub/GitLab URL

Спецификации по каждому типу объекта метаданных и справочник типов реквизитов хранятся в .claude/skills/xbsl-meta-add/references/:

Файл Тип объекта
Перечисление.md Фиксированный набор значений (статусы, виды, приоритеты)
Справочник.md Хранилище записей (сотрудники, контрагенты, товары)
Документ.md Бизнес-событие с историей (заказы, накладные, акты)
РегистрСведений.md Срезы данных по измерениям (курсы валют, цены)
РегистрНакопления.md Обороты или остатки (продажи, складские остатки)
ОбщийМодуль.md Переиспользуемый код (утилиты, сервисы)
Структура.md DTO / value object
HttpСервис.md REST API (эндпоинты для внешних систем)
ГлобальноеКлиентскоеСобытие.md Событие между подсистемами
КлючДоступа.md Маркер прав доступа
ЛокализованныеСтроки.md Тексты интерфейса
ТабличныеЧасти.md Вложенные строки в Справочнике и Документе
types.md Справочник типов реквизитов

Требования

  • Claude Code или другой AI-агент, поддерживающий скиллы
  • python3 — для работы скиллов xbsl-explore, xbsl-uuid, xbsl-form-info, xbsl-form-add, xbsl-form-cards, xbsl-form-dashboard, xbsl-file-add, xbsl-deploy, xbsl-pattern-register, xbsl-lib-connect и xbsl-rename

Установка

Клонируй репозиторий и скопируй скиллы в свой проект:

git clone https://github.com/korolevpavel/xbsl-ai-skills.git
mkdir -p /путь/к/твоему/проекту/.claude/skills/
cp -r xbsl-ai-skills/.claude/skills/ /путь/к/твоему/проекту/.claude/skills/

Использование

Скиллы подхватываются автоматически. Просто опиши задачу в Claude Code:

Создай справочник Контрагенты с полями ИНН и КПП
Добавь перечисление статусов задачи: Новая, В работе, Завершена
Задеплой ветку main на Элемент
Добавь движения документа РасходнаяНакладная в регистр ТоварыНаСкладах
Добавь к справочнику Контрагенты возможность прикреплять файлы

Структура проекта 1С:Элемент

Скиллы ориентируются на стандартную структуру проекта:

<корень>/
    <Поставщик>/
        <Проект>/
            Проект.yaml
            Проект.xbsl     # обработчики НастройкаПриложения / ОбновлениеПроекта
            <Подсистема>/
                Подсистема.yaml
                СтатусЗадачи.yaml     # объект метаданных
                СтатусЗадачи.xbsl     # методы объекта (опционально)

Конфигурация xbsl-deploy

Создай файл .env в корне проекта:

# Обязательные
ELEMENT_BASE_URL=https://...
ELEMENT_CLIENT_ID=...
ELEMENT_CLIENT_SECRET=...

# Опциональные (экономят время на каждом деплое)
ELEMENT_APP_ID=...
ELEMENT_PROJECT_ID=...
ELEMENT_BRANCH=main
ELEMENT_SPACE_ID=...

Разработка

# Установить зависимости
pip install -r requirements-dev.txt

# Запустить все тесты
pytest

# Тесты одного скилла
pytest tests/skills/xbsl_deploy/
pytest tests/skills/xbsl_explore/
pytest tests/skills/xbsl_form_info/
pytest tests/skills/xbsl_form_add/
pytest tests/skills/xbsl_pattern_register/

# Покрытие кода
coverage run -m pytest && coverage report

GitHub Pages

Сайт собирается автоматически через GitHub Actions из README.md и файлов .claude/skills/*/SKILL.md.

Локальная сборка:

pip install -r requirements-site.txt
python scripts/build_site.py

Добавление новых скиллов

Каждый скилл — папка в .claude/skills/ с файлом SKILL.md. Frontmatter:

---
name: имя-скилла
description: >
  Описание для триггера скилла (по нему агент решает, когда вызывать)
---

Для создания и улучшения скиллов рекомендуется использовать skill-creator, а также руководствоваться рекомендациями agentskills.io.

Лицензия

MIT