databricks-config

Configure Databricks profiles and authenticate across Connect, CLI, and SDK.

1.8k|404|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/databricks-solutions/ai-dev-kit --skill databricks-config
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: databricks-config
Source: https://github.com/databricks-solutions/ai-dev-kit/tree/main/databricks-skills/databricks-config
Command: npx skills add https://github.com/databricks-solutions/ai-dev-kit --skill databricks-config

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates configuring the Databricks profile in ~/.databrickscfg to enable seamless authentication for Databricks Connect, the Databricks CLI, and the Databricks SDK across workspaces and projects.

Core Features & Use Cases

  • Interactive and parameter-driven profile setup that creates or updates a named profile and preserves existing settings in ~/.databrickscfg.
  • Supports authenticating to a workspace host using databricks auth login and extracting a suitable profile name from the host URL.
  • Validates the resulting configuration and provides guided steps for switching between profiles when working on multiple Databricks environments.

Quick Start

  • Run /databricks-config with a profile name (e.g., DEFAULT) or a workspace host URL to configure the corresponding profile.
  • Run databricks auth login -p <profile> [--host <workspace_host>] to authenticate the profile.
  • Confirm the updated profile in ~/.databrickscfg and redact any tokens if you display the contents.

Frequently Asked Questions about databricks-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a Databricks profile for the CLI and SDK?

To configure a Databricks profile, run the configuration tool with a profile name or workspace host URL to create or update an entry in ~/.databrickscfg, then authenticate using databricks auth login. It preserves existing settings while validating the resulting configuration.

What is the best way to set up authentication across multiple Databricks workspaces?

The best way to manage multiple Databricks workspaces is creating named profiles in ~/.databrickscfg. You can preserve existing settings while adding new profiles, and use guided steps to switch between profiles for different Databricks environments.

Can I use a workspace host URL to generate a Databricks profile name?

Yes, you can use a workspace host URL to configure a Databricks profile. The setup process extracts a suitable profile name directly from the host URL and supports authenticating to the workspace using the databricks auth login command.

Does configuring Databricks Connect require updating ~/.databrickscfg manually?

Configuring Databricks Connect does not require manual ~/.databrickscfg updates. The automated workflow configures the profile, preserves existing settings, validates the resulting entry, and redacts tokens when displaying the configuration contents for security.

Why does my Databricks CLI profile configuration fail when switching environments?

Databricks CLI profile configuration may fail if existing settings conflict or tokens are invalid. The tool validates the resulting ~/.databrickscfg entry and provides guided steps for switching between profiles to ensure proper authentication across multiple Databricks environments.