skills.rest
ThomazRossito
ThomazRossitoCOMMUNITY
Explore all skills by this author →
Website𝕏@thomazrossitoGitHub

databricks-core

Configure Databricks CLI authentication, profiles, and data exploration commands.

4|1|Updated May 22, 2026
Search Tags:#authentication#SQL#oauth#cli#data exploration#databricks#Unity Catalog
One-click install
npx skills add https://github.com/ThomazRossito/ai-data-agents --skill databricks-core-thomazrossito
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: databricks-core
Source: https://github.com/ThomazRossito/ai-data-agents/tree/main/plugins/ai-data-agents/skills/databricks-core
Command: npx skills add https://github.com/ThomazRossito/ai-data-agents --skill databricks-core-thomazrossito

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with the Databricks CLI requires correct installation, OAuth authentication, and profile management across multiple workspaces, and mistakes like wrong profile selection or invalid command flags cause confusing errors. This Skill provides the entry-point guidance for all Databricks CLI tasks so commands run against the right workspace the first time. ## Core Features & Use Cases - CLI Installation & Authentication: Guides installation of the Databricks CLI (>= v0.292.0) on macOS, Windows, and Linux, and sets up OAuth2 profiles with descriptive names. - Profile & Workspace Management: Lists all configured profiles, lets the user explicitly choose a workspace, and handles Claude Code's separate-shell behavior with --profile flags. - Data Exploration via AI Tools: Runs schema discovery and ad-hoc SQL queries through databricks experimental aitools tools, with correct Unity Catalog identifier quoting rules. - Use Case: You need to query a table in the hello-world catalog. The Skill authenticates with the right profile, discovers the schema, and runs a properly backtick-quoted SQL query against the default warehouse. ## Quick Start Use the databricks-core skill to authenticate to my Databricks workspace and list the available catalogs and tables.

Frequently Asked Questions about databricks-core

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

FAQPage Schema
How do I authenticate the Databricks CLI with OAuth?▼

Run `databricks auth login --host <workspace-url> --profile <profile-name>` to authenticate with OAuth2. Always use a descriptive profile name rather than DEFAULT, and never use Personal Access Tokens unless explicitly required.

How to run SQL queries from the Databricks CLI?▼

Use `databricks experimental aitools tools query "SELECT ..." --profile <PROFILE>` to execute SQL against an auto-detected SQL warehouse. Set DATABRICKS_WAREHOUSE_ID to target a specific warehouse.

Why does my Databricks CLI command ignore the profile I exported?▼

In Claude Code each Bash command runs in a separate shell, so exported environment variables do not persist. Use the --profile flag on every command, or chain export and command together with &&.

Does Databricks CLI support catalog names with hyphens?▼

Yes, hyphens are valid in Unity Catalog names, but in SQL you must backtick-quote the identifier part, such as `hello-world`.demo.items. Never normalize a hyphen to an underscore, since that references a different catalog.

What Databricks CLI version is required for these commands?▼

The skill requires Databricks CLI version 0.292.0 or higher. Check your version with `databricks --version`, and if it is missing or outdated, install via Homebrew, WinGet, or the curl install script before proceeding.

Why does databricks schemas list --catalog-name fail?▼

Unity Catalog commands use positional arguments, not flags. The correct form is `databricks schemas list <CATALOG> --profile <PROFILE>`; flags like --catalog-name do not exist and will fail.

Related Skills

Explore More Data & Analytics Skills→
rbutinarrbutinar

databricks-run

Execute Databricks Notebooks and Jobs on clusters via command line.

Community
Advanced
databricksdatabricks
251

databricks-jobs

Develop and deploy Databricks Lakeflow Jobs using Databricks Asset Bundles.

Official
Intermediate
FMurrayFMurray

databricks-unity-catalog

Query Unity Catalog system tables and manage volume file operations on Databricks.

Community
Intermediate
clawdataclawdata
24

databricks

Execute SQL statements on Databricks warehouses via the REST API.

Official
Intermediate