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

entity-creation — скилл для Claude Code: создание сущностей Honeydew и установка

Скилл entity-creation ведёт агента через создание сущности Honeydew из источника в хранилище данных: тип источника, ключ гранулярности, первичная привязка атрибутов. Затем отправляет объект в Honeydew через MCP-инструменты.

Apache-2.0 ★ 44 обновлён 2026-08-30

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add honeydew-ai/honeydew-ai-coding-agents-plugins --skill entity-creation -a claude-code
Открыть на GitHub

Что делает entity-creation

Сущность в Honeydew — именованное представление бизнес-понятия на фиксированной гранулярности, к которому привязываются метрики и вычисляемые атрибуты. Скилл раскладывает создание на три вопроса: что это за понятие, какой столбец делает строку единственной в своём роде и какие колонки источника выставить как атрибуты. Источником может быть таблица, представление или произвольный SQL-запрос в Snowflake, Databricks или BigQuery, а также виртуальная сущность из семантической модели.

По способу создания есть выбор: import_tables для быстрого импорта таблиц с автоматической привязкой колонок, create_entity как основной путь — он создаёт сущность и её датасет за одну операцию и требует YAML, упрощённого API здесь нет. create_object пригодится, когда нужно добавить второй датасет к существующей сущности. После успешного вызова ответ содержит ui_url, и скилл требует показать эту ссылку пользователю.

Перед работой агент проверяет сессию через get_session_workspace_and_branch, для разработки создаётся ветка через create_workspace_branch. У скилла есть список типовых ошибок: ключи с дубликатами или NULL дают молча неверные джойны, custom SQL блокирует проброс фильтров, а на дате-измерении легко забыть is_time_spine. Вычисляемые атрибуты и связи здесь не создаются — это задачи attribute-creation и relation-creation.

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

  • создать сущность Honeydew поверх таблицы хранилища
  • импортировать несколько таблиц в семантическую модель одной командой
  • задать ключ гранулярности и привязать колонки к атрибутам
  • добавить второй датасет к уже существующей сущности
  • выбрать ветку workspace перед началом моделирования

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

  • Создай сущность orders по таблице ANALYTICS.PUBLIC.ORDERS, ключ — order_id
  • Импортируй таблицы DB.RAW.CUSTOMERS и DB.RAW.PRODUCTS в семантическую модель
  • Добавь сущность customers из SQL-запроса и покажи ссылку на неё в Honeydew

Как установить entity-creation

1Через Skills CLI (Vercel)

npx skills add honeydew-ai/honeydew-ai-coding-agents-plugins --skill entity-creation -a claude-code

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

~/.claude/skills/entity-creation/SKILL.md

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

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

Вопросы об entity-creation

Как установить entity-creation в Claude Code?

Выполните npx skills add honeydew-ai/honeydew-ai-coding-agents-plugins --skill entity-creation -a claude-code — скилл попадёт в ~/.claude/skills/entity-creation/SKILL.md.

Что делает entity-creation?

Проводит агента через определение сущности Honeydew: выбор источника в хранилище, ключ гранулярности, привязка атрибутов, а затем публикует объект через MCP-инструменты create_entity или import_tables.

Чем create_entity отличается от import_tables?

import_tables быстро импортирует таблицы с автоматической привязкой колонок и подходит для прототипов. create_entity требует YAML, но создаёт сущность и датасет за один вызов и даёт полный контроль над определением.

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

SKILL.md · Apache-2.0
---
name: entity-creation
description: Guides you through defining a new Honeydew entity from a data warehouse source — covering source type, granularity key, and initial attribute mapping — then pushes to Honeydew via the MCP tools.
---

## Prerequisites

Before creating entities, ensure you are on the correct workspace and branch. Use `get_session_workspace_and_branch` to check the current session context. For development work, create a branch with `create_workspace_branch` (the session switches automatically). See the `workspace-branch` skill for the full workspace/branch tool reference.

---

## Overview

A Honeydew **entity** is the foundational modeling object — a named, governed representation of a business concept at a specific granularity. Every metric and calculated attribute is anchored to an entity. An entity maps to a data warehouse (Snowflake, Databricks, or BigQuery) table, view, custom SQL query, or a virtual derivation from the semantic model.

When creating an entity you are answering three questions:

1. **What is this?** — the business concept (orders, customers, products, locations)
2. **What makes a row unique?** — the granularity key (primary key column(s))
3. **What columns should be exposed?** — the initial attribute mapping from source columns

> This skill focuses on the entity shell: source, key, and attribute mapping.
> Use `attribute-creation` to add calculated attributes and `relation-creation` to wire up joins afterwards —
> see [After Validating: Hand Off to relation-creation](#after-validating-hand-off-to-relation-creation).

---

## Creation Methods

### Quick Import: import_tables

Use `import_tables` to quickly import one or more data warehouse tables into the semantic model.
Each table becomes an entity with its columns automatically mapped as attributes. This is the fastest way to bootstrap entities when you don't need custom YAML.

Parameters:

- `tables` — List of fully qualified table names in the format `<database>.<schema>.<table>`

Best for: bulk imports, quick prototyping, or when the default column-to-attribute mapping is sufficient.

### Primary: create_entity (Recommended)

Unlike metrics and attributes, entity creation always requires YAML — there is no simplified single-expression API. `create_entity` is the preferred MCP tool because it creates both the entity and its dataset in a **single operation**.

Parameters:

- `entity_yaml` — YAML defining the entity
- `dataset_yaml` — YAML defining the dataset

Required permission: Editor or higher.

### Alternative: create_object (Generic)

Use `create_object` only when creating an entity or dataset independently (e.g. adding a second dataset to an existing entity). Requires a separate call per object.

Parameters:

- `yaml_text` — YAML defining the object

### After Creation: Display the UI Link

After a successful `create_entity` or `create_object` call, the response includes a `ui_url` field. **Always display this URL to the user** so they can quickly open the object in the Honeydew application.

---

## Decision Flow

```
Need to create an entity?
    │
    ├─► Quick import from warehouse table(s)? Default mapping is fine?
    │       └─► Use import_tables ✓ (fastest)
    │
    ├─► New entity + dataset together (most common)?
    │       └─► Use create_entity ✓ (full control)
    │
    ├─► Adding a second dataset to existing entity?
    │       └─► Use create_object with dataset YAML only
    │
    └─► Updating an existing entity or dataset?
            └─► Use update_object with YAML + object_key
                (preserve existing field order — minimal diff)

Entity written?
    └─► Validate it, then hand off to relation-creation for joins
```

---

## Examples

See [examples.md](examples.md) for full worked examples covering: physical table, custom SQL, virtual entity, time spine, update, and delete.

---

## Discovery Helpers

Use these MCP tools before creating entities:

- `list_entities` — List all entities in the model
- `get_entity` — Get detailed info for a specific entity (attributes, metrics, datasets, relations)
- `search_model` — Search for entities, fields, or other objects by name (use `search_mode: EXACT` for known names, `OR` for broad discovery)
- `list_databases` — List all databases in the connected data warehouse
- `list_schemas` — List schemas in a specific database
- `list_tables` — List warehouse tables (requires `database` and `schema` parameters)
- `get_table_info` — Get column details for a specific warehouse table

---

See [reference.md](reference.md) for: YAML schemas (entity + dataset), source types, and granularity key rules.

---

## Documentation Lookup

Use the `search_docs` and `query_docs_filesystem` tools from the `honeydew` MCP server to search the Honeydew documentation when:

- You need to understand entity source types (physical table, custom SQL, virtual entity) in more depth
- The user asks about granularity design, entity modeling patterns, or best practices
- You need guidance on advanced modeling configurations like time spines, composite keys, or multi-dataset entities
- The user asks about entity governance, ownership, or lifecycle
- The user needs advanced modeling patterns (e.g., slowly changing dimensions, snapshot entities, incremental models)

Search for topics like: "entities", "source types", "granularity", "time spine", "virtual entity", "custom SQL source".

---

## Best Practices

- **Always set `owner`** to identify the responsible team or person for governance and accountability.
- **One entity = one granularity.** Never mix row-level grains. If a table has order-level and line-item-level rows, model them as two separate entities.
- **Name entities after the business concept, not the table.** `orders` is better than `fact_orders` or `fct_orders_v2`.
- **Always expose foreign key columns as attributes.** FK columns (e.g. `customer_id` on orders) are required for Honeydew to resolve relations.
- **Set `timegrain` on every date/timestamp source column.** Omitting it leads to unexpected aggregation behavior in BI tools.
- **Prefer absolute table paths** (`DB.SCHEMA.TABLE`) to avoid ambiguity across environments.
- **Convention:** entity = `orders`, dataset = `orders_source`. Keeping names distinct prevents confusion in YAML.

---

## Common Pitfalls to Avoid

- **Non-unique or nullable keys.** Honeydew assumes keys are unique and non-null. Duplicates cause silent incorrect join results. Validate before modeling.
- **Using custom SQL when a physical table would do.** Custom SQL blocks filter pushdown. Use a domain-level filter instead and keep the entity on the physical table.
- **Skipping the key column in the attribute list.** The key column must be in the dataset attributes list or Honeydew cannot resolve it.
- **Composite keys on virtual entities.** Use `HASH()` to create a single synthetic key attribute instead.
- **Forgetting `is_time_spine` on your date dimension.** Time-aware metrics will not function without a designated time spine entity.

---

## MANDATORY: Validate After Creating

**After creating ANY entity, you MUST invoke the `validation` skill to test and validate.**

See `validation` skill for:

- How to verify entity exists via `list_entities`
- How to verify data flows via `get_data_from_fields`
- Sanity checks (row count, key uniqueness)
- When to alert the user about issues

**Quick validation:**

1. Verify entity exists using `list_entities`, filter for the new entity name.
2. Verify data flows using `get_data_from_fields` with:

- `metrics`: `["<entity>.count"]`

---

## After Validating: Hand Off to relation-creation

A validated entity is not yet reachable from the rest of the model: nothing joins to it, so no metric can cross into it and no filter propagates. `import_tables` is the sharp case, landing a batch of entities whose FK columns are mapped as attributes and connected to nothing.

**Once the entity has validated, invoke the `relation-creation` skill** to find the candidate joins and propose them. That skill owns the search, the modeling choices and the write; it will come back here if a junction table or a role-playing copy has to be created as an entity first.

Skip this only when the user declined relations, or when the entity is deliberately standalone (a config lookup, a static parameter table). Do not write a `relations:` block from here to save the round trip — every rule about which side holds it, and about `update_object` replacing the whole block, lives in `relation-creation`.

© honeydew-ai · Apache-2.0 · honeydew-ai/honeydew-ai-coding-agents-plugins

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

Все скиллы по теме «Данные и базы» →
sql-queries официальный anthropics Скилл sql-queries помогает писать и оптимизировать запросы под диалекты PostgreSQL, Snowflake, BigQuery, Redshift и Databricks SQL. Полезен при миграциях и расчёте витрин. CX Codex +1 4 700установок data-context-extractor официальный anthropics Скилл data-context-extractor для извлечения знаний аналитиков о корпоративном хранилище данных и автоматического создания справочников. Работает в двух режимах: начальное заполнение схемы и добавление новых доменов. CX Codex +1 3 300установок semantic-models Kurt Buhler Плагин semantic-models для проектирования, оптимизации и ревью семантических моделей Power BI прямо в Claude Code. Помогает структурировать данные, применять соглашения об именовании и писать запросы Power Query. ★ 1 104звёзд репо dbt-sf-to-bq-translator официальный google Скилл dbt-sf-to-bq-translator для Claude Code, Gemini CLI и Codex транслирует SQL-модели dbt из Snowflake в BigQuery. Запускается при переносе существующего dbt-пайплайна с одной платформы на другую. CX Codex +1 2 300установок migrating-dbt-project-across-platforms dbt-labs Скилл migrating-dbt-project-across-platforms помогает перенести dbt-проект между хранилищами данных с помощью dbt Fusion. Он находит различия в SQL-диалектах и сверяет логику через unit-тесты. CX Codex +1 531установок building-syncs celigo Скилл building-syncs помогает настраивать Celigo Data Ingestion для переноса таблиц из приложений в хранилища данных. Пригодится при репликации в Snowflake, BigQuery или MSSQL. CX Codex +1 1 400установок

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

Весь набор →
query-debugging Скилл query-debugging инспектирует историю запросов в Honeydew, показывает скомпилированный SQL и помогает находить причины сбоев. CX Codex +1 ★ 44звёзд репо model-exploration Скилл model-exploration помогает изучить семантический слой Honeydew: выбрать рабочее пространство, найти сущности и поля, проверить значения точечным запросом. CX Codex +1 ★ 44звёзд репо metric-creation Скилл metric-creation для Claude Code пошагово создаёт бизнес-метрику в Honeydew: собирает SQL-агрегацию, проверяет контекст и записывает её через MCP. KPI становится переиспользуемым. CX Codex +1 ★ 44звёзд репо filtering Скилл filtering обучает ассистента правилам и синтаксису фильтрации данных в аналитическом слое Honeydew при составлении запросов и метрик. CX Codex +1 ★ 44звёзд репо domain-creation Скилл domain-creation для Claude Code и ещё пяти платформ, который проводит агента через создание домена Honeydew. Домен ограничивает видимость сущностей и полей, накладывает обязательные фильтры и задаёт управляемый контекст для анализа. CX Codex +1 ★ 44звёзд репо conversation-review Скилл conversation-review помогает кураторам семантического слоя разбирать историю аналитических диалогов, группировать отзывы пользователей и вносить точечные правки в модель данных. CX Codex +1 ★ 44звёзд репо context-item-creation Скилл context-item-creation помогает выбрать и оформить контекстные инструкции, процедуры, ссылки на знания и события памяти. Он нужен, когда аналитическому ИИ требуется постоянный организационный контекст. CX Codex +1 ★ 44звёзд репо attribute-creation Скилл attribute-creation ведёт по шагам через создание расчётного атрибута на сущности Honeydew: сборка SQL-выражения, YAML и отправка через MCP-инструменты. CX Codex +1 ★ 44звёзд репо

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

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