# databricks-setup-local

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 153 installs · ★ 408 repo stars
- Author: databricks
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/databricks/databricks-agent-skills/tree/HEAD/skills/databricks-setup-local/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/databricks-setup-local

## What it 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.

## Requirements
- Works with: Databricks

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/databricks-setup-local/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/databricks-setup-local/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/databricks-setup-local/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/databricks-setup-local/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install databricks/databricks-agent-skills skills/databricks-setup-local
```

2. **Manually: put the files in place**
- File: `.github/skills/databricks-setup-local/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/databricks/databricks-agent-skills --path skills/databricks-setup-local
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/databricks-setup-local/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add databricks/databricks-agent-skills --skill databricks-setup-local -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/databricks/databricks-agent-skills/tree/HEAD/skills/databricks-setup-local/SKILL.md

## When to use it
- prepare a local `.venv` for 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-local` run

## Example prompts
- Set up a local Databricks Connect environment for this project and show me the plan first.
- Preview a serverless environment setup for version `N` before making changes.
- Find out why `databricks environments setup-local` fails in this project.

## Similar
- [data-engineering-patterns-fabric-databricks](https://affpapa.org/en/nevibecode/skills/data-engineering-patterns-fabric-databricks.md) — skill · 1600 installs
- [databricks-expert](https://affpapa.org/en/nevibecode/skills/databricks-expert.md) — skill · 215 installs
- [databricks-2025](https://affpapa.org/en/nevibecode/skills/databricks-2025.md) — skill · 168 installs
- [azure-databricks-platform-architect](https://affpapa.org/en/nevibecode/agents/azure-databricks-platform-architect.md) — subagent · ★ 6505 repo stars
- [databricks](https://affpapa.org/en/nevibecode/rules/databricks.md) — rule · ★ 3589 repo stars
- [databricks-cli](https://affpapa.org/en/nevibecode/plugins/databricks-cli.md) — plugin · ★ 1104 repo stars

From the same set: [databricks/databricks-agent-skills](https://affpapa.org/en/nevibecode/by/databricks/databricks-agent-skills.md) — 30 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
