Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .nextchanges/cli/aitools-install-path-help.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
* Clarify how to install selected skills to a custom directory. ([#7572](https://github.com/databricks/cli/pull/7572))
11 changes: 8 additions & 3 deletions cmd/aitools/install.go
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ 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 <dir> Write resolved skill files to a directory (no agents, no state).

Expand All @@ -107,6 +107,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

# Write a selected skill to a custom directory (omit --skills-only).
databricks aitools install --skills databricks-ai-runtime --path ./skills`,
Args: cobra.NoArgs,
RunE: func(cmd *cobra.Command, args []string) (err error) {
ctx := cmd.Context()
Expand Down Expand Up @@ -309,8 +314,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)")
Expand Down
2 changes: 1 addition & 1 deletion cmd/aitools/legacy_skills.go
Original file line number Diff line number Diff line change
Expand Up @@ -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 <name>" instead.`,
Deprecated: `use "databricks aitools install --skills-only --skills <name>" instead.`,
Args: cobra.MaximumNArgs(1),
RunE: func(cmd *cobra.Command, args []string) error {
installCmd := NewInstallCmd()
Expand Down
Loading