CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

databricks-ai-runtime

Databricks AI Runtime, the `databricks air` CLI commands for submitting and managing GPU training workloads on Databricks serverless compute. Use for: writing and submitting `databricks air` workload YAML, passing hyperparameters and secrets, checking run status, listing/cancelling runs, streaming a run's logs and watching its progress, custom Docker image setup, and environment configuration.

Quality

83%

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-ai-runtime in databricks/databricks-agent-skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

Highly actionable content with strong executable commands and a well-validated submit workflow, undermined by a broken progressive-disclosure structure — the referenced docker-images.md is absent from the bundle — and by missing validation guidance for the destructive `cancel --all` operation. Inline, repeated version-sensitive details (CLI 1.20.0 format guidance, current accelerator types) also work against token efficiency.

Suggestions

Ship the missing docker-images.md file referenced in the 'Custom Docker images' section (and in the pre-flight step), or inline its essential guidance into SKILL.md — as written, both links dead-end.

Add a validation step before destructive batch cancels: for `databricks air cancel --all`, first run `databricks air list` to show active runs and confirm with the user before cancelling.

Consolidate the version-sensitive material (flattened vs nested `code_source` for CLI 1.20.0, and "Today's accelerator types") into a single compatibility/older-CLI section instead of repeating it across 'Session setup' and 'Workload YAML'.

DimensionReasoningScore

Conciseness

Generally lean — dense tables, executable blocks, and no explanation of concepts Claude already knows — but the version-sensitive material is repeated inline: the CLI 1.20.0 flattened-vs-nested `code_source` guidance appears in both "Session setup" and "Workload YAML", and "Today's accelerator types are `GPU_1xA10` and `GPU_8xH100`" bakes time-sensitive values into the body. Per the rubric, inline version/date information not placed in a deprecated/compat section costs conciseness, so this is efficient-with-minor-trimming rather than fully lean.

4 / 5

Actionability

Fully executable throughout: copy-paste commands ("databricks air run --file workload.yaml --dry-run -o json -p <profile>"), complete YAML blocks, a framework-to-`command:` launch table, a Python snippet for reading `$HYPERPARAMETERS_PATH`, and an error-`kind`-to-action table. The common cases (submit, monitor, sweep hyperparameters, wire secrets) are all covered with runnable examples.

5 / 5

Workflow Clarity

"Starting a run" is a well-sequenced 5-step flow with an explicit validation checkpoint (step 4 dry-run: "A config-validation error is a hard stop") and a fix-and-resubmit loop, but the skill exposes the destructive batch operation "databricks air cancel ... --all" with no validation or confirmation guidance (e.g., list active runs and confirm with the user first). The rubric caps workflow clarity at 3 for destructive/batch operations lacking validation, which overrides the otherwise strong submit workflow.

3 / 5

Progressive Disclosure

The body is well-sectioned, but it points to "[docker-images.md](docker-images.md)" twice ("Read [docker-images.md](docker-images.md) for step-by-step guidance") and that file does not exist anywhere in the bundle — the reference dead-ends, leaving the promised Docker guidance inaccessible. Additionally, the bundled assets (databricks.png, databricks.svg) are never referenced from the body. This is worse than 'references present but not clearly signaled' (3): the referenced content is simply missing, matching the minimal-structure anchor (2), though the body itself is navigable so not a 1.

2 / 5

Total

14

/

20

Passed

Description

92%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: concrete, comprehensive action list with an explicit "Use for:" trigger clause and a well-scoped niche. The only weakness is modest synonym coverage for natural user phrasings like "training job" or "GPU run".

DimensionReasoningScore

Specificity

Lists seven concrete actions — "writing and submitting `databricks air` workload YAML, passing hyperparameters and secrets, checking run status, listing/cancelling runs, streaming a run's logs and watching its progress, custom Docker image setup, and environment configuration" — comprehensively covering submission, monitoring, and advanced configuration. This matches the anchor for multiple specific concrete actions with comprehensive coverage; a 4 would require minor coverage gaps, which are not present.

5 / 5

Completeness

Explicitly answers both: the "what" is "the `databricks air` CLI commands for submitting and managing GPU training workloads on Databricks serverless compute", and the "when" is the explicit "Use for:" clause enumerating concrete trigger tasks. A 4 would require the 'when' to be less explicit; here it is a fully enumerated trigger list.

5 / 5

Trigger Term Quality

Good natural keyword coverage: "GPU training workloads", "hyperparameters", "run status", "logs", "Docker image", "training" are phrases users would plausibly say. Falls short of a 5 because common synonyms and variations (e.g., "training job", "training run", "GPU cluster") are absent, though it is clearly above the midpoint.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers — "Databricks AI Runtime", "`databricks air`", "GPU training workloads", "Databricks serverless compute" — unlikely to fire for unrelated skills. Not a 4: the command name and serverless GPU training scope are specific enough that overlap risk with closely related skills (e.g., general Databricks CLI skills) is minimal.

5 / 5

Total

19

/

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: 2 missing

Warning

Total

15

/

16

Passed

Repository

databricks/databricks-agent-skills

Path

plugins/databricks/antigravity/skills/databricks-ai-runtime/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.