metabase-cli — скилл для Claude Code: что делает и как установить
Позволяет управлять инстансом Metabase через утилиту mb: запускать сохранённые запросы, менять дашборды, настраивать коллекции и запускать синхронизацию схем прямо из терминала.
npx skills add metabase/agent-skills --skill metabase-cli -a claude-codeЧто делает metabase-cli
Скилл даёт агенту доступ к консольному клиенту mb для взаимодействия с API Metabase. Агент оперирует профилями авторизации, ищет таблицы и поля, выгружает карточки с вопросами и моделями в форматы JSON, CSV или XLSX и меняет системные настройки. Прямой curl к эндпоинтам API не используется, потому что утилита mb сама проверяет схемы, скрывает токены и повторяет сетевые запросы при сбоях.
Через интерфейс утилиты можно запускать синхронизацию схемы базы данных, пересканировать значения колонок, редактировать сниппеты нативных SQL-запросов и настраивать git-sync для версионирования коллекций. Без предварительно установленного CLI mb в системе агент выполнять команды не сможет. Для комплексных цепочек подготовки данных авторы предлагают отдельный скилл metabase-rde.
Какие задачи решает
- выгрузить результаты карточки в CSV или JSON
- запустить ручную синхронизацию схемы базы данных
- настроить синхронизацию коллекций через git-sync
- просмотреть дерево коллекций и структуру папок
Примеры запросов агенту
- Выгрузи данные карточки 42 в формате CSV
- Запусти повторное сканирование значений полей для базы данных analytics
- Покажи дерево коллекций в Metabase
Как установить metabase-cli
1Через Skills CLI (Vercel)
npx skills add metabase/agent-skills --skill metabase-cli -a claude-code2Вручную: положить файлы
~/.claude/skills/metabase-cli/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/metabase-cli/
1Через Skills CLI (Vercel)
npx skills add metabase/agent-skills --skill metabase-cli -a codex2Вручную: положить файлы
.agents/skills/metabase-cli/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add metabase/agent-skills --skill metabase-cli -a cursor2Вручную: положить файлы
.cursor/skills/metabase-cli/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install metabase/agent-skills metabase-cli2Вручную: положить файлы
.github/skills/metabase-cli/SKILL.md1Через Skills CLI (Vercel)
npx skills add metabase/agent-skills --skill metabase-cli -a gemini-cli2Командой платформы
gemini skills install https://github.com/metabase/agent-skills --path skills/metabase-cliВручную: положить файлы
.devin/skills/metabase-cli/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add metabase/agent-skills --skill metabase-cli -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о metabase-cli
Как установить metabase-cli в Claude Code?
Выполните команду npx skills add metabase/agent-skills --skill metabase-cli -a claude-code. Также можно вручную разместить конфигурацию по пути ~/.claude/skills/metabase-cli/SKILL.md.
Зачем использовать mb CLI вместо прямых запросов к API?
Утилита mb берёт на себя авторизацию по сохранённым профилям, повторные попытки при сетевых ошибках, валидацию схем и маскирование секретов в консоли.
Что делать, если нужна сквозная дата-инженерия, а не разовые команды?
Для комплексных сценариев от сырых данных до готовых дашбордов авторы рекомендуют скилл metabase-rde, который сам оркестрирует вызовы metabase-cli.
Исходный текст
SKILL.md · MIT
--- name: metabase-cli description: > Drive a Metabase instance from the terminal via the `mb` CLI: auth profiles, databases and schemas, schema sync and field-values rescan, tables, fields, cards (questions, models, metrics) run as JSON/CSV/XLSX, dashboards and dashcards, collections and their tree, snippets, segments, measures, transforms and transform-jobs, settings, search, git-sync. Use for any Metabase operation from the terminal: "log into metabase", "what profiles do I have", "list cards", "run card 42 as CSV", "create a transform", "list dashboards", "move a dashcard", "list collections", "what's in collection 4", "show the collection tree", "list snippets", "create a segment", "archive a measure", "search metabase for X", "import the latest changes", "add a directory to git sync", "set a setting", "what schemas are in this database", "trigger a sync", "rescan field values", or any `mb <verb>`. Whole data jobs go to `rde`. allowed-tools: Bash(mb:*), Read, Write, Edit --- # metabase-cli Load the workflow content from the CLI: ```bash mb skills get core # start here — auth, flag conventions, every command group mb skills list # enumerate specialized skills bundled with this CLI version mb skills get <name> # load a specialized skill (transform, data-workflow, dashboard, git-sync, data-app, …) ``` Command groups, in full: authenticate with named profiles; inspect databases (list, get, full metadata rollup, schemas, tables in a schema) and trigger a manual schema sync or field-values rescan; inspect tables and fields; list/get/create/update/archive cards (questions, models, metrics) and run them as JSON/CSV/XLSX; list/get/create/update dashboards and patch dashcards; list/get/create collections and traverse the hierarchy by id, entity_id, or "root"/"trash" (with items and recursive tree); list/get/create/update/archive native query snippets, segments, and measures; author/update/run transforms and schedule transform-jobs; publish tables to the Library; create data actions; create, bundle and turn off data apps; read/update settings; search content (cards, dashboards, collections, transforms, metrics); git-sync to/from a git remote (status, dirty, import, export, branches, stash, add/remove a collection from sync). Don't drive Metabase by `curl`ing `/api/...` directly — the CLI handles auth profiles, retries, schema validation, and credential redaction. **Doing a whole job, not one command?** Higher-level data-engineering workflows — raw data to clean tables, the semantic layer, dashboards — live in the `metabase-rde` skill, which drives this CLI: ```bash npx skills add metabase/agent-skills --skill metabase-rde ``` When it is installed, follow it; it loads the bundled skills it needs.
© metabase · MIT · metabase/agent-skills