CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

databricks-data-discovery

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.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is databricks-data-discovery in databricks/databricks-agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable skill body with executable commands, exact output formats, a verified fallback path, and explicit error-handling guidance — Claude could execute this correctly on first read. Its main cost is redundancy: session-label rules are stated three times, and sections on MCP-equivalence and naming history pad the token budget without changing behavior.

Suggestions

State the session-label rule once (in the 'How to ask Genie' bullet list) and delete the duplicate prose and code-comment repetitions, saving ~10 lines without losing information.

Move the detailed flag documentation (parallelism, --output json buffering, --raw) into a references/ file (e.g. references/genie-flags.md) and keep only the two or three most common invocations inline.

Trim the 'Relationship to the Genie One MCP' section to one sentence; the naming-history blockquote is only needed if users or transcripts actually use the old 'OneChat'/'Databricks One' names.

DimensionReasoningScore

Conciseness

The body is information-dense and mostly earns its tokens, but it repeats itself: session-label reuse guidance appears three times (prose paragraph, code comment, and the 'Picking a session label' bullet), and sections like 'Relationship to the Genie One MCP' and the Genie/OneChat naming history add context Claude rarely needs to act. This matches 'mostly efficient but could be tightened' rather than the lean 4–5 anchors.

3 / 5

Actionability

Commands are copy-paste ready and cover the common cases: full `databricks genie ask -s trips "..."` examples for follow-ups and summarization, `--include-sql`, `--output json` with the actual JSON shape shown, the legacy `experimental genie ask` fallback spelled out, and the exact verification command (`databricks genie ask --help`) before falling back. This matches the 'fully executable, copy-paste ready, specific examples cover common cases' anchor.

5 / 5

Workflow Clarity

The routing decision (Genie vs coding agent) is laid out first with explicit do/don't categories, the fallback branch has a real validation checkpoint (verify the command exists before assuming it's missing), and error recovery is handled ('a non-answer is a message, not an error: don't retry — use the manual fallback'; stalled-stream failure behavior). It sits between the 4 and 5 anchors: checkpoints exist but are scattered across prose rather than a sequenced checklist, and the anti-pattern guidance ('do NOT default to tables list') is stated without a recovery step.

4 / 5

Progressive Disclosure

Well-structured single-file body with clear section headers routing from overview to usage details to fallback, and one clearly signaled one-level-deep reference to the parent skill's manual-data-exploration.md. It falls short of the 5 anchor because the detailed flag/output documentation (parallelism rules, JSON schema, session-label mechanics) is inlined and would fit naturally in a reference file, and no reference/script files exist in the bundle to carry that depth.

4 / 5

Total

16

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that explicitly states what the skill does and when it must be invoked, with quoted natural-language trigger phrases rather than generic jargon. Its only weaknesses are the slightly abstract 'discover/explore' verbs and the unqualified 'write a SQL query' trigger that could fire outside the Databricks context.

Suggestions

Qualify the SQL trigger to the Databricks context, e.g. 'or write a SQL query against Databricks data', to avoid firing for SQL authoring on other platforms.

Replace one abstract verb ('explore') with a concrete capability, e.g. 'Discover tables and schemas, answer data questions, and generate verified SQL via Genie'.

DimensionReasoningScore

Specificity

"Discover, explore, and query Databricks data via Genie" names three concrete capabilities plus the mechanism (CLI, Genie One), matching the 'several specific actions; minor gaps' anchor. Not a 5 because 'discover/explore' remain somewhat abstract compared to fully concrete action verbs, and the Databricks-specific operations (session-labeled asks, SQL generation) are only implied by the trigger examples.

4 / 5

Completeness

Both questions are answered explicitly: what — "Discover, explore, and query Databricks data via Genie — the CLI equivalent of the Genie One MCP"; when — "MUST be invoked whenever the user asks to find or locate data (...), answer a natural-language question about the data, or write a SQL query", with concrete trigger phrases. This matches the top anchor exactly; nothing is merely implied.

5 / 5

Trigger Term Quality

Strong natural-language triggers are quoted directly — "what tables are in X", "where does X live", "which catalog/schema has Y", "answer a natural-language question about the data", "write a SQL query" — covering how users actually phrase these requests. A few natural variations (e.g., 'find data', 'profile a table', 'schema') are absent, so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

The Databricks/Genie niche is clear and unlikely to collide with unrelated skills, but the unqualified trigger "or write a SQL query" is broad — a user asking for SQL against a non-Databricks database would match the trigger text literally, creating minor overlap risk with generic SQL-authoring skills. That keeps it just below the 'minimal conflict risk' anchor.

4 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 1 suspicious

Warning

Total

14

/

16

Passed

Repository

databricks/devhub

Path

.databricks/aitools/skills/databricks-data-discovery/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.