CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

databricks-jobs

Develop and deploy Lakeflow Jobs on Databricks. Use when creating data engineering jobs with notebooks, Python wheels, or SQL tasks. Invoke BEFORE starting implementation.

61

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/databricks-jobs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 executable commands and complete YAML examples throughout. The main costs are token efficiency (duplicated install instructions and a definitional intro) and the absence of error-recovery guidance in the deployment workflow.

Suggestions

Remove the CLI installation prerequisites from the inline CLAUDE.md template (or move the whole template to a references/ file) — the parent databricks-core skill already covers CLI setup, cutting a large duplicated block.

Delete the opening definitional sentence ('Lakeflow Jobs are scheduled workflows that run notebooks...') — Claude already knows this and the parent skill provides context.

Add a short error-recovery loop to the Development Workflow (e.g. 'If validate fails, fix the reported resource errors and re-validate before deploying') to raise workflow clarity.

DimensionReasoningScore

Conciseness

The body is mostly lean code and YAML, but includes unnecessary material: the one-line definition of what Lakeflow Jobs are (knowledge Claude already has), and a full CLI-installation prerequisites block embedded in the CLAUDE.md template that duplicates the parent databricks-core skill's coverage ('Install the Databricks CLI (>= v0.288.0)...'). Mostly efficient with several trimmable sections, matching anchor 3.

3 / 5

Actionability

Provides an executable non-interactive scaffold command, complete job YAML, runnable notebook code, and a four-step command workflow — mostly copy-paste ready. Minor gaps keep it below anchor 5: unexplained placeholders (<PROFILE>, <run-id>), 'uv run pytest' assumes uv without setup guidance, and the bare cron 'schedule:' example is shown without the resources/jobs nesting context used in every other example.

4 / 5

Workflow Clarity

The Development Workflow gives a clear sequence (Validate -> Deploy -> Run -> Check run status) with a validation checkpoint before deploy, so the batch-operation cap of 3 does not apply. However there is no error-recovery loop (what to do when validate or a run fails) and unit testing sits outside the workflow, so it does not reach anchor 5's explicit feedback loops.

4 / 5

Progressive Disclosure

No bundle files exist, so this is scored on the body's own structure: well-organized sections, basics delegated to the parent databricks-core skill ('Use the parent databricks-core skill for CLI basics'), and documentation links at the end. Minor organization gaps — the sizable CLAUDE.md template is inlined where a reference file would keep SKILL.md as an overview — place it at anchor 4 rather than 5.

4 / 5

Total

15

/

20

Passed

Description

78%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 with an explicit and concrete 'Use when...' clause and a distinct niche. Its main weakness is specificity — 'develop and deploy' is generic relative to the skill's actual capabilities (scaffolding, task configuration, scheduling, testing).

Suggestions

Expand the capability list beyond 'Develop and deploy' to concrete actions like 'scaffold bundle projects, configure notebook/wheel/SQL tasks, schedule, and deploy' to raise specificity.

Add common user phrasings such as 'workflow', 'ETL job', or 'scheduled pipeline' to the trigger clause for broader natural-keyword coverage.

DimensionReasoningScore

Specificity

Names the domain ('Lakeflow Jobs on Databricks') and two concrete actions ('Develop and deploy'), matching the 'domain plus 1-2 concrete actions' anchor. It does not list the fuller capability set (scaffold, configure tasks, schedule, test), so it is below anchor 4's 'several specific actions' but clearly above anchor 2's domain-only level.

3 / 5

Completeness

Explicitly answers both: what ('Develop and deploy Lakeflow Jobs on Databricks') and when ('Use when creating data engineering jobs with notebooks, Python wheels, or SQL tasks'), plus an explicit invocation directive ('Invoke BEFORE starting implementation'). This matches the anchor-5 example structure of concrete what + concrete when; anchor 4 would require the 'when' to be less specific, which it is not.

5 / 5

Trigger Term Quality

Includes natural terms users would say ('data engineering jobs', 'notebooks', 'Python wheels', 'SQL tasks', 'Databricks'). Common variations like 'workflow', 'ETL', 'schedule a job', or 'deploy a pipeline' are missing, so it falls between anchor 3 and the comprehensive synonym coverage of anchor 5 — noticeably above the midpoint.

4 / 5

Distinctiveness Conflict Risk

'Lakeflow Jobs' is a clearly distinct niche with specific triggers (jobs, notebooks, wheels, SQL tasks), giving minimal conflict with unrelated skills. Minor overlap risk remains with closely related sibling skills in the same family (e.g. databricks-core or a pipelines skill covering scheduled workflows), so it is not the clean niche of anchor 5.

4 / 5

Total

16

/

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

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

databricks/devhub

Path

.agents/skills/databricks-jobs/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.