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
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
/plugin install 1c-skills@cc-1c-skillsWhat 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-skillsThis 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-code3Manually: put the files in place
~/.claude/skills/subsystem-compile/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/subsystem-compile/
1Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill subsystem-compile -a codex2Manually: put the files in place
.agents/skills/subsystem-compile/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill subsystem-compile -a cursor2Manually: put the files in place
.cursor/skills/subsystem-compile/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Nikolay-Shirokov/cc-1c-skills .claude/skills/subsystem-compile2Manually: put the files in place
.github/skills/subsystem-compile/SKILL.md1Skills CLI (Vercel)
npx skills add Nikolay-Shirokov/cc-1c-skills --skill subsystem-compile -a gemini-cli2Platform CLI
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/subsystem-compileManually: put the files in place
.devin/skills/subsystem-compile/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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