data-catalog — скилл для Claude Code: каталог данных
Скилл data-catalog помогает составить Markdown-каталог данных с сущностями и их связями. Он пригодится при инвентаризации данных и подготовке каталога к построению ERD.
CC-BY-4.0 ★ 1 627 обновлён 2026-10-25
npx skills add microsoft/hve-core --skill data-catalog -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/data-catalog/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/data-catalog/
1Через Skills CLI (Vercel)
npx skills add microsoft/hve-core --skill data-catalog -a codex2Вручную: положить файлы
.agents/skills/data-catalog/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add microsoft/hve-core --skill data-catalog -a cursor2Вручную: положить файлы
.cursor/skills/data-catalog/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/hve-core .github/skills/data-science-engineering/data-catalog2Вручную: положить файлы
.github/skills/data-catalog/SKILL.md1Через Skills CLI (Vercel)
npx skills add microsoft/hve-core --skill data-catalog -a gemini-cli2Командой платформы
gemini skills install https://github.com/microsoft/hve-core --path .github/skills/data-science-engineering/data-catalogВручную: положить файлы
.devin/skills/data-catalog/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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