Skip to main content
skill CX Codex

xdto-info — Claude Code skill: XDTO analysis and setup

xdto-info inspects 1C XDTO packages, types, properties, and entry points. Use it before creating an XDTO object or parsing incoming XML.

MIT 35 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 xdto-info does

The skill maps an XDTO package to the terms used in 1C: value types, required properties, nested objects, collections, and allowed enumeration values. It can also list packages in a configuration and show which types refer to a selected type.

The command starts from a package directory or the source root of a configuration. Use -Namespace, -Package, or -Name to narrow the lookup; -Depth expands nested objects, while -RequiredOnly keeps the required fields. -Mode used-by finds references to a type, and -Limit, -Offset, and -OutFile shape the result.

The skill runs xdto-info.ps1 through PowerShell, so a package directory or configuration source root must be available. Output can be saved as a UTF-8 BOM file.

What it helps with

  • list XDTO packages in configuration sources
  • inspect a type before filling a 1C object
  • identify required properties and nested objects
  • trace references to a selected type
  • save package details to a file

Example prompts for the agent

  • Run /xdto-info src to list the XDTO packages in src.
  • Inspect PaymentDocument with namespace urn:1C.ru:ClientBankExchange and expand nested objects to depth 3.
  • Use /xdto-info src -Mode used-by -Name AmountType to find types that reference AmountType.

How to install xdto-info

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 xdto-info -a claude-code

3Manually: put the files in place

~/.claude/skills/xdto-info/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/xdto-info/

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

Questions about xdto-info

How do I install xdto-info in Claude Code?

Add the marketplace with /plugin marketplace add Nikolay-Shirokov/cc-1c-skills, then install the plugin with /plugin install 1c-skills@cc-1c-skills.

What does xdto-info do?

It inspects 1C XDTO packages and reports types, properties, required fields, nested objects, entry points, and allowed values.

What does xdto-info need to run?

Pass PackagePath as either a package directory or the configuration source root. You can narrow the lookup with -Namespace, -Package, or -Name.

Source text

SKILL.md · MIT
---
name: xdto-info
description: Анализ структуры пакета XDTO 1С — типы, свойства, точки входа. Используй как подготовительный шаг при написании кода, создающего и заполняющего объект XDTO, при разборе входящего XML, а также чтобы узнать, какие пакеты есть в конфигурации
argument-hint: <PackagePath> [-Namespace <URI>|-Package <имя>] [-Name <Тип>] [-Depth N] [-RequiredOnly] [-Mode used-by] [-Limit N] [-Offset N] [-OutFile <файл>]
allowed-tools:
  - Bash
  - Read
  - Glob
---

# /xdto-info — Анализ структуры пакета XDTO

Показывает структуру типа в терминах 1С: какой тип значения присваивать, что обязательно,
где нужен вложенный объект, какие значения допустимы. Заменяет чтение `Package.bin`
или XSD с ручным переводом `xs:decimal` → `Число` и `lowerBound="0"` → необязательный.

## Параметры

| Параметр | Обязательный | Описание |
|----------|--------------|----------|
| `PackagePath` | да | Каталог пакета либо корень исходников конфигурации. Псевдоним — `-Path` |
| `Namespace` | нет | Выбрать пакет по пространству имён (когда путь — корень исходников) |
| `Package` | нет | Выбрать пакет по имени объекта метаданных |
| `Name` | нет | Имя типа. Без выбранного пакета ищется по всей конфигурации |
| `Depth` | нет | Глубина разузлования вложенных объектов. По умолчанию 1 |
| `RequiredOnly` | нет | Оставить только обязательные свойства — скелет для «заполни обязательное». Необязательный объект уходит вместе со своим содержимым |
| `Mode` | нет | `used-by` — показать, кто ссылается на тип |
| `Limit` / `Offset` | нет | Пагинация. По умолчанию 150 строк |
| `OutFile` | нет | Записать результат в файл (UTF-8 BOM) |

```powershell
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/xdto-info.ps1" -PackagePath "<путь>"
```

## Что показывает

Точка входа определяется по пути: корень исходников — список пакетов, каталог пакета —
его состав.

| Вызов | Результат |
|---|---|
| `-PackagePath src` | все пакеты конфигурации: имя, число типов, namespace |
| `-PackagePath src/XDTOPackages/ОбменСБанком` | импорты, точки входа, списки типов |
| `... -Name ПлатежныйДокумент` | структура типа для заполнения |
| `... -Name ПлатежныйДокумент -Depth 3` | то же с раскрытием вложенных объектов |
| `... -Mode used-by -Name СуммаТип` | кто ссылается на тип, включая соседние пакеты |

## Когда известны namespace и тип, но не имя пакета

Так бывает чаще всего: namespace и имя типа видны в коде или в образце XML,
а как называется пакет — нет. Вызов повторяет строку, от которой отталкиваешься:

```powershell
# ФабрикаXDTO.Тип("urn:1C.ru:ClientBankExchange", "ПлатежныйДокумент")
... -PackagePath src -Namespace "urn:1C.ru:ClientBankExchange" -Name ПлатежныйДокумент
```

Если известно только имя типа — укажи `-Name` и корень исходников: тип найдётся
по всем пакетам. При нескольких совпадениях навык покажет, где именно, чтобы уточнить.

## Что в выводе

Свойства показаны так, как их предстоит заполнять в коде: тип значения — в нотации
1С и с учётом ограничений (`Строка(6)`, `Число(18,2)`), обязательность и коллекции —
флагами, для перечислимых типов перечислены допустимые значения. Непомеченное
свойство необязательно.

Обозначения, которые сами по себе неочевидны, навык поясняет прямо в выводе —
и только те, что в нём встретились.

## Типичный workflow

1. `/xdto-info src` — какие пакеты есть
2. `/xdto-info src -Namespace "<URI>"` — точки входа и типы пакета
3. `/xdto-info src -Namespace "<URI>" -Name <Тип> -Depth 2` — структура для кода
4. Перед правкой типа: `-Mode used-by -Name <Тип>` — кого затронет

Нужна сама XML-схема, а не сводка, — это `/xdto-decompile`.

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

Similar skills

Everything for 1C →

From the same set81

The whole set →
xdto-validate xdto-validate is a Claude Code skill that statically checks 1C XDTO packages before they are applied to a configuration, finding unresolved types and broken metadata relations. CX Codex +1 36installs xdto-edit xdto-edit is a Claude Code skill that edits types and properties in 1C XDTO packages. It makes targeted changes without rewriting the entire schema. CX Codex +1 36installs xdto-compile xdto-compile builds a 1C XDTO package from an XSD and writes it into configuration sources. Use it for data exchange, integrations, or web services. CX Codex +1 36installs meta-decompile meta-decompile reads a 1C metadata object XML and emits a compact JSON draft in the meta-compile format. Useful when a new object is easier to build from an existing one than to write from scratch. CX Codex +1 36installs db-repo The db-repo skill manages a 1C configuration repository: it locks objects, pulls updates, and commits changes. Use it from Claude Code or Codex. CX Codex +1 30installs db-cfe-admin db-cfe-admin manages 1C configuration extensions in an infobase: list connected extensions, check applicability and syntax, modify properties, delete. CX Codex +1 26installs role-edit role-edit edits an existing 1C role in place: permissions, RLS rules, templates, and role properties. Its changes preserve the role UUID and other rights. CX Codex +1 23installs v8-xsd-fetch v8-xsd-fetch downloads 1C XML export XSD schemas by format version into the project directory. Use it to inspect available versions or validate an export against its schema. CX Codex +1 17installs

Project sponsors

Companies that keep this analytics open