bsl-ai-toolkit

A set of skills, rules and MCP servers for 1C Enterprise 8.3 development where the agent works from real code and docs, not from memory

Skill

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

Why this level

  • Edits metadata and configuration code with apply into a test database
  • Reaches into database data and operations systems
  • Uses ssh, scp and credentials via environment variables
All reasons and checks
Russian stack

vgtitov/bsl-ai-toolkit

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/bsl-ai-toolkit

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Assembled automatically, review before installing.

Run in a terminal in the project folder

npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a claude-code -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a cursor -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a github-copilot -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a codex -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a gemini-cli -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a cline -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

Run in a terminal in the project folder

npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a roo -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

A fork of Roo Code, same .roo folders.

Run in a terminal in the project folder

npx skills add vgtitov/bsl-ai-toolkit --skill 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester 1c-admin-devops 1c-analyst 1c-dba 1c-dev 1c-estimation 1c-expert 1c-metadata 1c-tester -a opencode -y

The skills tool installs the current version from the repository. Add the -g flag to use the skill in every project.

You will need: Node.js

Checked against the repository on Sep 26, 2026, commit 8160cc1.

Text for your agent

Clone the repository and run onboarding: git clone https://github.com/vgtitov/bsl-ai-toolkit, then sh onboard/onboard.sh. Fill the paths to the 1C code, platform and tools in environment variables per .env.example, then work through the generated rules and MCP config.

Other ways from the author
git clone https://github.com/vgtitov/bsl-ai-toolkit
cd bsl-ai-toolkit
sh onboard/onboard.sh

Idempotent onboarding. On Windows use onboard/onboard.ps1. Paths and credentials are set in environment variables per .env.example.

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

What it does

A reusable toolkit for 1C Enterprise 8.3 development in the BSL language: rules, eight role-based skills, MCP servers and a deterministic metadata editing engine. A single core in the core directory is shared across agents, and thin adapters wire up Claude Code, Cursor, Copilot, Gemini CLI, Codex, Cline and Windsurf. The MCP servers give search over the real configuration and extension code, BSL Language Server diagnostics after an edit, read of operations data and read-only access to database data. The engine edits forms, data composition schemas and attributes in the Configurator and EDT formats with a round-trip check, so the model does not invent methods or structure.

Who it is for. For 1C developers and teams who need verifiable AI-assisted development from real code rather than the model's guesses.

Good fit when

  • You write or review BSL code and want checks against real code via MCP
  • You need to edit forms, data composition schemas or attributes without breaking the format by hand
  • You run 1C development across several agents and operating systems

Not a fit when

  • The task is not about 1C Enterprise and the BSL language
  • You have no access to the configuration code, platform or test database the toolkit relies on

Example request

Add an attribute to the document through the metadata engine and check BSL diagnostics after the edit

Limitations

The metadata engine is pure Python, but full value needs local clones of the configuration and extension code, a 1C platform and a test database, and the apply layer uses ssh, scp and tar or a local runner. Some MCP servers require external tools: the BSL Language Server, a JDK, and optionally Zabbix or Prometheus. Paths and credentials are set through environment variables. Secrets and personal data are not sent to the model, and database data is read only, with masking.

How to disable. Remove the generated toolkit files from the project: CLAUDE.md, AGENTS.md, GEMINI.md, .mcp.json and the .claude directory, and delete the repository clone.

Security check

  • Edits metadata and configuration code with apply into a test database
  • Reaches into database data and operations systems
  • Uses ssh, scp and credentials via environment variables

README in short

The README presents bsl-ai-toolkit as a reusable toolkit for AI-assisted 1C Enterprise 8.3 development: rules, eight skills, MCP servers and a metadata editing engine. The idea is verifiability through tools: onec-code search over real code, bsl-ls diagnostics after an edit, the deterministic onec_metadata engine with round-trip, onec-ops for operations and read-only onec-data for database data. The core directory is shared across agents, thin adapters wire up specific hosts, build.sh assembles configs and onboard runs onboarding. It claims cross-platform support and operation under limited model access.

SKILL.md

---
name: 1c-dev
description: >
  Разработка и код-ревью на 1С:Предприятие 8.3 (BSL) с проверкой по РЕАЛЬНОМУ коду через MCP, а не по памяти.
  Используй всякий раз, когда пишешь, правишь или ревьюишь BSL-код, работаешь с общими модулями, формами,
  запросами, СКД, регистрами, ролями; реализуешь задачу по ЧТЗ/тех-проекту; ищешь, как устроена типовая
  конфигурация или что уже есть в расширении. Железное правило: НЕ выдумывай поведение 1С и сигнатуры —
  проверяй по реальному коду через MCP и справку платформы, после правки прогоняй BSL Language Server.
  Анализ/архитектура — скилл 1c-analyst.
---

# Разработка 1С (BSL) — писать корректный и производительный код по реальному коду

## Главное правило: спроси инструмент, не угадывай
Нейросеть врёт в деталях 1С. Источник истины — реальный код и официальная справка.

FAQ

Is the toolkit tied to one agent?

No. The core is shared, and adapters wire up Claude Code, Cursor, Copilot, Gemini CLI, Codex, Cline and Windsurf. Claude Code is the reference implementation.

What does byte-perfect metadata editing give?

Changes to forms, data composition schemas and attributes are deterministic and verified by a round-trip into a test database, so the diff is exactly the target and layout does not break.

Editors’ pick

A skills library that gives coding agents a development process: brainstorming, planning, TDD, subagents and code review

PluginMedium riskNo VPN needed292.5KRepository stars
Editors’ pick

Small composable skills for engineering with agents: plan grilling, TDD, bug diagnosis, code review and architecture

SkillLow risk271.4KRepository stars
Editors’ pick

GitHub toolkit for spec-driven development: the specify CLI adds agent commands and skills to a project, from principles to implementation

CLIMedium riskNo VPN needed139.3KRepository stars

Reference MCP servers

Model Context Protocol servers

Official

Official reference MCP servers: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time and Everything

MCP serverMedium risk90.6KRepository stars
Foxx AIbsl-ai-toolkit

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.