From 69bfe2230bea197781166a1d642395471ee9ed4e Mon Sep 17 00:00:00 2001 From: Anshul Gupta Date: Mon, 16 Nov 2026 07:56:28 +0000 Subject: [PATCH 1/2] aitools install: print the directory skills were installed into The summary said only "Installed 1 skill.", so an agent that wanted to read the new SKILL.md searched the filesystem for it; one ran `find /` until a 120s timeout. Name the skills directory in the summary. Co-authored-by: Isaac --- .nextchanges/cli/aitools-install-print-path.md | 1 + .../cmd/aitools/install-host-metadata/output.txt | 2 +- .../cmd/aitools/telemetry/install/output.txt | 6 +++--- .../telemetry/workspace-unreachable/output.txt | 2 +- .../skills/install-experimental-empty/output.txt | 2 +- .../skills/install-non-interactive/output.txt | 8 ++++---- .../aitools/skills/install-specific/output.txt | 4 ++-- .../aitools/skills/install/output.txt | 6 +++--- .../aitools/skills/update-prune/output.txt | 2 +- libs/aitools/installer/installer.go | 4 +++- libs/aitools/installer/installer_test.go | 16 ++++++++-------- 11 files changed, 28 insertions(+), 25 deletions(-) create mode 100644 .nextchanges/cli/aitools-install-print-path.md diff --git a/.nextchanges/cli/aitools-install-print-path.md b/.nextchanges/cli/aitools-install-print-path.md new file mode 100644 index 00000000000..220d79e0d83 --- /dev/null +++ b/.nextchanges/cli/aitools-install-print-path.md @@ -0,0 +1 @@ +* `databricks aitools install` now prints the directory it installed skills into (for example `Installed 1 skill in ~/.databricks/aitools/skills.`), so agents can open the installed `SKILL.md` files without searching for them. diff --git a/acceptance/cmd/aitools/install-host-metadata/output.txt b/acceptance/cmd/aitools/install-host-metadata/output.txt index 6bf0804fd1e..ca06a884d7a 100644 --- a/acceptance/cmd/aitools/install-host-metadata/output.txt +++ b/acceptance/cmd/aitools/install-host-metadata/output.txt @@ -5,6 +5,6 @@ Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. === --debug still shows the hostmetadata line, at debug level diff --git a/acceptance/cmd/aitools/telemetry/install/output.txt b/acceptance/cmd/aitools/telemetry/install/output.txt index dd509504411..5f9ca2853a4 100644 --- a/acceptance/cmd/aitools/telemetry/install/output.txt +++ b/acceptance/cmd/aitools/telemetry/install/output.txt @@ -5,7 +5,7 @@ Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. >>> print_telemetry {"command":"aitools_install","exit_code":0,"aitools_command_event":{"command":"INSTALL","stage":"STARTED","interactive":false,"install_mode":"SKILLS_ONLY"}} @@ -23,7 +23,7 @@ Installed 1 skill. Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. >>> print_telemetry {"command":"aitools_install","exit_code":0,"aitools_command_event":{"command":"INSTALL","stage":"STARTED","interactive":false,"install_mode":"SKILLS_ONLY"}} @@ -41,7 +41,7 @@ Installed 1 skill. Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. >>> print_requests.py //oidc/v1/token //telemetry-ext diff --git a/acceptance/cmd/aitools/telemetry/workspace-unreachable/output.txt b/acceptance/cmd/aitools/telemetry/workspace-unreachable/output.txt index a967a32a8c5..cb4d465e06d 100644 --- a/acceptance/cmd/aitools/telemetry/workspace-unreachable/output.txt +++ b/acceptance/cmd/aitools/telemetry/workspace-unreachable/output.txt @@ -5,7 +5,7 @@ Installing Databricks skills for Cursor... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. === update: the background auth resolution prints nothing diff --git a/acceptance/experimental/aitools/skills/install-experimental-empty/output.txt b/acceptance/experimental/aitools/skills/install-experimental-empty/output.txt index efdd0fb44ae..be035d18186 100644 --- a/acceptance/experimental/aitools/skills/install-experimental-empty/output.txt +++ b/acceptance/experimental/aitools/skills/install-experimental-empty/output.txt @@ -8,4 +8,4 @@ Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... Warn: --experimental was set but the manifest at test-ref exposes no experimental skills. Set DATABRICKS_SKILLS_REF to a release or ref that includes them. -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. diff --git a/acceptance/experimental/aitools/skills/install-non-interactive/output.txt b/acceptance/experimental/aitools/skills/install-non-interactive/output.txt index 449731b1b16..0bb5d48e863 100644 --- a/acceptance/experimental/aitools/skills/install-non-interactive/output.txt +++ b/acceptance/experimental/aitools/skills/install-non-interactive/output.txt @@ -6,7 +6,7 @@ Skipped the plugin for Claude Code: 'claude' is not on PATH. Installing skill fi Installing Databricks skills for Claude Code, Cursor... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. Claude Code has skill files === a plugin installed with Claude Code itself is kept, without skill files next to it @@ -16,7 +16,7 @@ Claude Code already has the databricks plugin; it was not refreshed because 'cla Installing Databricks skills for Cursor... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. Claude Code has no skill files >>> [CLI] aitools update --force @@ -38,7 +38,7 @@ Error: Claude Code: 'claude' is not on PATH Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. === project scope: a personal plugin does not replace the project's skill files @@ -47,7 +47,7 @@ Skipped the plugin for Claude Code: 'claude' is not on PATH. Installing skill fi Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/project/.databricks/aitools/skills. Skipped Cursor: does not support project-scoped skills To set up Cursor in the global scope, run: databricks aitools install --scope=global --agents=cursor diff --git a/acceptance/experimental/aitools/skills/install-specific/output.txt b/acceptance/experimental/aitools/skills/install-specific/output.txt index 03283c3f0d8..d15ffddfa69 100644 --- a/acceptance/experimental/aitools/skills/install-specific/output.txt +++ b/acceptance/experimental/aitools/skills/install-specific/output.txt @@ -7,7 +7,7 @@ Flag --global has been deprecated, use --scope=global Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. === install a specific experimental skill @@ -17,7 +17,7 @@ Flag --global has been deprecated, use --scope=global Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. === asking for an experimental skill without --experimental flag errors out diff --git a/acceptance/experimental/aitools/skills/install/output.txt b/acceptance/experimental/aitools/skills/install/output.txt index 82518161868..e3244ee5805 100644 --- a/acceptance/experimental/aitools/skills/install/output.txt +++ b/acceptance/experimental/aitools/skills/install/output.txt @@ -7,7 +7,7 @@ Flag --global has been deprecated, use --scope=global Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... -Installed 1 skill. +Installed 1 skill in [TEST_TMP_DIR]/home/.databricks/aitools/skills. === re-run with --experimental installs the experimental one too @@ -17,7 +17,7 @@ Flag --global has been deprecated, use --scope=global Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... -Installed 2 skills. +Installed 2 skills in [TEST_TMP_DIR]/home/.databricks/aitools/skills. === no-op re-run is idempotent (no new fetches, no errors) @@ -27,4 +27,4 @@ Flag --global has been deprecated, use --scope=global Installing Databricks skills for Claude Code... Using skills version test-ref Fetching skills manifest... -Installed 2 skills. +Installed 2 skills in [TEST_TMP_DIR]/home/.databricks/aitools/skills. diff --git a/acceptance/experimental/aitools/skills/update-prune/output.txt b/acceptance/experimental/aitools/skills/update-prune/output.txt index b777b02b3fa..f2d53e88c2d 100644 --- a/acceptance/experimental/aitools/skills/update-prune/output.txt +++ b/acceptance/experimental/aitools/skills/update-prune/output.txt @@ -7,7 +7,7 @@ Flag --global has been deprecated, use --scope=global Installing Databricks skills for Cursor... Using skills version test-ref Fetching skills manifest... -Installed 2 skills. +Installed 2 skills in [TEST_TMP_DIR]/home/.databricks/aitools/skills. === update against a release where beta is gone: alpha updates, beta is pruned diff --git a/libs/aitools/installer/installer.go b/libs/aitools/installer/installer.go index fa30d4537ec..6b2c797ac5d 100644 --- a/libs/aitools/installer/installer.go +++ b/libs/aitools/installer/installer.go @@ -487,7 +487,9 @@ func InstallSkillsForAgents(ctx context.Context, src ManifestSource, targetAgent if len(targetSkills) == 1 { noun = "skill" } - cmdio.LogProgress(ctx, fmt.Sprintf("Installed %d %s.", len(targetSkills), noun)) + // Name the directory so an agent can open the installed SKILL.md files + // instead of searching the filesystem for them. + cmdio.LogProgress(ctx, fmt.Sprintf("Installed %d %s in %s.", len(targetSkills), noun, filepath.ToSlash(baseDir))) return nil } diff --git a/libs/aitools/installer/installer_test.go b/libs/aitools/installer/installer_test.go index 959029d23c6..2f7cdcd85e7 100644 --- a/libs/aitools/installer/installer_test.go +++ b/libs/aitools/installer/installer_test.go @@ -457,7 +457,7 @@ func TestInstallSkillsForAgentsWritesState(t *testing.T) { // non-interactive test, so only these plain lines remain. assert.Contains(t, stderr.String(), "Using skills version") assert.Contains(t, stderr.String(), "Fetching skills manifest...") - assert.Contains(t, stderr.String(), "Installed 2 skills.") + assert.Contains(t, stderr.String(), "Installed 2 skills in ") } func setupSkillsFallback(t *testing.T, latestErr error) (ManifestSource, string) { @@ -782,7 +782,7 @@ func TestInstallSkillForSingleWritesState(t *testing.T) { assert.Len(t, state.Skills, 1) assert.Equal(t, "0.1.0", state.Skills["databricks-sql"]) - assert.Contains(t, stderr.String(), "Installed 1 skill.") + assert.Contains(t, stderr.String(), "Installed 1 skill in ") } func TestInstallSkillsSpecificNotFound(t *testing.T) { @@ -827,7 +827,7 @@ func TestExperimentalSkillsSkippedByDefault(t *testing.T) { assert.Len(t, state.Skills, 2) assert.NotContains(t, state.Skills, "databricks-iceberg") - assert.Contains(t, stderr.String(), "Installed 2 skills.") + assert.Contains(t, stderr.String(), "Installed 2 skills in ") } func TestExperimentalSkillsIncludedWithFlag(t *testing.T) { @@ -858,7 +858,7 @@ func TestExperimentalSkillsIncludedWithFlag(t *testing.T) { assert.Contains(t, state.Skills, "databricks-iceberg") assert.True(t, state.IncludeExperimental) - assert.Contains(t, stderr.String(), "Installed 3 skills.") + assert.Contains(t, stderr.String(), "Installed 3 skills in ") } func TestMinCLIVersionSkipWithWarningForInstallAll(t *testing.T) { @@ -893,7 +893,7 @@ func TestMinCLIVersionSkipWithWarningForInstallAll(t *testing.T) { assert.Len(t, state.Skills, 2) assert.NotContains(t, state.Skills, "databricks-future") - assert.Contains(t, stderr.String(), "Installed 2 skills.") + assert.Contains(t, stderr.String(), "Installed 2 skills in ") assert.Contains(t, logBuf.String(), "requires CLI version 0.300.0") } @@ -1105,7 +1105,7 @@ func TestLegacyFullInstallAllowed(t *testing.T) { err := InstallSkillsForAgents(ctx, src, []*agents.Agent{agent}, InstallOptions{}) require.NoError(t, err) - assert.Contains(t, stderr.String(), "Installed 2 skills.") + assert.Contains(t, stderr.String(), "Installed 2 skills in ") state, err := LoadState(globalDir) require.NoError(t, err) @@ -1190,7 +1190,7 @@ func TestInstallProjectScopeWritesState(t *testing.T) { assert.Equal(t, testSkillsRef, state.Release) assert.Len(t, state.Skills, 2) - assert.Contains(t, stderr.String(), "Installed 2 skills.") + assert.Contains(t, stderr.String(), "Installed 2 skills in "+filepath.ToSlash(projectSkillsDir)+".") } func TestInstallProjectScopeCreatesSymlinks(t *testing.T) { @@ -1261,7 +1261,7 @@ func TestInstallProjectScopeFiltersIncompatibleAgents(t *testing.T) { require.NoError(t, err) assert.Contains(t, stderr.String(), "Skipped No Project Agent: does not support project-scoped skills.") - assert.Contains(t, stderr.String(), "Installed 2 skills.") + assert.Contains(t, stderr.String(), "Installed 2 skills in ") } func TestInstallProjectScopeZeroCompatibleAgentsReturnsError(t *testing.T) { From e927d1833c17b096649a45e26d15780ab1ef23b6 Mon Sep 17 00:00:00 2001 From: Anshul Gupta Date: Mon, 16 Nov 2026 07:57:23 +0000 Subject: [PATCH 2/2] Add PR link to changelog fragment Co-authored-by: Isaac --- .nextchanges/cli/aitools-install-print-path.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.nextchanges/cli/aitools-install-print-path.md b/.nextchanges/cli/aitools-install-print-path.md index 220d79e0d83..0bed864e6b3 100644 --- a/.nextchanges/cli/aitools-install-print-path.md +++ b/.nextchanges/cli/aitools-install-print-path.md @@ -1 +1 @@ -* `databricks aitools install` now prints the directory it installed skills into (for example `Installed 1 skill in ~/.databricks/aitools/skills.`), so agents can open the installed `SKILL.md` files without searching for them. +* `databricks aitools install` now prints the directory it installed skills into (for example `Installed 1 skill in ~/.databricks/aitools/skills.`), so agents can open the installed `SKILL.md` files without searching for them. ([#7668](https://github.com/databricks/cli/pull/7668))