К основному содержанию
скилл CX Codex

data-catalog — скилл для Claude Code: каталог данных

Скилл data-catalog помогает составить Markdown-каталог данных с сущностями и их связями. Он пригодится при инвентаризации данных и подготовке каталога к построению ERD.

CC-BY-4.0 ★ 1 627 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add microsoft/hve-core --skill data-catalog -a claude-code
Открыть на GitHub

Что делает data-catalog

Скилл создаёт каталог с YAML-фронтматтером по контракту DS_CATALOG_V1. Он помогает описать сущности на бизнес-уровне, источники данных, классификацию и происхождение данных, а также связи с ключами соединения, кратностью, уверенностью и основаниями. Статистику столбцов оставляют в файлах профилей, на которые ссылается profile_ref.

В процесс входят сверка количества сущностей и связей, формирование читаемых разделов из YAML и проверка схемы через scripts/validate_catalog.py. Для нового каталога есть шаблон templates/ds-catalog-v1.md; также в пакете есть схема и пример. Неоднозначные сущности, ключи или минимальную кратность нужно уточнить. Перед записью в постоянное хранилище требуется согласовать путь, а сведения о приватности с неясными ссылками передают на проверку владельцам соответствующего процесса.

Какие задачи решает

  • составить каталог сущностей и источников данных
  • зафиксировать связи с устойчивыми идентификаторами и ключами соединения
  • сохранить неопределённость в оценках связей
  • проверить YAML-контракт каталога перед ревью

Примеры запросов агенту

  • Составь каталог данных для этого проекта и сначала уточни путь для сохранения.
  • Добавь в каталог сущности и связи, сохранив неподтверждённые связи как предположения.
  • Проверь catalog.md командой scripts/validate_catalog.py.

Как установить data-catalog

1Через Skills CLI (Vercel)

npx skills add microsoft/hve-core --skill data-catalog -a claude-code

2Вручную: положить файлы

~/.claude/skills/data-catalog/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/data-catalog/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о data-catalog

Как установить data-catalog в Claude Code?

Выполните npx skills add microsoft/hve-core --skill data-catalog -a claude-code. Файл скилла находится по пути ~/.claude/skills/data-catalog/SKILL.md.

Что делает data-catalog?

Скилл формирует Markdown-каталог с YAML-контрактом DS_CATALOG_V1: описывает сущности, их связи, ключи соединения и основания для оценки уверенности.

Как проверить каталог данных?

Запустите uv run python scripts/validate_catalog.py <catalog.md>. Скрипт проверяет каталог перед ревью.

Исходный текст

SKILL.md · CC-BY-4.0
---
name: data-catalog
description: "Create and enrich durable data catalogs using the native DS_CATALOG_V1 Markdown contract, declared entity relationships, privacy citation fields, and stable relationship IDs. Use when inventorying engagement data, recording semantic relationships, or preparing a catalog for ERD rendering."
license: CC-BY-4.0
user-invocable: false
metadata:
  authors: "Microsoft (planning synthesis)"
  spec_version: "1.0"
  last_updated: "2026-08-03"
  content_based_on: "https://www.w3.org/TR/vocab-dcat-3/; https://www.w3.org/TR/prov-o/; https://www.dublincore.org/specifications/dublin-core/dcmi-terms/; https://datapackage.org/standard/table-schema/"
---

# Data Catalog Workflow

## Goal

Produce a customer-readable Markdown catalog whose YAML frontmatter is a valid `DS_CATALOG_V1` machine contract. Preserve uncertainty explicitly so inferred or assumed relationships never appear confirmed.

## Flow

1. Confirm the engagement name and the caller-approved durable output path.
2. Inventory entities at business grain. Record source access, tier, volume, profile pointer, classification, lineage, and open questions without copying column-level profile data.
3. Assign every relationship a stable `rel-*` identifier. Record endpoints, maximum cardinality, both endpoint minimums, one or more paired join-key fields, confidence, and evidence basis.
4. Reconcile coverage counts with the entity and relationship records.
5. Render the human-readable sections from the YAML facts, ending with the canonical Data Science and Engineering Coaching disclaimer footer. Narrative can explain facts but cannot redefine them.
6. Validate the artifact with `scripts/validate_catalog.py` before treating it as ready for review.

## Inputs

* Engagement context and a caller-approved output path
* Data source inventory and access status
* Business entity names, grain, and declared relationships
* Existing per-dataset profile paths, when available
* Privacy classifications or standards citations produced by the owning privacy workflow

## Success criteria

* The frontmatter declares exactly `catalog_version: DS_CATALOG_V1` and validates against `assets/ds-catalog-v1.schema.json`.
* Entity IDs and relationship IDs are unique and stable. Every endpoint and lineage reference resolves.
* Every relationship declares `cardinality` as its maximum multiplicity plus `from_minimum` and `to_minimum` as `zero` or `one`.
* Join keys use one string on both sides or paired arrays of equal length, and record field names only without primary-key, foreign-key, or uniqueness roles.
* Relationship confidence is one of `confirmed`, `inferred`, or `assumed`, and every relationship records its basis.
* Classification uses the `privacy-standards` citation-field names. The catalog does not invent standards identifiers.
* Column statistics and feature metadata remain behind `profile_ref` rather than being copied into the catalog.
* Every customer-facing catalog ends with the canonical Data Science and Engineering Coaching disclaimer footer.

## Constraints

* Treat catalog enrichment as user-driven. Offer enrichment when a source is missing, but do not change the catalog silently.
* Record source locations as paths or connection references, never embedded credentials.
* Keep DCAT alignment non-binding. The catalog is native YAML, not RDF, and makes no DCAT conformance claim.
* Keep tier recording separate from tier behavior. `data-catalog` records the tier; `dataops` owns what that tier means.
* Keep rendering separate from semantic authority. Diagram tools consume declared relationships and do not infer new ones.
* End every customer-facing catalog with the canonical Data Science and Engineering Coaching disclaimer from `disclaimer-language.instructions.md`.

## Stop rules

* Stop and request clarification when an entity grain, relationship endpoint, join-key pairing, or endpoint minimum is ambiguous.
* Stop and retain `inferred` or `assumed` confidence when evidence does not support `confirmed`.
* Stop before a durable write when the caller has not confirmed the destination.
* Stop and route privacy interpretation to `privacy-standards` or the Privacy Planner when citation values or DPIA status are unknown.

## Package resources

| Resource                                              | Use                                                                                         |
|-------------------------------------------------------|---------------------------------------------------------------------------------------------|
| [catalog-contract.md](references/catalog-contract.md) | Read for the authoritative field, identity, multiplicity, and body-generation rules         |
| [dcat-crosswalk.md](references/dcat-crosswalk.md)     | Read when planning a DCAT, DCAT-AP, or catalog-platform export                              |
| [provenance.md](references/provenance.md)             | Read for standards selection, licensing, and non-conformance boundaries                     |
| [ds-catalog-v1.md](templates/ds-catalog-v1.md)        | Copy when starting a new catalog                                                            |
| [northwind-catalog.md](examples/northwind-catalog.md) | Read as a complete valid example with scalar and composite join keys                        |
| `assets/ds-catalog-v1.schema.json`                    | Use as the structural JSON Schema for parsed frontmatter                                    |
| `scripts/validate_catalog.py`                         | Execute with `uv run python scripts/validate_catalog.py <catalog.md>` to validate a catalog |

## Attribution

The native contract, workflow, schema, template, examples, and validator are repository-original content licensed CC BY 4.0.

The crosswalk paraphrases selected concepts from W3C DCAT 3, W3C PROV-O, and Frictionless Table Schema v2. Standard names and term identifiers are factual citations, the crosswalk prose and the paired-array join-key contract are independently authored, and no upstream schema, example, table, or substantial excerpt is reproduced. Because no upstream expression is redistributed, the package remains solely CC BY 4.0. See [provenance.md](references/provenance.md).

© microsoft · CC-BY-4.0 · microsoft/hve-core

Похожие скиллы

Все скиллы по теме «Данные и базы» →
managing-data-catalog aws Скилл managing-data-catalog для Claude Code управляет бизнес-метаданными в AWS DataZone и AWS Glue Data Catalog. Он срабатывает на запросы описать набор данных, назначить владельца, создать глоссарий или опубликовать ресурс. CX Codex +1 890установок setting-up-data-catalog PostHog Скилл setting-up-data-catalog заполняет каталог метрик проекта: канонические определения, метки доверия на таблицах и проверенные связи между ними. CX Codex +1 182установок Marmot Data Catalog marmotdata MCP-сервер Marmot Data Catalog для Claude Code и других агентов: отдаёт реальные метаданные каталога Marmot — поиск активов, происхождение данных, владельцы. Агент читает схему таблиц и топиков, а не угадывает её. CX Codex +1 ★ 640звёзд репо data-quality JoelLewis Скилл data-quality помогает выстроить контроль качества финансовых данных: от правил валидации котировок до проверки происхождения данных под нормы BCBS 239. CX Codex +1 770установок data-model-architect Microsoft Субагент data-model-architect анализирует проект Power Pages и схему Dataverse, чтобы спроектировать модель данных с ER-диаграммой. Работает строго в режиме чтения. CX Codex ★ 1 167звёзд репо exploring-data-catalog aws Скилл exploring-data-catalog для Claude Code проводит аудит и инвентаризацию ресурсов AWS Glue Data Catalog, S3 Tables и каталогов Redshift. Собирает карту данных аккаунта без запросов к содержимому таблиц. CX Codex +1 7 500установок

Из того же набора148

Весь набор →
analysis-authoring Скилл analysis-authoring задаёт правила оформления EDA-ноутбуков и аналитических дашбордов: порядок разделов, выбор графиков и лимиты производительности. CX Codex +1 ★ 1 627звёзд репо RPI Reviewer Субагент RPI Reviewer для Claude Code разбирает назначенный фрагмент RPI-доказательств и возвращает кандидатов на находки с местами подтверждения. Используется в больших сравнениях. CX Codex +1 ★ 1 627звёзд репо diff-computation Правило diff-computation задаёт порядок код-ревью: сначала вычисляет дифф, затем читает файлы. Находки ограничены изменёнными строками, большие патчи читаются порциями. CX Codex +1 ★ 1 627звёзд репо rai-standards Скилл rai-standards для Claude Code собирает стандарты ответственного ИИ: NIST AI RMF 1.0, оверлей AI STRIDE и требования EU AI Act по этапам разработки. CX Codex +1 ★ 1 627звёзд репо Supply Chain Skill Assessor Субагент Supply Chain Skill Assessor оценивает supply-chain проекта по скиллу supply-chain-security и отдаёт таблицу находок: что закрыто, что частично, где дыра. Пригодится перед релизом или разбором CI. CX Codex +1 ★ 1 627звёзд репо privacy-standards Скилл privacy-standards для Claude Code содержит справочные материалы по конфиденциальности. Используется для анализа потоков данных, оценки порогов DPIA и сопоставления требований. CX Codex +1 ★ 1 627звёзд репо copilot-tracking Правило задаёт, как хранить промежуточные материалы RPI, HVE Builder и других рабочих процессов в .copilot-tracking/. Оно помогает агенту вести исследование, планы и ревью в согласованных файлах. CX Codex +1 ★ 1 627звёзд репо demo-video Скилл demo-video собирает демо-видео из упорядоченных кадров или клипов, WAV-озвучки и переходов через FFmpeg. Для первых прототипных роликов и туториалов. CX Codex +1 ★ 1 627звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой