From 6fc122bedbfab3fffce597c4ac60cb6ba85e8ed8 Mon Sep 17 00:00:00 2001 From: James Broadhead Date: Tue, 26 May 2026 13:53:25 +0000 Subject: [PATCH 1/3] plugin: add marketplace.json --- .claude-plugin/marketplace.json | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 .claude-plugin/marketplace.json diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json new file mode 100644 index 0000000..0661f7b --- /dev/null +++ b/.claude-plugin/marketplace.json @@ -0,0 +1,18 @@ +{ + "name": "databricks-skills", + "owner": { + "name": "Databricks" + }, + "metadata": { + "description": "Official Databricks agent skills marketplace", + "version": "0.1.0" + }, + "plugins": [ + { + "name": "databricks-skills", + "source": "./", + "description": "Databricks skills for CLI, Apps, Unity Catalog, Model Serving, Declarative Automation Bundles (DABs), and more. Stable skills only — for experimental skills use `databricks aitools install --experimental`.", + "version": "0.1.0" + } + ] +} From 17b0903504071d52ebc0dcfde639364f3f73c940 Mon Sep 17 00:00:00 2001 From: James Broadhead Date: Tue, 26 May 2026 13:53:45 +0000 Subject: [PATCH 2/3] README: document CLI vs plugin install paths --- README.md | 31 +++++++++++++++++++++++++++++-- 1 file changed, 29 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 5decb70..d47e499 100644 --- a/README.md +++ b/README.md @@ -4,11 +4,17 @@ Skills for AI coding assistants (Claude Code, Cursor, etc.) that provide Databri ## Installation +There are two equivalent install paths for the **stable** skills. Pick whichever +fits your workflow — both write skills into the per-agent directory the CLI/plugin +detects (`~/.claude/skills/`, `~/.cursor/extensions/<...>`, etc.). + +**Via the Databricks CLI (canonical; supports experimental skills):** + ```bash databricks aitools install ``` -This auto-detects your coding agent(s) and installs the stable skills to the +The CLI auto-detects your coding agent(s) and installs the stable skills to the right location: - **Claude Code** → `~/.claude/skills/` @@ -19,12 +25,33 @@ For finer control, use the `aitools skills install` subcommand directly — it accepts a positional skill name and an `--experimental` flag (see the [Experimental Skills](#experimental-skills) section). -**For Cursor (plugin marketplace alternative):** +**Via the Claude Code plugin marketplace** (stable skills only — installs every +skill under [`./skills/`](./skills/)): + +```text +/plugin marketplace add databricks/databricks-agent-skills +/plugin install databricks-skills +``` + +**Via the Cursor plugin marketplace:** ```text /add-plugin databricks-skills ``` +### CLI vs plugin marketplace + +| | CLI | Plugin marketplace | +|---|---|---| +| Stable skills | ✅ (default) | ✅ | +| Experimental skills | ✅ (with `--experimental` or by name) | ❌ | +| Per-skill selection | ✅ (`databricks aitools install `) | ❌ (all-or-nothing) | +| Updates | `databricks aitools update` | Plugin marketplace update flow | +| Required outside the agent | Databricks CLI v1.0.0+ | None | + +If in doubt, use the CLI — it's the canonical install path and the only one that +exposes experimental skills. + ## Available Skills Stable skills shipped from [`skills/`](./skills/): From 10ffa6bbabb04edae36ce7f36380d613e016ae59 Mon Sep 17 00:00:00 2001 From: James Broadhead Date: Tue, 26 May 2026 15:37:27 +0000 Subject: [PATCH 3/3] fix: correct plugin install location + canonical marketplace fields MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README: the plugin path does NOT write into `~/.claude/skills/` — it caches under `~/.claude/plugins/cache///`. Document both paths separately instead of falsely claiming they share a target. - marketplace.json: move `description`/`version` to top-level. They were accepted under `metadata` for backward compatibility, but the canonical schema spot is top-level. Co-authored-by: Isaac --- .claude-plugin/marketplace.json | 6 ++---- README.md | 11 ++++++++--- 2 files changed, 10 insertions(+), 7 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 0661f7b..a70047c 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -1,12 +1,10 @@ { "name": "databricks-skills", + "description": "Official Databricks agent skills marketplace", + "version": "0.1.0", "owner": { "name": "Databricks" }, - "metadata": { - "description": "Official Databricks agent skills marketplace", - "version": "0.1.0" - }, "plugins": [ { "name": "databricks-skills", diff --git a/README.md b/README.md index d47e499..ae41929 100644 --- a/README.md +++ b/README.md @@ -4,9 +4,14 @@ Skills for AI coding assistants (Claude Code, Cursor, etc.) that provide Databri ## Installation -There are two equivalent install paths for the **stable** skills. Pick whichever -fits your workflow — both write skills into the per-agent directory the CLI/plugin -detects (`~/.claude/skills/`, `~/.cursor/extensions/<...>`, etc.). +Two install paths cover the **stable** skills. They install to different places +but end up loaded by the same agents — pick whichever fits your workflow. + +- **Databricks CLI** writes SKILL.md files directly into each agent's skill + directory (`~/.claude/skills/`, `~/.cursor/extensions/<...>`, etc.). +- **Plugin marketplaces** (Claude Code, Cursor) cache the plugin under the + agent's plugin directory (e.g. `~/.claude/plugins/cache/databricks-skills/`); + the agent discovers skills from there. **Via the Databricks CLI (canonical; supports experimental skills):**