Merge pull request #29 from metabase/workspace-skill-cli

workspace cli skill

Author: alxnddr

README.md

@@ -20,6 +20,14 @@ npx skills add metabase/agent-skills --skill metabase-modular-embedding-version-
 
 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.
 
+### CLI
+
+[metabase-cli](./skills/metabase-cli/SKILL.md)
+
+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`](https://www.npmjs.com/package/@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.
+
 ### Database metadata
 
 [metabase-database-metadata](./skills/metabase-database-metadata/SKILL.md)

skills/metabase-cli/README.md

@@ -0,0 +1,23 @@
+# metabase-cli (skill)
+
+Discovery stub for the [`@metabase/cli`](https://www.npmjs.com/package/@metabase/cli) skill bundle. The agent loads workflow content at runtime via `mb skills get`, so instructions always match the installed CLI version.
+
+## Install
+
+```bash
+npm i -g @metabase/cli                                                # CLI itself
+npx skills add metabase/agent-skills --skill metabase-cli             # this stub
+```
+
+Or, in Claude Code, install both the stub and the marketplace entry directly from the CLI repo:
+
+```
+/plugin marketplace add metabase/mb-cli
+/plugin install metabase-cli@metabase
+```
+
+One install path is enough — both resolve to the same `mb skills get` runtime fetch.
+
+## Files
+
+- `SKILL.md` — frontmatter (trigger phrases) + a redirect at `mb skills get core`.

skills/metabase-cli/SKILL.md

@@ -0,0 +1,17 @@
+---
+name: metabase-cli
+description: Drive a Metabase instance from the terminal via the `mb` CLI. Authenticate with named profiles; inspect databases (list, get, full metadata rollup, schemas, tables in a schema) and trigger manual schema sync / field-values rescan; inspect tables, 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; read/update settings; search content (cards, dashboards, collections, transforms, metrics); manage Enterprise workspaces; git-sync to/from a git remote (status, dirty, import, export, branches, stash, add/remove a collection from sync). Use whenever the user wants to interact with a Metabase 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", "spin up a workspace", "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 anything hitting `mb <verb>`.
+allowed-tools: Bash(mb:*), Read, Write, Edit, AskUserQuestion
+---
+
+# 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 (workspace, transform, git-sync, …)
+```
+
+Don't drive Metabase by `curl`ing `/api/...` directly — the CLI handles auth profiles, retries, schema validation, and credential redaction.