databricks-corelisted
Install: claude install-skill pgoell/pgoell-claude-tools
# Databricks
Core skill for Databricks CLI, authentication, and data exploration.
## Prerequisites
`databricks --version` must report `v0.292.0` or newer. Installation is the user's responsibility; if the CLI is missing, run the command anyway and let the shell's `command not found` surface the problem to the user.
**Authenticated:** `databricks auth profiles`. If empty: see [CLI Authentication](databricks-cli-auth.md).
## Profile Selection - CRITICAL
**NEVER auto-select a profile.**
1. List profiles: `databricks auth profiles`
2. Present ALL profiles to user with workspace URLs
3. Let user choose (even if only one exists)
4. Offer to create new profile if needed
## Claude Code - IMPORTANT
Each Bash command runs in a **separate shell session**.
```bash
# WORKS: --profile flag
databricks apps list --profile my-workspace
# WORKS: chained with &&
export DATABRICKS_CONFIG_PROFILE=my-workspace && databricks apps list
# DOES NOT WORK: separate commands
export DATABRICKS_CONFIG_PROFILE=my-workspace
databricks apps list # profile not set!
```
## Data Exploration: Use AI Tools
**Use these instead of manually navigating catalogs/schemas/tables:**
```bash
# discover table structure (columns, types, sample data, stats)
databricks experimental aitools tools discover-schema catalog.schema.table --profile <PROFILE>
# run ad-hoc SQL queries
databricks experimental aitools tools query "SELECT * FROM table LIMIT 10" --profile <PROFILE>
# find the default warehouse
databricks