Skip to main content
skill CX Codex

subsystem-compile — Claude Code skill: what it does, how to install

subsystem-compile generates 1C subsystem XML from a JSON definition and registers it in the configuration.

MIT 45 installs ★ 811 updated 2026-10-23

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills
Open on GitHub

What subsystem-compile does

The skill takes JSON with a name, synonym, object list, and visibility flags, builds the subsystem file structure in Subsystems/, and registers it in Configuration.xml or a parent subsystem. The command runs a PowerShell script that assembles XML according to the 1C schema, validates the definition, and updates configuration metadata.

Only the name field is required; synonym, picture, and content are optional. For nested subsystems, pass the parent path via -Parent. The script needs PowerShell and a 1C configuration exported to XML.

What it helps with

  • add a section to a 1C configuration via JSON
  • generate subsystem XML with picture and content
  • register a nested subsystem inside a parent
  • build subsystem file structure from definition

Example prompts for the agent

  • Create a subsystem named Sales with objects catalog Items and document Order
  • Add a minimal subsystem Test to the configuration in the config/ folder
  • Make a nested subsystem Reports inside the Sales subsystem

How to install subsystem-compile

1Plugin marketplace

/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skills

This installs the whole 1c-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add Nikolay-Shirokov/cc-1c-skills --skill subsystem-compile -a claude-code

3Manually: put the files in place

~/.claude/skills/subsystem-compile/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/subsystem-compile/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about subsystem-compile

How to install subsystem-compile in Claude Code?

Run /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, then /plugin install 1c-skills@cc-1c-skills. The skill will appear at ~/.claude/skills/subsystem-compile/SKILL.md.

What does subsystem-compile do?

Generates 1C subsystem XML files from a JSON definition, creates the structure in Subsystems/, and registers the subsystem in Configuration.xml or a parent subsystem.

Which fields are required in the JSON definition?

Only name. Synonym, picture, object content, and visibility flags are optional.

Source text

SKILL.md · MIT
---
name: subsystem-compile
description: Создать подсистему 1С — XML-исходники из JSON-определения. Используй когда нужно добавить подсистему (раздел) в конфигурацию
argument-hint: "[-DefinitionFile <json> | -Value <json-string>] -OutputDir <ConfigDir> [-Parent <path>]"
allowed-tools:
  - Bash
  - Read
  - Write
  - Glob
---

# /subsystem-compile — генерация подсистемы из JSON

Принимает JSON-определение подсистемы → генерирует XML + файловую структуру + регистрирует в родителе (Configuration.xml или родительская подсистема).

## Параметры и команда

| Параметр | Описание |
|----------|----------|
| `DefinitionFile` | Путь к JSON-файлу определения |
| `Value` | Инлайн JSON-строка (альтернатива DefinitionFile) |
| `OutputDir` | Корень выгрузки (где `Subsystems/`, `Configuration.xml`) |
| `Parent` | Путь к XML родительской подсистемы (для вложенных) |
| `NoValidate` | Пропустить авто-валидацию |

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/subsystem-compile.ps1" -Value '<json>' -OutputDir '<ConfigDir>'
```

## JSON-определение

```json
{
  "name": "МояПодсистема",
  "synonym": "Моя подсистема",
  "comment": "",
  "includeInCommandInterface": true,
  "useOneCommand": false,
  "explanation": "Описание раздела",
  "picture": "CommonPicture.МояКартинка",
  "content": ["Catalog.Товары", "Document.Заказ"]
}
```

Минимально: только `name`. Остальное — дефолты.

## Примеры

```powershell
# Минимальная подсистема
... -Value '{"name":"Тест"}' -OutputDir config/

# С составом и картинкой
... -Value '{"name":"Продажи","content":["Catalog.Товары","Report.Продажи"],"picture":"CommonPicture.Продажи"}' -OutputDir config/

# Вложенная подсистема
... -Value '{"name":"Дочерняя"}' -OutputDir config/ -Parent config/Subsystems/Продажи.xml
```

© Nikolay Shirokov · MIT · Nikolay-Shirokov/cc-1c-skills

Similar skills

Everything for 1C →

From the same set81

The whole set →

Project sponsors

Companies that keep this analytics open