# databricks-genie-agents

Builds and configures Databricks Genie Agents over Unity Catalog tables, metric views, and volume documents with SQL query routing.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 282 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-genie-agents/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-genie-agents

## What it does

This skill guides the assistant through deploying and refining Databricks Genie Agents (formerly known as Genie Spaces). It handles the full agent lifecycle using a local `serialized_space` JSON file, which packages data sources, column context, instructions, and representative questions.

Interaction flows through the Databricks CLI. It can trigger space creation, push full updates via `update-space`, or send validation prompts. When managed UC volumes are attached, textual documents are searched strictly in Agent mode. Standard conversational calls bypass those files and inspect tables only.

Without Databricks CLI v1.0.0 or higher installed, these lifecycle commands cannot run.

## Requirements
- Works with: Databricks

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/databricks-genie-agents/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-genie-agents
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add databricks/databricks-agent-skills --skill databricks-genie-agents -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-genie-agents/SKILL.md

## When to use it
- generate and deploy a Genie Agent from a local JSON payload
- attach Unity Catalog document volumes to replace legacy Knowledge Assistants
- validate SQL responses and metric views with test prompts
- export existing space definitions for cross-workspace migration

## Example prompts
- Deploy a new Genie Agent using `genie_agent.json` on SQL warehouse `wh_456`
- Update space `space_789` with new instructions and metric view mappings
- Send a validation query to space `space_789` without waiting for completion

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

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
