Official agent skill

Databricks Data Discovery

by databricks in databricks/databricks-agent-skills

Discover, explore, and query Databricks data via Genie — the CLI equivalent of the Genie One MCP.

OfficialCustom licenceAuto-check passedDatabases

Install Databricks Data Discovery

skills CLI
$ npx skills add databricks/databricks-agent-skills --skill databricks-data-discovery -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install databricks/databricks-agent-skills databricks-data-discovery --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/databricks/databricks-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/databricks-data-discovery .claude/skills/databricks-data-discovery && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
databricks-data-discovery
GitHub stars
345
Token cost
~2.1k tokens
SKILL.md length
1,048 words
Files
4 (incl. assets)
Skills in repo
32
Repo updated
First seen
Licence
Custom licence

At a glance

Discover, explore, and query Databricks data via Genie — the CLI equivalent of the Genie One MCP.

  • Tasks that involve SQL
  • SKILL.md covers Routing — Genie vs your coding…, Why prefer Genie for data…, How to ask Genie and If Genie One isn't available —…, plus 2 more sections
  • Calls databricks

What it does

Databricks Data Discovery is an agent skill from databricks/databricks-agent-skills, published by the product's own GitHub organization. Discover, explore, and query Databricks data via Genie — the CLI equivalent of the Genie One MCP. MUST be invoked whenever the user asks to find or locate data ('what tables are in X', 'where does X live', 'which catalog/schema has Y'), answer a natural-language question about the data, or write a SQL query.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including assets (for example `agents/openai.yaml`). Compatibility notes: Requires databricks CLI = v1.9.0 for databricks genie ask (older CLIs fall back to the deprecated databricks experimental genie ask alias)

It sits in Databases, covering SQL. It works with Databricks, SQL and Model Context Protocol. The repository describes itself as: Databricks AI Tools: skills and plugins for building on Databricks with Claude Code, Cursor, Codex, GitHub Copilot, and other AI coding agents.

When your agent uses it

  • Tasks that involve SQL

Example prompts

  • “what tables are in X”
  • “where does X live”
  • “which catalog/schema has Y”
  • “/databricks-data-discovery”

Requirements

  • Compatibility (from SKILL.md): Requires databricks CLI >= v1.9.0 for `databricks genie ask` (older CLIs fall back to the deprecated `databricks experimental genie ask` alias)

What it can do on your machine

Read from SKILL.md and the folder at commit f4fcec5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • databricks

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires databricks CLI >= v1.9.0 for `databricks genie ask` (older CLIs fall back to the deprecated `databricks experimental genie ask` alias)

    From compatibility in the SKILL.md frontmatter.

Context cost

Databricks Data Discovery loads about 2.1k tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 1,048 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,048 words (~2,095 tokens).

“This skill routes data work — decide first:”

— opening of SKILL.md by databricks, Custom licence
name
databricks-data-discovery
compatibility
Requires databricks CLI >= v1.9.0 for `databricks genie ask` (older CLIs fall back to the deprecated `databricks experimental genie ask` alias)
metadata.version
0.1.0
parent
databricks-core

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (assets) in skills/databricks-data-discovery of databricks/databricks-agent-skills.

  • SKILL.md
  • agents/openai.yaml
  • assets/databricks.png
  • assets/databricks.svg

Open the folder on GitHubat commit f4fcec5

Compare with similar skills

Databricks Data Discovery next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Databricks Data Discovery compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Databricks Data Discovery this skilldatabricks/databricks-agent-skills345—~2.1kAutomated safety check: PassCustom licence
StarRocks SQL Doc Auto-FixStarRocks/starrocks12k—~7.6kAutomated safety check: NotesApache-2.0
Schema Explorationtimescale/pg-aiguide1.9k—~1.1kAutomated safety check: PassApache-2.0
NpgsqlrestNpgsqlRest/NpgsqlRest132—~7kAutomated safety check: NotesMIT
Modelersidequery/sidemantic129—~4.2kAutomated safety check: PassApache-2.0
Mendix Odata Pushdownmendixlabs/mxcli128—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • StarRocks SQL Doc Auto-Fix

    StarRocks/starrocks

    Proposes verified fixes for failing SQL examples in StarRocks docs across three languages and several versions, then opens draft pull requests and never merges.

    12k GitHub stars~7.6k tokensUpdated today
    DatabasesAuto-check: notes
  • Schema Exploration

    timescale/pg-aiguide

    Explore an existing PostgreSQL database before answering questions about its data or writing SQL.

    1.9k GitHub stars~1.1k tokensUpdated 5 days ago
    DatabasesAuto-check passed
  • Npgsqlrest

    NpgsqlRest/NpgsqlRest

    Build and modify REST APIs with NpgsqlRest — exposing PostgreSQL as HTTP endpoints from two sources (database functions/procedures/tables/views, and plain .sql files), driven by SQL comment…

    132 GitHub stars~7k tokensUpdated 4 days ago
    DatabasesAuto-check: notes
  • Modeler

    sidequery/sidemantic

    Build, validate, and manage semantic models using Sidemantic.

    129 GitHub stars~4.2k tokensUpdated today
    DatabasesAuto-check passed
  • Mendix Odata Pushdown

    mendixlabs/mxcli

    Push OData query options into the SQL of a Mendix resource served by a read microflow, so $filter, $orderby, $top, $skip, $count and the key lookup reach the database instead of being silently…

    128 GitHub stars~2.5k tokensUpdated today
    DatabasesAuto-check passed
  • Logfire Query

    pydantic/skills

    Official

    Query and analyze Logfire telemetry data — traces, logs, spans, metrics, summaries, and SQL results.

    140 GitHub stars~2.2k tokensUpdated 6 days ago
    DatabasesAuto-check passed

More from databricks/databricks-agent-skills

All 32 skills in this repo
  • Databricks Dbsql

    databricks/databricks-agent-skills

    Official

    Databricks SQL (DBSQL) advanced features and SQL warehouse capabilities.

    345 GitHub starsUsed in 1 repo~2.8k tokens
    Auto-check passed
  • Databricks Synthetic Data Gen

    databricks/databricks-agent-skills

    Official

    Generate realistic synthetic data using Spark + Faker (strongly recommended).

    345 GitHub stars~3.2k tokensUpdated yesterday
    Auto-check passed
  • Databricks Model Serving

    databricks/databricks-agent-skills

    Official

    Databricks Model Serving endpoint lifecycle and ops. An agent skill from databricks/databricks-agent-skills.

    345 GitHub starsUsed in 1 repo~3.3k tokens
    Auto-check passed
  • Databricks Python SDK

    databricks/databricks-agent-skills

    Official

    Databricks development guidance including Python SDK, Databricks Connect, CLI, and REST API.

    345 GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed
  • Databricks Spark Structured Streaming

    databricks/databricks-agent-skills

    Official

    Comprehensive guide to Spark Structured Streaming for production workloads.

    345 GitHub starsUsed in 1 repo~956 tokens
    Auto-check passed
  • Databricks App Design

    databricks/databricks-agent-skills

    Official

    Design the UX of custom-code Databricks Apps (AppKit/React) data screens — KPI/overview pages, reports, charts, tables, and Genie/chat data assistants — mapped to concrete AppKit components.

    345 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Databricks Data Discovery

What does Databricks Data Discovery do?

Discover, explore, and query Databricks data via Genie — the CLI equivalent of the Genie One MCP. Databricks Data Discovery is an agent skill from databricks/databricks-agent-skills, published by the product's own GitHub organization. Discover, explore, and query Databricks data via Genie — the CLI equivalent of the Genie One MCP.

When should I use Databricks Data Discovery?

Databricks Data Discovery fits situations like: tasks that involve SQL.

How do I install Databricks Data Discovery in Claude Code?

Run `npx skills add databricks/databricks-agent-skills --skill databricks-data-discovery -a claude-code`. Or copy the skill folder (skills/databricks-data-discovery in databricks/databricks-agent-skills) into .claude/skills/databricks-data-discovery in your project. Claude Code loads it when a task matches its description.

How do I install Databricks Data Discovery in Codex?

Run `npx skills add databricks/databricks-agent-skills --skill databricks-data-discovery -a codex`. Or copy the skill folder (skills/databricks-data-discovery in databricks/databricks-agent-skills) into .agents/skills/databricks-data-discovery in your project. Codex loads it when a task matches its description.

Can I use Databricks Data Discovery in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add databricks/databricks-agent-skills --skill databricks-data-discovery -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/databricks-data-discovery, .gemini/skills/databricks-data-discovery, .github/skills/databricks-data-discovery and .opencode/skills/databricks-data-discovery in your project.

What does Databricks Data Discovery need to run?

Going by SKILL.md and its folder, Databricks Data Discovery needs the command-line tools its instructions call (databricks). Compatibility (from SKILL.md): Requires databricks CLI >= v1.9.0 for `databricks genie ask` (older CLIs fall back to the deprecated `databricks experimental genie ask` alias).

Does Databricks Data Discovery access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Databricks Data Discovery safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Databricks Data Discovery use?

Databricks Data Discovery has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Databricks Data Discovery use?

About 2.1k tokens (SKILL.md is roughly 8.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Databricks Data Discovery?

Skills that share tags, products or a category with Databricks Data Discovery: StarRocks SQL Doc Auto-Fix (StarRocks/starrocks, 12k stars), Schema Exploration (timescale/pg-aiguide, 1.9k stars), Npgsqlrest (NpgsqlRest/NpgsqlRest, 132 stars) and Modeler (sidequery/sidemantic, 129 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Databricks Data Discovery?

databricks (a GitHub organization, an official publisher) maintains it in databricks/databricks-agent-skills, which has 345 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 6, 2026.

Source: databricks/databricks-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.