From 457073938c5301afa4563462c43f191d2817daf7 Mon Sep 17 00:00:00 2001 From: James Broadhead Date: Wed, 27 May 2026 23:09:57 +0000 Subject: [PATCH] docs: note ai-dev-kit deprecation in README + experimental/README MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ai-dev-kit (databricks-solutions/ai-dev-kit) was the historical upstream for experimental/ skills. It is now deprecated; databricks/databricks-agent-skills is the source of truth and updates land here directly rather than via re-sync from a-d-k. - README.md "Experimental Skills" — clarify "originally imported" rather than "imported", and call out that a-d-k is deprecated. - experimental/README.md — same framing in the top warning; drop the "out of date relative to upstream ai-dev-kit" bullet (no longer the failure mode), and redirect issue-filing away from a-d-k. This PR was prepared by Claude. --- README.md | 6 ++++-- experimental/README.md | 12 +++++++----- 2 files changed, 11 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index d0d5caa..d373598 100644 --- a/README.md +++ b/README.md @@ -73,8 +73,10 @@ Stable skills shipped from [`skills/`](./skills/): ## Experimental Skills The [`experimental/`](./experimental/) directory contains additional skills -imported from [databricks-solutions/ai-dev-kit](https://github.com/databricks-solutions/ai-dev-kit) -on a **best-effort basis**. +originally imported from +[databricks-solutions/ai-dev-kit](https://github.com/databricks-solutions/ai-dev-kit) +(now deprecated — this repo is the source of truth going forward) on a +**best-effort basis**. - Experimental skills are **not officially supported** — they may be used, but do not follow the same review / quality bar as the stable skills under diff --git a/experimental/README.md b/experimental/README.md index f56cdda..a60c414 100644 --- a/experimental/README.md +++ b/experimental/README.md @@ -1,18 +1,20 @@ > ⚠️ **Experimental: best-effort, not officially supported** > -> The skills in this directory are imported from +> The skills in this directory were originally imported from > [databricks-solutions/ai-dev-kit](https://github.com/databricks-solutions/ai-dev-kit) -> on a best-effort basis. They may be useful, but they are **not officially -> supported** as part of `databricks-agent-skills`: +> on a best-effort basis. **`ai-dev-kit` is now deprecated** — +> `databricks/databricks-agent-skills` is the canonical home for these skills +> going forward, and updates land here directly rather than via re-sync. +> +> They are still **not officially supported** as part of `databricks-agent-skills`: > > - They do not follow the same review / quality bar as the skills in > [`../skills/`](../skills/). -> - They may be out of date relative to upstream `ai-dev-kit`. > - They are not installed by `databricks aitools install` by default — > you have to opt in (see the root README). > > File issues against this directory in this repo; do not file issues against -> `ai-dev-kit` for skills installed via `databricks-agent-skills`. +> the deprecated `ai-dev-kit` repo. ---