From b0a0c58d170611f381ad868085fe5f0ebf124283 Mon Sep 17 00:00:00 2001 From: "ben.hansen" Date: Thu, 12 Nov 2026 20:01:50 +0000 Subject: [PATCH 1/3] [CNXT-2519] Clarify custom skill installation paths --- cmd/aitools/install.go | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/cmd/aitools/install.go b/cmd/aitools/install.go index b050ec7bac0..8d335ef0181 100644 --- a/cmd/aitools/install.go +++ b/cmd/aitools/install.go @@ -93,9 +93,10 @@ By default this installs the databricks plugin through each agent's own CLI (` + strings.Join(agents.SkillsOnlyNames(), ", ") + `) get raw skill files. Escape hatches: - --skills-only Force raw skill files for every agent (no plugin). + --skills-only Force raw skill files for every agent (no plugin; not with --path). --skills name1,name2 Install only the named skills (with --skills-only/--path). --path Write resolved skill files to a directory (no agents, no state). + Use instead of --skills-only when choosing an output directory. Agent selection: --agents [,...] Act only on the named agents (works for undetected ones). @@ -107,6 +108,11 @@ Output: and --agents so the command runs without interactive prompts. Supported agents: ` + strings.Join(agents.SupportedNames(), ", "), + Example: ` # Install a selected skill for coding agents. + databricks aitools install --skills-only --skills databricks-ai-runtime --experimental + + # Write a selected skill to a custom directory (omit --skills-only). + databricks aitools install --skills databricks-ai-runtime --experimental --path ./skills`, Args: cobra.NoArgs, RunE: func(cmd *cobra.Command, args []string) (err error) { ctx := cmd.Context() @@ -309,8 +315,8 @@ Supported agents: ` + strings.Join(agents.SupportedNames(), ", "), cmd.Flags().StringVar(&skillsFlag, "skills", "", "Specific skills to install (comma-separated)") cmd.Flags().StringVar(&agentsFlag, "agents", "", "Agents to install for (comma-separated, e.g. claude-code,cursor)") cmd.Flags().BoolVar(&includeExperimental, "experimental", false, "Include experimental skills") - cmd.Flags().BoolVar(&skillsOnly, "skills-only", false, "Force raw skill files for every agent instead of the plugin") - cmd.Flags().StringVar(&pathFlag, "path", "", "Write resolved skill files to this directory (no agents, no state)") + cmd.Flags().BoolVar(&skillsOnly, "skills-only", false, "Force raw skill files for every agent instead of the plugin (not with --path)") + cmd.Flags().StringVar(&pathFlag, "path", "", "Write resolved skill files to this directory instead of using --skills-only (no agents, no state)") cmd.Flags().StringVar(&scopeFlag, "scope", "", "Install scope: project or global (default: global, or prompt when interactive)") cmd.Flags().BoolVar(&projectFlag, "project", false, "Install to project directory (cwd)") cmd.Flags().BoolVar(&globalFlag, "global", false, "Install globally (default)") From 1df02a8a7ebcce09b3148ca84dc08871704921a7 Mon Sep 17 00:00:00 2001 From: "ben.hansen" Date: Thu, 12 Nov 2026 20:02:23 +0000 Subject: [PATCH 2/3] Add release note --- .nextchanges/cli/aitools-install-path-help.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 .nextchanges/cli/aitools-install-path-help.md diff --git a/.nextchanges/cli/aitools-install-path-help.md b/.nextchanges/cli/aitools-install-path-help.md new file mode 100644 index 00000000000..57409607186 --- /dev/null +++ b/.nextchanges/cli/aitools-install-path-help.md @@ -0,0 +1 @@ +* Clarify how to install selected skills to a custom directory. ([#7572](https://github.com/databricks/cli/pull/7572)) From a4533588816dcf4624d3152dd3b6b46b0411c78b Mon Sep 17 00:00:00 2001 From: "ben.hansen" Date: Thu, 12 Nov 2026 23:42:24 +0000 Subject: [PATCH 3/3] Address install help review feedback --- cmd/aitools/install.go | 5 ++--- cmd/aitools/legacy_skills.go | 2 +- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/cmd/aitools/install.go b/cmd/aitools/install.go index 8d335ef0181..63d6efbde33 100644 --- a/cmd/aitools/install.go +++ b/cmd/aitools/install.go @@ -96,7 +96,6 @@ Escape hatches: --skills-only Force raw skill files for every agent (no plugin; not with --path). --skills name1,name2 Install only the named skills (with --skills-only/--path). --path Write resolved skill files to a directory (no agents, no state). - Use instead of --skills-only when choosing an output directory. Agent selection: --agents [,...] Act only on the named agents (works for undetected ones). @@ -109,10 +108,10 @@ Output: Supported agents: ` + strings.Join(agents.SupportedNames(), ", "), Example: ` # Install a selected skill for coding agents. - databricks aitools install --skills-only --skills databricks-ai-runtime --experimental + databricks aitools install --skills-only --skills databricks-ai-runtime # Write a selected skill to a custom directory (omit --skills-only). - databricks aitools install --skills databricks-ai-runtime --experimental --path ./skills`, + databricks aitools install --skills databricks-ai-runtime --path ./skills`, Args: cobra.NoArgs, RunE: func(cmd *cobra.Command, args []string) (err error) { ctx := cmd.Context() diff --git a/cmd/aitools/legacy_skills.go b/cmd/aitools/legacy_skills.go index 67ed8854dea..e0838e7dbae 100644 --- a/cmd/aitools/legacy_skills.go +++ b/cmd/aitools/legacy_skills.go @@ -39,7 +39,7 @@ func newLegacySkillsInstallCmd() *cobra.Command { cmd := &cobra.Command{ Use: "install [skill-name]", Short: "Install Databricks skills for detected coding agents", - Deprecated: `use "databricks aitools install --skills " instead.`, + Deprecated: `use "databricks aitools install --skills-only --skills " instead.`, Args: cobra.MaximumNArgs(1), RunE: func(cmd *cobra.Command, args []string) error { installCmd := NewInstallCmd()