metabase-data-app-semantic-layer
Используйте при создании или редактировании приложений с данными, которые запрашивают таблицы и метрики Metabase через сгенерированные файлы схемы, такие как metabase.data.ts или *.metabase.data.ts.
Что делает навык
Набор правил для создания React-приложений с данными (Data Apps), использующих сгенерированную семантическую схему Metabase для безопасного и типизированного доступа к таблицам, метрикам и действиям. Обеспечивает разделение семантического и презентационного слоев, запрещая ручное формирование запросов MBQL и использование сырых ID.
Когда применять
- Создание новых приложений с данными, запрашивающих таблицы и метрики через сгенерированные файлы схемы (например, metabase.data.ts).
- Редактирование существующих Data Apps с соблюдением правил типизации запросов и использования хуков SDK.
- Генерация или обновление семантической схемы (schema generation) с учетом требуемого охвата данных (таблицы, метрики, действия).
- Исправление ошибок компиляции TypeScript, связанных с нарушением контракта определений запросов (defineQuery/defineAction).
Как работает
- Использовать только сгенерированную схему из файлов src/metabase.data.ts или *.metabase.data.ts для получения контекста данных.
- Определять запросы через named-экспорты defineQuery в директории queries/ и действия через defineAction в actions/, избегая передачи inline-объектов в хуки.
- Формировать запросы с использованием объектов схемы (schema.tables, schema.metrics), фильтров, группировок и агрегаций, не создавая MBQL-объекты вручную.
- Генерировать схему командой с параметрами scope (include-data-library, include-metric-library, include-actions, database), используя ключи из .env.local.
- Применять хуки useMetabaseQuery и useMetabaseQueryObject, передавая в них только статическую часть запроса, а динамические фильтры — во второй аргумент.
- Выполнять проверку TypeScript перед финальной сдачей работы для устранения ошибок, связанных с неверными типами или отсутствием полей в схеме.
Примеры запросов агенту
Что понадобится
- Репозиторий с установленным @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.
Как подключить
SKILL.md к навыкам ассистентаНавык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.