1C SSL Skill

Install

curl -fsSL https://raw.githubusercontent.com/brake71/1c-ssl-skills/main/install.sh | bash

This is third-party code. Review the repository files before installing.

What it does

The skill helps an agent write application code with SSL without inventing interfaces. SKILL.md routes the task to one of 24 topic references: background and scheduled jobs, printing, files, access, exchange, updates, digital signatures and other subsystems. Each reference has scenarios with the full signature, module region, example and anti-patterns. The bsp_api.py script checks methods and regions against the configuration's XML dump when the project has one.

Who it is for. For 1C developers extending standard configurations built on SSL.

Example request

How do I show a user an error bound to a form field the SSL way?

Limitations

The skill targets SSL 3.1.11; for other versions signatures must be checked against the distribution sources. The src/cf dump is not shipped with the repository, so script checks need your own. The script requires Python.

How to disable. Delete the bsp folder from the agent's skills directory, for example ~/.claude/skills/bsp.

Security check

• The skill consists of instructions and references
• The script only reads the configuration XML dump

README in short

The README describes a single bsp skill with routing in SKILL.md, 24 references and an API check script that works on sources. Installers for Linux, macOS and Windows put the skill into Claude Code, Codex or OpenCode directories and replace only the bsp folder. Much of the README covers testing: unit tests, key method validation and a behavioral run with and without the skill through Codex. MIT license.

SKILL.md

---
name: bsp
description: "Разработка и ревью прикладного кода 1С с Библиотекой стандартных подсистем (БСП) 3.1.11. Используй при выборе общих модулей и публичных методов БСП, проверке сигнатур и регионов API, генерации BSL-кода для длительных и регламентных заданий, обмена, печати, файлов, доступа, обновления, ЭП/МЧД и других подсистем БСП; также когда нужно отличить стабильный API от служебного, устаревшего или модуля *Переопределяемый. Не используй для задач только по синтаксису платформы 1С, не связанных с БСП."
---

# Применение БСП 3.1.11 в прикладной разработке

Скил учит **правильно применять** Библиотеку стандартных подсистем 1С (версия
3.1.11) в прикладном коде: какие общие модули и методы вызывать, с какими
параметрами, какие нюансы и антипаттерны. Скил **самодостаточен** — в нём нет
ссылок на внешнюю документацию и хардкод-номеров строк; параметры и рабочие
примеры даны inline в `references/`.

Каждый reference — workflow-сценарии вида «задача → функция (полная сигнатура
+ регион) → параметры → пример → нюансы/антипаттерны». Это не карта методов
(которую отдаёт греп), а знание как применять БСП правильно.

Подтверждение сигнатур/регионов — по исходникам `src/cf/` через скрипт
`scripts/bsp_api.py` или греп (см. ниже). Регион БСП = имя `#Область …`:
`ПрограммныйИнтерфейс` (stable, вызывать), `СлужебныйПрограммныйИнтерфейс` /
`СлужебныеПроцедурыИФункции` (⚠️ служебный), `УстаревшиеПроцедурыИФункции`
(⚠️ deprecated), модули `*Переопределяемый` (хук переопределения — БСП
вызывает, прикладной код реализует, **не** вызывается напрямую).

## Порядок работы

1. Определи прикладную задачу и выбери по таблице ниже один основной reference.
   Подключай второй только для действительно сквозного сценария, например печати
   в фоне.
2. Найди внутри reference подходящий сценарий по заголовкам `###` и ключевым
   словам через `rg -n`; затем прочитай диапазон строк со сценарием, сигнатурами,
   примером и антипаттернами. Загружай файл целиком только когда чтение диапазона
   недоступно; не переноси в контекст несвязанные сценарии большого файла.

Related