databricks-dbsql — Claude Code skill: what it does, how to install
Equips your coding agent with advanced Databricks SQL patterns, pipe syntax, H3 geospatial functions, and embedded LLM queries.
npx skills add databricks/databricks-agent-skills --skill databricks-dbsql -a claude-codeWhat databricks-dbsql does
This skill supplies your assistant with patterns for advanced Databricks SQL (DBSQL) and SQL Warehouse environments. It covers procedural scripting with BEGIN...END, atomic transactions, recursive CTEs, and pipe syntax using the |> operator. It helps the agent write dialect-specific code without hallucinating standard SQL constructs.
It also details the setup for Lakehouse Federation queries, file ingestion with read_files, and native AI functions such as ai_query and ai_classify. In addition, reference patterns for H3 indexing and ST spatial functions are included.
Using this skill alongside Databricks tooling expects databricks CLI version 1.0.0 or higher. Certain capabilities like materialized views and http_request also demand Pro or Serverless SQL Warehouses.
What it helps with
- write stored procedures with SQLEXCEPTION handlers in Databricks SQL
- enrich datasets directly using ai_query and ai_classify functions
- run geospatial proximity searches with H3 indexing and ST points
- refactor multi-step queries using DBSQL pipe operator syntax
Example prompts for the agent
- Write a stored procedure in Databricks SQL to merge staging orders with error handling
- Show how to use ai_classify to categorize incoming support tickets in DBSQL
- Create an H3 geospatial query to calculate distances between coordinates
How to install databricks-dbsql
1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-dbsql -a claude-code2Manually: put the files in place
~/.claude/skills/databricks-dbsql/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/databricks-dbsql/
1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-dbsql -a codex2Manually: put the files in place
.agents/skills/databricks-dbsql/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-dbsql -a cursor2Manually: put the files in place
.cursor/skills/databricks-dbsql/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install databricks/databricks-agent-skills databricks-dbsql2Manually: put the files in place
.github/skills/databricks-dbsql/SKILL.md1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-dbsql -a gemini-cli2Platform CLI
gemini skills install https://github.com/databricks/databricks-agent-skills --path skills/databricks-dbsqlManually: put the files in place
.devin/skills/databricks-dbsql/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-dbsql -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about databricks-dbsql
How to install databricks-dbsql in Claude Code?
Run npx skills add databricks/databricks-agent-skills --skill databricks-dbsql -a claude-code. Alternatively, place the file at ~/.claude/skills/databricks-dbsql/SKILL.md.
What features does databricks-dbsql cover?
It provides syntax rules and examples for procedural SQL scripting, materialized views, pipe syntax, Lakehouse Federation, and built-in AI functions on Databricks.
What are the requirements for this skill?
The skill requires databricks CLI version 1.0.0 or higher. Specific features like materialized views and http_request need Pro or Serverless SQL Warehouses.