Claude-skill-registry databricks-config

Configure Databricks profile and authenticate for Databricks Connect, Databricks CLI, and Databricks SDK.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/databricks-config" ~/.claude/skills/majiayu000-claude-skill-registry-databricks-config && rm -rf "$T"
manifest: skills/data/databricks-config/SKILL.md
source content

Configure the Databricks profile in ~/.databrickscfg for use with Databricks Connect.

Usage:

/databricks-config [profile_name|workspace_host]

Examples:

  • /databricks-config
    - Configure DEFAULT profile (interactive)
  • /databricks-config DEFAULT
    - Configure DEFAULT profile
  • /databricks-config my-workspace
    - Configure profile named "my-workspace"
  • /databricks-config https://adb-1234567890123456.7.azuredatabricks.net/
    - Configure using workspace host URL

Task

  1. Determine the profile and host:

    • If a parameter is provided and it starts with
      https://
      , treat it as a workspace host:
      • Extract profile name from the host (e.g.,
        adb-1234567890123456.7.azuredatabricks.net
        adb-1234567890123456
        ,
        my-company-dev.cloud.databricks.com
        my-company-dev
        )
      • Use this as the profile name and configure it with the provided host
    • If a parameter is provided and it doesn't start with
      https://
      , treat it as a profile name
    • If no parameter is provided, ask the user which profile they want to configure (default: DEFAULT)
  2. Run

    databricks auth login -p <profile>
    with the determined profile name

    • If a workspace host was provided, add
      --host <workspace_host>
      to the command
    • This ensures authentication is completed and the profile works
  3. Check if the profile exists in ~/.databrickscfg

  4. Ask the user to choose ONE of the following compute options:

    • Cluster ID: Provide a specific cluster ID for an interactive/all-purpose cluster
    • Serverless: Use serverless compute (sets
      serverless_compute_id = auto
      )
  5. Update the profile in ~/.databrickscfg with the selected configuration

  6. Verify the configuration by displaying the updated profile section

Important Notes

  • Use the AskUserQuestion tool to present the compute options as a choice
  • Only add ONE of:
    cluster_id
    OR
    serverless_compute_id
    (never both)
  • For serverless, set
    serverless_compute_id = auto
    (not just
    serverless = true
    )
  • Preserve all existing settings in the profile (host, auth_type, etc.)
  • Format the configuration file consistently with proper spacing
  • The
    databricks auth login
    command will open a browser for OAuth authentication
  • SECURITY: NEVER print token values in plain text
    • When displaying configuration, redact any
      token
      field values (e.g.,
      token = [REDACTED]
      )
    • Inform the user they can view the full configuration at
      ~/.databrickscfg
    • This applies to any output showing the profile configuration

Example Configurations

With Cluster ID:

[DEFAULT]
host       = https://adb-123456789.11.azuredatabricks.net/
cluster_id = 1217-064531-c9c3ngyn
auth_type  = databricks-cli

With Serverless:

[DEFAULT]
host                  = https://adb-123456789.11.azuredatabricks.net/
serverless_compute_id = auto
auth_type             = databricks-cli

With Token (display as redacted):

[DEFAULT]
host       = https://adb-123456789.11.azuredatabricks.net/
token      = [REDACTED]
cluster_id = 1217-064531-c9c3ngyn

View full configuration at: ~/.databrickscfg