From 422c69fe6ed94dbe9e76089ef262adb1b366c1a1 Mon Sep 17 00:00:00 2001 From: Anshul Gupta Date: Sat, 14 Nov 2026 01:01:18 +0000 Subject: [PATCH 1/4] air: Point to the databricks-ai-runtime skill in air run --help `databricks air run --help` now ends its description with the command that installs the databricks-ai-runtime agent skill. The install command is a shared constant, also used by the `-h config` skill note. Co-authored-by: Isaac --- acceptance/air/config-help/output.txt | 5 +++++ cmd/air/air_test.go | 9 +++++++++ cmd/air/run.go | 7 ++++++- cmd/air/runconfig.go | 6 +++++- 4 files changed, 25 insertions(+), 2 deletions(-) diff --git a/acceptance/air/config-help/output.txt b/acceptance/air/config-help/output.txt index 1fae9e919f3..624f0c4cd24 100644 --- a/acceptance/air/config-help/output.txt +++ b/acceptance/air/config-help/output.txt @@ -11,6 +11,11 @@ field, pass its path to -h as a separate argument: databricks air run -h config.compute one section databricks air run -h config.compute.accelerator_type one field +To have a coding agent write the YAML and follow the run, install the +databricks-ai-runtime skill: + + databricks aitools install --skills-only --skills databricks-ai-runtime + Usage: databricks air run [flags] diff --git a/cmd/air/air_test.go b/cmd/air/air_test.go index 11e4546d21d..baf36932e20 100644 --- a/cmd/air/air_test.go +++ b/cmd/air/air_test.go @@ -117,3 +117,12 @@ func TestRunErrorOmitsDebugTipWhenDebugEnabled(t *testing.T) { assert.Same(t, originalErr, err) assert.NotContains(t, err.Error(), "use the --debug flag") } + +func TestRunHelpPointsToAgentSkill(t *testing.T) { + run := findSubcommand(t, New(), "run") + var out bytes.Buffer + run.SetOut(&out) + run.HelpFunc()(run, nil) + assert.Contains(t, out.String(), "databricks-ai-runtime skill") + assert.Contains(t, out.String(), " "+skillInstallCommand+"\n") +} diff --git a/cmd/air/run.go b/cmd/air/run.go index 20a7683461f..98eb8d4e022 100644 --- a/cmd/air/run.go +++ b/cmd/air/run.go @@ -97,7 +97,12 @@ field, pass its path to -h as a separate argument: databricks air run -h config all fields databricks air run -h config.compute one section - databricks air run -h config.compute.accelerator_type one field`, + databricks air run -h config.compute.accelerator_type one field + +To have a coding agent write the YAML and follow the run, install the +databricks-ai-runtime skill: + + ` + skillInstallCommand, Example: ` # Submit and stream logs until the run finishes databricks air run -f workload.yaml --watch diff --git a/cmd/air/runconfig.go b/cmd/air/runconfig.go index 78554b02183..cdb60d486e8 100644 --- a/cmd/air/runconfig.go +++ b/cmd/air/runconfig.go @@ -922,11 +922,15 @@ func renderConfigField(w io.Writer, f configField, computeOptions []computeOptio } } +// skillInstallCommand installs the databricks-ai-runtime agent skill. Help +// pages that point coding agents at the skill share it. +const skillInstallCommand = "databricks aitools install --skills-only --skills databricks-ai-runtime" + // agentSkillHelp closes `-h config`: users look up the schema while writing // YAML, which is when an agent skill that writes it for them is most useful. const agentSkillHelp = ` Let a coding agent write this YAML for you with the databricks-ai-runtime skill: - databricks aitools install --skills-only --skills databricks-ai-runtime + ` + skillInstallCommand + ` (add --scope project to install into the current project) https://github.com/databricks/databricks-agent-skills/tree/main/skills/databricks-ai-runtime ` From 86af6d1f77ecdda7596694cd120cf7cae3b54cc1 Mon Sep 17 00:00:00 2001 From: Anshul Gupta Date: Sat, 14 Nov 2026 01:01:53 +0000 Subject: [PATCH 2/4] Add changelog fragment for air run --help skill pointer Co-authored-by: Isaac --- .nextchanges/cli/air-run-help-skill.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 .nextchanges/cli/air-run-help-skill.md diff --git a/.nextchanges/cli/air-run-help-skill.md b/.nextchanges/cli/air-run-help-skill.md new file mode 100644 index 00000000000..3607a932c90 --- /dev/null +++ b/.nextchanges/cli/air-run-help-skill.md @@ -0,0 +1 @@ +* `databricks air run --help` now shows how to install the databricks-ai-runtime coding agent skill. ([#7628](https://github.com/databricks/cli/pull/7628)) From a9cf2f570dfa89998e105f37244232d7e5539cf3 Mon Sep 17 00:00:00 2001 From: Anshul Gupta Date: Sun, 15 Nov 2026 04:40:21 +0000 Subject: [PATCH 3/4] Move changelog fragment to the AI Runtime section Co-authored-by: Isaac --- .nextchanges/{cli => air}/air-run-help-skill.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename .nextchanges/{cli => air}/air-run-help-skill.md (100%) diff --git a/.nextchanges/cli/air-run-help-skill.md b/.nextchanges/air/air-run-help-skill.md similarity index 100% rename from .nextchanges/cli/air-run-help-skill.md rename to .nextchanges/air/air-run-help-skill.md From 9096e4cbe8cb3591704bc1b00dbe6e7f7d6c05d8 Mon Sep 17 00:00:00 2001 From: Anshul Gupta Date: Mon, 16 Nov 2026 04:43:22 +0000 Subject: [PATCH 4/4] Point changelog fragment at #7652 Co-authored-by: Isaac --- .nextchanges/air/air-run-help-skill.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.nextchanges/air/air-run-help-skill.md b/.nextchanges/air/air-run-help-skill.md index 3607a932c90..48caa711504 100644 --- a/.nextchanges/air/air-run-help-skill.md +++ b/.nextchanges/air/air-run-help-skill.md @@ -1 +1 @@ -* `databricks air run --help` now shows how to install the databricks-ai-runtime coding agent skill. ([#7628](https://github.com/databricks/cli/pull/7628)) +* `databricks air run --help` now shows how to install the databricks-ai-runtime coding agent skill. ([#7652](https://github.com/databricks/cli/pull/7652))