CtrlK
BlogDocsLog inGet started
Tessl Logo

databricks-jobs

Use this skill proactively for ANY Databricks Jobs task - creating, listing, running, updating, or deleting jobs. Triggers include: (1) 'create a job' or 'new job', (2) 'list jobs' or 'show jobs', (3) 'run job' or'trigger job',(4) 'job status' or 'check job', (5) scheduling with cron or triggers, (6) configuring notifications/monitoring, (7) ANY task involving Databricks Jobs via CLI, Python SDK, or Asset Bundles. ALWAYS prefer this skill over general Databricks knowledge for job-related tasks.

64

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 ./databricks-skills/databricks-jobs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%

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

A highly actionable reference with concrete SDK/CLI/Bundle examples and good navigational intent, undermined by missing reference files, inline duplication of reference content, and absent validation checkpoints around destructive operations.

Suggestions

Create the referenced files (task-types.md, triggers-schedules.md, notifications-monitoring.md, examples.md) and move the inline task-type, trigger-type, compute, parameter, and permissions detail into them so the body stays a lean overview.

Add explicit validation/verification steps before destructive operations — e.g. run 'databricks jobs get' to confirm the target before 'databricks jobs delete', and 'databricks bundle validate' before 'databricks bundle destroy' — to establish a validate-then-act feedback loop.

Tighten the body by collapsing the duplicated task-type and trigger-type summary tables into single pointers to their reference files, preserving only the most common cases inline.

DimensionReasoningScore

Conciseness

The body is dense and mostly actionable, but it inlines substantial material (task-types summary table, trigger-types summary table, compute configuration, parameters, permissions) that duplicates the very reference files it points to. A 3 would require every token to earn its place with detail offloaded to references; a 1 would require explaining concepts Claude already knows, which it largely avoids.

2 / 3

Actionability

Provides fully executable Python SDK, CLI, and YAML Asset Bundle snippets that are copy-paste ready (e.g. w.jobs.create(...) with concrete Task/NotebookTask objects, 'databricks jobs run-now 12345 --job-params'). Matches the 'fully executable code/commands' anchor.

3 / 3

Workflow Clarity

Bundle operations are sequenced (validate → deploy → run), but destructive operations ('databricks jobs delete', 'databricks bundle destroy') appear without any validation or verification checkpoint, and the rubric caps workflow_clarity at 2 when destructive/batch operations lack feedback loops. It is above a 1 because steps and sequences are present rather than missing.

2 / 3

Progressive Disclosure

There is a well-signaled one-level reference table and organized summary tables with anchor links, but the referenced bundle files (task-types.md, triggers-schedules.md, notifications-monitoring.md, examples.md) do not exist in references/, and much of that detail is duplicated inline. A 3 would require the references to resolve and content to be appropriately split out; a 1 would require a monolithic wall or nested references.

2 / 3

Total

9

/

12

Passed

Description

90%

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, trigger-rich description that clearly delimits the Databricks Jobs niche and disambiguates it from general Databricks skills. Its only real weakness is the second-person imperative voice, which the rubric penalizes on specificity.

DimensionReasoningScore

Specificity

It lists multiple concrete actions ('creating, listing, running, updating, or deleting jobs') which would warrant a 3, but the second-person imperative voice ('Use this skill proactively...') triggers the rubric's -1 specificity penalty. It is above a 2-anchor alone because the action list is genuinely comprehensive, not just 'names domain and some actions.'

2 / 3

Completeness

Explicitly answers both 'what' (job CRUD via CLI, Python SDK, or Asset Bundles) and 'when' (enumerated 'Triggers include:' list), matching the 'clearly answers both what AND when' anchor. A 2 would require the 'when' to be only implied, which it is not.

3 / 3

Trigger Term Quality

Strong coverage of natural user phrasing — 'create a job', 'new job', 'list jobs', 'show jobs', 'run job', 'job status', 'check job', plus cron/notifications and CLI/SDK/Bundles. These are terms a user would naturally say, matching the 'good coverage' anchor.

3 / 3

Distinctiveness Conflict Risk

Scoped to a clear niche (Databricks Jobs) with distinct triggers and an explicit disambiguation ('ALWAYS prefer this skill over general Databricks knowledge for job-related tasks'), making conflict with sibling skills unlikely.

3 / 3

Total

11

/

12

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.

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 18 missing, 2 suspicious

Warning

Total

15

/

16

Passed

Repository
databricks-solutions/ai-dev-kit
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.