CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

databricks-core

Databricks CLI operations and the parent/entry-point skill for Databricks CLI use: authentication, profile selection, and bundles. Load this first for CLI, auth, profile, and bundle tasks, then load the matching product skill. For finding or exploring data, answering questions about the data, or generating SQL, load the databricks-data-discovery skill (it routes to Genie One). Contains up-to-date guidelines for Databricks-related CLI tasks.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

An unusually actionable, well-gated operational skill: concrete commands, explicit STOP-gated validation, and real error-recovery guidance. Its critical defect is that the progressive-disclosure layer is broken — the three reference files it repeatedly and correctly points to are missing from the bundle, so the prerequisite floor-check and auth procedures cannot actually be followed.

Suggestions

Ship the referenced bundle files databricks-cli-install.md, databricks-cli-auth.md, and manual-data-exploration.md (or remove the links); the 'Run the floor check in CLI Installation' gate currently points to nothing.

De-duplicate: state the databricks-data-discovery routing once and drop the 'Reference Guides' section that repeats the same three links already given in 'Required Reading by Task'.

Merge the two sandbox/blocked-install caveats (Cursor/containers note and the Exception bullet) into a single fallback procedure.

DimensionReasoningScore

Conciseness

Largely lean and command-first with almost no explanation of concepts Claude already knows, but there is trimming to do: the databricks-data-discovery routing is stated twice (Product Skills and Data Exploration sections), the three reference files are listed in both 'Required Reading by Task' and 'Reference Guides', and the sandbox-install caveat appears twice (Prerequisites bullet 4 and the Exception bullet). Not 5 because of this repeated material; not 3 because the padding is duplication rather than over-explanation.

4 / 5

Actionability

Fully executable throughout: copy-paste CLI commands with placeholders, correct/incorrect command contrasts ('# ❌ WRONG: these flags/commands DON'T EXIST'), the shell-session profile gotcha shown as WORKS/DOES NOT WORK examples, and an error-to-solution troubleshooting table. Covers the common cases concretely.

5 / 5

Workflow Clarity

The setup workflow is clearly sequenced with explicit validation checkpoints and feedback loops: run the CLI floor check, 'If it reports UPGRADE or INSTALL: STOP and follow that reference file', verify auth via 'databricks auth profiles', then a numbered profile-selection procedure with a hard 'NEVER auto-select' rule. Error recovery is covered by the troubleshooting table and re-auth path. Not 4 because checkpoints are explicit and gate progression, not merely implied.

5 / 5

Progressive Disclosure

The body is structured as a proper overview with one-level-deep, clearly signaled references ([CLI Installation](databricks-cli-install.md), [CLI Authentication](databricks-cli-auth.md), [Manual Data Exploration](manual-data-exploration.md)) — but none of these files exist in the bundle (no references/, scripts/, or assets .md files beyond two images), so the entire detail layer the skill depends on (the CLI floor check itself lives in databricks-cli-install.md) is unreachable. Scored against the actual bundle structure: navigation is clearly signaled but broken, which is below the anchor-3 'references present but not clearly signaled' middle and closer to the anchor-2 failure of a usable reference structure.

2 / 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 clearly states what it does, when to load it (including explicit trigger phrases), and how it relates to sibling skills. Main weakness is that the enumerated capabilities stay at the level of CLI/auth/profile/bundle and omit the concrete operations users might name.

Suggestions

Enumerate a few concrete operation types (e.g. 'deploying bundles, running jobs, listing clusters/warehouses') so users naming a specific task match the description directly.

Add common user phrasings like 'query Databricks', 'deploy a bundle', or 'set up a Databricks profile' to broaden natural trigger coverage.

Drop the trailing 'Contains up-to-date guidelines for Databricks-related CLI tasks' — it is vague filler that adds no trigger or capability information.

DimensionReasoningScore

Specificity

Names the domain ('Databricks CLI operations') and several concrete capabilities ('authentication, profile selection, and bundles') plus explicit routing behavior ('routes to Genie One'), but never enumerates what the CLI operations actually are (jobs, pipelines, apps), leaving minor gaps in coverage.

4 / 5

Completeness

Explicitly answers both: what — 'Databricks CLI operations... authentication, profile selection, and bundles' — and when — 'Load this first for CLI, auth, profile, and bundle tasks', plus concrete routing triggers for data discovery ('For finding or exploring data, answering questions about the data, or generating SQL'). Not below 5 since both what and when are concrete and explicit.

5 / 5

Trigger Term Quality

Natural user phrasing is well covered — 'CLI', 'auth', 'profile', 'bundle tasks', 'finding or exploring data', 'answering questions about the data', 'generating SQL' — but a few common variants (e.g. 'deploy', 'run a query', 'warehouse') are missing. Not the 5 anchor, which requires comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche as 'the parent/entry-point skill for Databricks CLI use' and explicitly disambiguates against databricks-data-discovery and per-product skills. Not 5 because as a router it deliberately fires for all Databricks tasks, creating inherent overlap with its own children; not 3 because the routing boundaries are explicitly stated.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 11 missing

Warning

Total

15

/

16

Passed

Repository

databricks/databricks-agent-skills

Path

plugins/databricks/claude/skills/databricks-core/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.