Agent skills for Metabase

A collection of agent skills for working with your Metabase. These skills are built for Claude Code but may also work with other AI coding agents (Cursor, Windsurf, etc.). They help perform complex Metabase embedding migrations and upgrades, explore data models, and create Metabase content automatically.

Installation

Install all skills at once:

npx skills add metabase/agent-skills -a claude-code

Or install a specific skill:

npx skills add metabase/agent-skills --skill metabase-modular-embedding-version-upgrade -a claude-code

Skills

Always review and validate the changes made by a skill. Depending on your application's complexity, a skill may not work properly in all cases. Check that your application builds, tests pass, and the embedding works as expected before committing.

AI governance checklist

ai-governance-checklist

A task-completion coach for rolling out AI analytics without giving up control — who can use Metabot, what it can see, how much it costs, where the model runs, and the audit trail — adapted to whether you're an admin and what plan you're on.

AI readiness checklist

ai-readiness-checklist

A task-completion coach for getting Metabase data ready for Metabot and the Metabase MCP server — modeling, context, metrics, canonical sources, verification, and turning AI on everywhere — adapted to whether you're an admin and what plan you're on.

CLI

metabase-cli

Drives a Metabase instance from the terminal via the official mb CLI — every Metabase resource through one command surface.

This skill is a thin discovery stub; the workflow content lives in @metabase/cli and is served at runtime by mb skills get. Install the CLI (npm i -g @metabase/cli) and the skill resolves the rest. The same skill is also available as a Claude Code plugin direct from the CLI repo (/plugin marketplace add metabase/mb-cli + /plugin install metabase-cli@metabase); one install path is enough.

Custom visualizations

metabase-custom-viz

Build Metabase custom visualizations with @metabase/custom-viz: scaffold a project, turn a request into a working visualization, iterate on it against a local Metabase, debug sandbox and rendering issues, and package the .tgz for upload. The skill reads the sandbox rules, color names and column type predicates straight from the Metabase source on GitHub, at the tag the installed @metabase/custom-viz was released from. v1 is the skill's own version, independent of the SDK's: a change that breaks how the skill is used gets a new folder (v2, ...) and the old one stays.

Data engineering router

metabase-rde

An expert data-engineering workflow with Metabase at the center of whatever stack a company runs: explore and profile raw warehouse tables, build clean layered tables as Metabase transforms, build the semantic layer (models, metrics, measures, segments, metadata), design dashboards, answer questions with checked numbers, and reconcile results against a reference. A router loads one playbook and the few reference files a job needs; a data app goes through its references/data-apps.md, which limits what the app reads to the Library and, in staging, ships it through remote sync, then hands the build to the mb CLI's data-app skills. Requires the mb CLI (npm i -g @metabase/cli); it loads the CLI's bundled skills for every Metabase mechanic, data apps included.

Database metadata

metabase-database-metadata

Retrieves and caches database metadata (databases, tables, fields, field values) from a Metabase instance for understanding the data model.

Marketplace links: skillsmp.com | skills.sh

Embedding SSO implementation

metabase-embedding-sso-implementation

Helps implement JWT SSO authentication for Metabase embedding, including the signing endpoint, frontend auth layer, and group mappings.

Marketplace links: skillsmp.com | skills.sh

Full app to modular embedding upgrade

metabase-full-app-to-modular-embedding-upgrade

Helps migrate from Metabase Full App / Interactive (iframe-based) embedding to Modular embedding (web components via embed.js).

Marketplace links: skillsmp.com | skills.sh

Learn Metabase with your own data

metabase-learning

Learn the ins and outs of Metabase, with quizzes and optionally your own data (through the Metabase MCP server).

Modular embedding to modular embedding SDK upgrade

metabase-modular-embedding-to-modular-embedding-sdk-upgrade

Helps migrate from Metabase Modular embedding (web components via embed.js) to the Modular embedding SDK (@metabase/embedding-sdk-react).

Marketplace links: skillsmp.com | skills.sh

Modular embedding version upgrade

metabase-modular-embedding-version-upgrade

Helps upgrade a project's Modular embedding SDK (@metabase/embedding-sdk-react) or Modular embedding (web components via embed.js) to a newer version.

Marketplace links: skillsmp.com | skills.sh

Representation format

metabase-representation-format

Understands the Metabase Representation Format — a YAML-based serialization format for Metabase content (collections, cards, dashboards, documents, segments, measures, snippets, transforms).

Marketplace links: skillsmp.com | skills.sh

Static embedding to guest embedding upgrade

metabase-static-embedding-to-guest-embedding-upgrade

Helps migrate from Metabase Static embedding (signed embed iframes) to Guest embeds (web components via embed.js).

Marketplace links: skillsmp.com | skills.sh