databricks-setup-local — Claude Code skill: setup and install
The databricks-setup-local skill previews, configures, or troubleshoots a local uv-managed Python .venv for Databricks. Use it for Databricks Connect, compute targets, job tasks, or bundles.
no license 153 installs ★ 408 updated 2026-10-24
npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -a claude-codeWhat databricks-setup-local does
The skill guides the agent through checking the Databricks CLI and authentication, choosing a project directory, and selecting one target: a cluster, serverless compute, job task, or bundle. It runs a dry run first, then presents the proposed changes for approval before applying them. The project must be new or managed with uv.
You need Databricks CLI v1.16.0 or later and uv. Applying a plan can rewrite pyproject.toml, install Python and dependencies, and update .venv and uv.lock, so changes require approval. Compute flags cannot be combined. For a serverless bundle target, the agent also syncs environment versions in job YAML and validates the bundle after setup.
What it helps with
- prepare a local
.venvfor Databricks Connect - configure an environment for cluster or serverless compute
- set up a local environment for a Databricks job task
- preview bundle setup changes before applying them
- diagnose a failed
setup-localrun
Example prompts for the agent
- Set up a local Databricks Connect environment for this project and show me the plan first.
- Preview a serverless environment setup for version
Nbefore making changes. - Find out why
databricks environments setup-localfails in this project.
How to install databricks-setup-local
1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -a claude-code2Manually: put the files in place
~/.claude/skills/databricks-setup-local/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/databricks-setup-local/
1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -a codex2Manually: put the files in place
.agents/skills/databricks-setup-local/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -a cursor2Manually: put the files in place
.cursor/skills/databricks-setup-local/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install databricks/databricks-agent-skills skills/databricks-setup-local2Manually: put the files in place
.github/skills/databricks-setup-local/SKILL.md1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -a gemini-cli2Platform CLI
gemini skills install https://github.com/databricks/databricks-agent-skills --path skills/databricks-setup-localManually: put the files in place
.devin/skills/databricks-setup-local/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -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-setup-local
How do I install databricks-setup-local in Claude Code?
Run npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -a claude-code. The skill file is installed at ~/.claude/skills/databricks-setup-local/SKILL.md.
What does databricks-setup-local do?
It helps configure or troubleshoot a local Python .venv through databricks environments setup-local. The agent previews the plan and asks for approval before applying changes.
What do I need to use the skill?
You need Databricks CLI v1.16.0 or later and uv. The project must be new or managed by uv.