From bdbe3b01c5c0838d9f7181f0b4eafea9e47b292a Mon Sep 17 00:00:00 2001 From: Anshul Gupta Date: Sat, 14 Nov 2026 01:01:18 +0000 Subject: [PATCH 1/3] 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 6df7a0a998c5ac5457755461e3a2568986964b56 Mon Sep 17 00:00:00 2001 From: Anshul Gupta Date: Sat, 14 Nov 2026 01:01:53 +0000 Subject: [PATCH 2/3] 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 f5a0a06a7a1daa3034b6ce858a6efbc93f40155c Mon Sep 17 00:00:00 2001 From: Anshul Gupta Date: Sun, 15 Nov 2026 04:40:21 +0000 Subject: [PATCH 3/3] 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