AIKraft/Skills/metabase-data-app-semantic-layer

metabase-data-app-semantic-layer

Используйте при создании или редактировании приложений с данными, которые запрашивают таблицы и метрики Metabase через сгенерированные файлы схемы, такие как metabase.data.ts или *.metabase.data.ts.

MEMetabase official Разработка ★ 49.6k

Что делает навык

Набор правил для создания React-приложений с данными (Data Apps), использующих сгенерированную семантическую схему Metabase для безопасного и типизированного доступа к таблицам, метрикам и действиям. Обеспечивает разделение семантического и презентационного слоев, запрещая ручное формирование запросов MBQL и использование сырых ID.

Когда применять

  • Создание новых приложений с данными, запрашивающих таблицы и метрики через сгенерированные файлы схемы (например, metabase.data.ts).
  • Редактирование существующих Data Apps с соблюдением правил типизации запросов и использования хуков SDK.
  • Генерация или обновление семантической схемы (schema generation) с учетом требуемого охвата данных (таблицы, метрики, действия).
  • Исправление ошибок компиляции TypeScript, связанных с нарушением контракта определений запросов (defineQuery/defineAction).

Как работает

  1. Использовать только сгенерированную схему из файлов src/metabase.data.ts или *.metabase.data.ts для получения контекста данных.
  2. Определять запросы через named-экспорты defineQuery в директории queries/ и действия через defineAction в actions/, избегая передачи inline-объектов в хуки.
  3. Формировать запросы с использованием объектов схемы (schema.tables, schema.metrics), фильтров, группировок и агрегаций, не создавая MBQL-объекты вручную.
  4. Генерировать схему командой с параметрами scope (include-data-library, include-metric-library, include-actions, database), используя ключи из .env.local.
  5. Применять хуки useMetabaseQuery и useMetabaseQueryObject, передавая в них только статическую часть запроса, а динамические фильтры — во второй аргумент.
  6. Выполнять проверку TypeScript перед финальной сдачей работы для устранения ошибок, связанных с неверными типами или отсутствием полей в схеме.

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

Создай Data App для отображения заказов, используя сгенерированную схему из библиотеки данных.
Обнови семантический слой приложения, добавив поддержку действия по созданию новой записи.
Исправь ошибку TypeScript в компоненте графика: 'Property definedWithDefineQuery is missing'.

Что понадобится

  • Репозиторий с установленным @metabase/embedding-sdk-react/data-app.
  • Файл .env.local с переменными DATA_APP_MB_URL и DATA_APP_MB_API_KEY.
  • Наличие или возможность генерации файлов схемы (metabase.data.ts).

Описание составлено по SKILL.md навыка, сверено 08.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «metabase-data-app-semantic-layer» из репозитория: # https://github.com/metabase/metabase
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r metabase-data-app-semantic-layer/ ~/.claude/skills/metabase-data-app-semantic-layer/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.