CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

databricks-execution-compute

Execute code and manage compute on Databricks: run Python/Scala/SQL/R via serverless, classic, or interactive clusters, and create/resize/delete clusters and SQL warehouses.

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/databricks/claude/skills/databricks-execution-compute/SKILL.md
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 well-structured, highly actionable skill body with a strong decision framework, real executable commands, and clearly signaled one-level-deep references that all exist. The main weaknesses are inline duplication of the serverless reference content, a muddled Databricks Connect quick-start snippet, and missing validation around irreversible delete operations.

DimensionReasoningScore

Conciseness

The body is dense and operational — decision matrix, gotchas ("'client': '4' is required... '1' silently ignores them", task run_id vs parent run_id), and copy-paste commands with almost no explanation of concepts Claude already knows. It is not a 5 because the Serverless Job section duplicates nearly all of references/2-serverless-job.md inline (same four steps, commands, and gotchas), and the mode-preference guidance is stated three times (decision matrix, decision flow, prose).

4 / 5

Actionability

Mostly executable, copy-paste-ready guidance: full `databricks workspace import`/`jobs submit` commands with complete JSON bodies, jq trimming commands, and warehouse create/edit JSON. It falls short of 5 because the Databricks Connect example in the body is muddled — Python code inside a ```bash block with a `...` ellipsis placeholder — leaving the preferred mode's quick-start not fully executable from the body alone.

4 / 5

Workflow Clarity

The serverless flow is clearly sequenced (upload → submit → poll → fetch output) with explicit validation checkpoints: "Only read .state.result_state... once life-cycle is TERMINATED", and the decision flow covers failure branches ("Install fails? → Ask user (don't auto-switch modes)"). Minor gaps keep it at 4 rather than 5: no explicit recovery loop when a run FAILED (fetch error is described, but not what to do next), and irreversible operations (warehouses delete, clusters permanent-delete) have no verification/confirmation step.

4 / 5

Progressive Disclosure

Good structure: a decision matrix and per-mode sections that each link to a real one-level-deep reference file (all three references/ files exist), with clear signaling ("Read the reference file for your chosen mode before proceeding") and well-organized references containing 'Use when' / 'When NOT to Use' guidance. It is not a 5 because the body's serverless section substantially duplicates its reference file's content inline, and the ~40-line SQL Warehouses block lives entirely in SKILL.md with no reference file of its own.

4 / 5

Total

16

/

20

Passed

Description

71%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, specific description that clearly conveys what the skill does with concrete enumerated actions and good natural keywords. Its main weakness is the absence of any explicit "Use when..." trigger guidance, which caps completeness, and some overlap risk with closely related Databricks sibling skills.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user asks to run or execute code on Databricks, submit a one-off script, or create/start/resize/delete clusters or SQL warehouses."

Include common natural synonyms users would say — "Spark", "notebooks", "execute scripts", "Databricks Connect" — to broaden trigger coverage.

Add a brief disambiguator against sibling skills (e.g. "for production job orchestration see databricks-jobs; for SQL analytics see databricks-dbsql") to reduce conflict risk.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions with their objects — "run Python/Scala/SQL/R via serverless, classic, or interactive clusters" and "create/resize/delete clusters and SQL warehouses" — giving comprehensive coverage of the skill's execution and compute-lifecycle capabilities. It clearly matches the anchor for multiple specific concrete actions rather than the anchor below (several actions with minor gaps), since languages, compute types, and resource types are all enumerated.

5 / 5

Completeness

The "what" is explicit and concrete (execute code, manage compute, create/resize/delete clusters and warehouses), but there is no "Use when..." clause or any equivalent explicit trigger guidance — the "when" is only weakly implied by domain terms. Per the judging guidelines, a missing 'Use when' clause caps completeness at 3; it is not a 4 because the when-context cannot be considered present even implicitly beyond the bare domain name.

3 / 5

Trigger Term Quality

Good natural keyword coverage — "run Python/Scala/SQL/R", "clusters", "SQL warehouses", "serverless", "create/resize/delete" — terms a Databricks user would naturally say. It falls short of the 5 anchor because common variations users actually say are missing, e.g. "Spark", "notebooks", "execute code", "Databricks Connect", or "jobs".

4 / 5

Distinctiveness Conflict Risk

The Databricks-scoped niche with compute lifecycle focus ("create/resize/delete clusters and SQL warehouses") is mostly distinct with clear triggers. There is minor overlap risk with closely related sibling skills mentioned in the body (databricks-dbsql for SQL, databricks-sandbox for running code, databricks-jobs for orchestration) that the description does not disambiguate — fitting the 4 anchor rather than 5, but well above the 3 anchor since the execution/compute-lifecycle framing is specific.

4 / 5

Total

16

/

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: 7 suspicious

Warning

Total

14

/

16

Passed

Repository

databricks/databricks-agent-skills

Path

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