CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

databricks-unity-catalog

Unity Catalog governance, access control, and observability. Use to grant or revoke access (GRANT/REVOKE), reason about the privilege model and ownership, set up row-level security and column masks, create external locations and storage credentials, define catalogs/schemas/tables/volumes, answer "who can read this table", and query system tables (audit, lineage, billing) or work with volume files in /Volumes/.

Quality

86%

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

SKILL.md
Quality
Evals
Security

Quality

Content

80%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 highly actionable, well-structured overview with excellent progressive disclosure into verified reference files. The main gaps are the absence of explicit validation checkpoints around destructive grant/revoke workflows and minor token redundancy from repeated version-compatibility caveats.

Suggestions

Add an explicit verification loop to the grant/revoke workflow: e.g. "Before revoking, run SHOW GRANTS ON <securable> to confirm current access; after revoking, re-run it to verify the intended state" — the pieces exist but are never sequenced as checkpoints.

Consolidate the three near-identical "CLI surface varies by version" caveats into the single intro note and drop the repetitions to reclaim tokens.

Move the time-sensitive version details (CLI ≥ v1.0.0 floor, experimental-namespace instability) into one compatibility note so version churn only touches one section.

DimensionReasoningScore

Conciseness

The body is dense and command-focused with essentially no explanation of concepts Claude already knows, but the "CLI surface varies by version" caveat repeats near-verbatim three times (intro note, after the positional-order table, after the SDK fallback), and version-specific/time-sensitive details ("≥ v1.0.0", the experimental namespace) are discussed inline rather than consolidated in one place. This fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the lean top anchor.

4 / 5

Actionability

Everything is copy-paste executable: `databricks catalogs create --json '{...}'`, `databricks fs cp ... dbfs:/Volumes/...`, GRANT/REVOKE/SHOW GRANTS SQL, a Python SDK snippet, a positional-argument order table, and even how to obtain WAREHOUSE_ID and METASTORE_ID. This matches the 'fully executable, copy-paste ready, covers the common cases' anchor.

5 / 5

Workflow Clarity

There is a useful pre-flight checkpoint ("confirm the CLI and the subcommand exist" via `databricks --version`) and fallback guidance, but the destructive governance operations (REVOKE, DDL) have no explicit validation loop — e.g. no "run SHOW GRANTS before and after revoking to verify" checkpoint, and SHOW GRANTS appears only as a standalone query example. Per the rubric's cap for destructive operations without validation, this cannot exceed 3; it is above 2 because sequencing and error-fallback guidance are present.

3 / 5

Progressive Disclosure

The SKILL.md is a lean overview plus quick start, with a well-signaled Reference Files table of seven real one-level-deep reference files (all verified to exist), each linked inline at the point of use and described with its scope. Cross-links between references are lateral (sibling-to-sibling), not nested, so navigation stays one level deep — matching the top anchor.

5 / 5

Total

17

/

20

Passed

Description

88%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 the skill does and when to use it, with concrete, natural trigger phrases spanning governance, fine-grained access, system tables, and volumes. Minor room for improvement in keyword synonyms and delineation from sibling Databricks skills.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions covering every capability area: "grant or revoke access (GRANT/REVOKE)", "set up row-level security and column masks", "create external locations and storage credentials", "define catalogs/schemas/tables/volumes", "query system tables (audit, lineage, billing)". This matches the anchor for comprehensive concrete action coverage with no significant gaps, so it exceeds the 'several specific actions; minor gaps' anchor.

5 / 5

Completeness

It explicitly answers both: the what ("Unity Catalog governance, access control, and observability" plus enumerated capabilities) and the when ("Use to grant or revoke access… answer 'who can read this table'…") with concrete trigger phrases. This matches the top anchor; a 4 would require the 'when' clause to be less explicit or generic, which it is not.

5 / 5

Trigger Term Quality

It includes natural user phrasings like "grant or revoke access", "who can read this table", "row-level security", "audit, lineage, billing", and the "/Volumes/" path. A few common synonyms users would say are missing (e.g. "permissions", "audit logs", "table access"), which fits the 'good keyword coverage; a few natural terms missing' anchor rather than comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The Unity Catalog niche is explicit and triggers are distinct (GRANT/REVOKE, privilege model, /Volumes/, system tables), but "define catalogs/schemas/tables/volumes" and the observability topics overlap slightly with closely related sibling Databricks skills (e.g. databricks-core catalog exploration). This fits 'mostly distinct; minor overlap risk' rather than the minimal-conflict top anchor.

4 / 5

Total

18

/

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

Warning

Total

14

/

16

Passed

Repository

databricks/databricks-agent-skills

Path

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