CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

databricks-iceberg

Apache Iceberg tables on Databricks — Managed Iceberg tables, External Iceberg Reads (fka Uniform), Compatibility Mode, Iceberg REST Catalog (IRC), Iceberg v3, Snowflake interop, PyIceberg, OSS Spark, external engine access and credential vending. Use when creating Iceberg tables, enabling External Iceberg Reads (uniform) on Delta tables (including Streaming Tables and Materialized Views via compatibility mode), configuring external engines to read Databricks tables via Unity Catalog IRC, integrating with Snowflake catalog to read Foreign Iceberg tables

72

Quality

91%

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

86%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 reference-hub skill: executable Quick Start SQL, a decision-routing section, a capability matrix, and a clean troubleshooting table, all fronting five genuine one-level-deep reference files. The two weaknesses are mild — one bloated run-on rule bullet and verification steps that live in the issues table instead of being embedded as checkpoints in the UniForm workflow.

Suggestions

Convert the ~120-word PARTITIONED BY vs CLUSTER BY rule bullet into a compact comparison table (columns: syntax, engine support, DV/row-tracking handling) — the same information in a fraction of the tokens.

Add an inline verification step to the UniForm Quick Start (e.g., step 2: check metadata conversion with `DESCRIBE EXTENDED my_catalog.my_schema.customers` before relying on external reads) so the risky ALTER workflow has an explicit checkpoint.

Move version-sensitive details (DBR 18 LTS+ / Iceberg 1.9.0+ requirements, v2-vs-v3 differences) into a short "Compatibility / version notes" subsection so dated version numbers don't age the main flow.

DimensionReasoningScore

Conciseness

The body is dominated by dense, high-signal tables, terse MUST rules, and code, but the PARTITIONED BY / CLUSTER BY rule is a ~120-word run-on sentence that would be clearer as a small table, and version-sensitive details ("DBR 18 LTS+", "Iceberg library 1.9.0+") sit in the main flow rather than a compatibility/deprecated section. This fits the efficient-with-minor-trimmable-instances anchor at 4; it never explains concepts Claude already knows, so it stays above 3.

4 / 5

Actionability

Quick Start provides copy-paste-ready SQL for all three table-creation patterns with exact TBLPROPERTIES, plus an executable ALTER TABLE for enabling UniForm, and Common Issues gives concrete commands and properties ("set `write.parquet.compression-codec` to `snappy`", "Check status with `DESCRIBE EXTENDED`"). Specific executable examples cover the common cases, matching the fully-executable anchor at 5.

5 / 5

Workflow Clarity

A "MUST determine which Iceberg pattern fits" rule plus the When-to-Use routing table establishes a clear decision sequence, and verification guidance exists (DESCRIBE EXTENDED status checks), but the UniForm enable workflow lacks an inline verify checkpoint — status checking appears only later in Common Issues. This fits the clear-sequence-with-minor-validation-gaps anchor at 4 rather than the explicit-checkpoint anchor at 5.

4 / 5

Progressive Disclosure

A ~150-line overview routes to five real, one-level-deep reference files (all verified to exist and contain substantive content, with only sibling cross-links, no nested chaining), each with a summary, keyword list, and When-to-Use routing entry. Content is appropriately split (1,130 lines of detail in references vs. a lean overview), matching the clear-overview/well-signaled-references anchor at 5.

5 / 5

Total

18

/

20

Passed

Description

96%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, and written in third person with an explicit multi-clause "Use when" trigger set covering every sub-feature, including the legacy "Uniform" synonym. The only (minor) risk is partial overlap with sibling Databricks or Snowflake-focused skills on the interop triggers.

DimensionReasoningScore

Specificity

Lists multiple concrete actions across all sub-features — "creating Iceberg tables", "enabling External Iceberg Reads (uniform) on Delta tables", "configuring external engines to read Databricks tables via Unity Catalog IRC", "integrating with Snowflake catalog to read Foreign Iceberg tables" — with comprehensive coverage of managed tables, UniForm, compatibility mode, IRC, Iceberg v3, PyIceberg, OSS Spark, and credential vending. This matches the anchor for multiple specific concrete actions with comprehensive coverage; no meaningful gaps pull it to 4.

5 / 5

Completeness

The first sentence explicitly answers "what" by enumerating concrete capabilities, and "Use when creating..., enabling..., configuring..., integrating with Snowflake catalog..." explicitly answers "when" with concrete trigger phrases. This mirrors the anchor example that clearly and explicitly answers both what and when; nothing is left merely implied.

5 / 5

Trigger Term Quality

Natural user phrases are comprehensively covered with synonyms: "Iceberg tables", "External Iceberg Reads (fka Uniform)" (explicitly includes the legacy name), "Streaming Tables and Materialized Views", "Snowflake", "PyIceberg", "OSS Spark". These are the terms a user would naturally say when needing this skill; synonym coverage is essentially complete, so it exceeds the good-coverage anchor at 4.

5 / 5

Distinctiveness Conflict Risk

The description occupies a clear Iceberg-on-Databricks niche with distinct triggers (UniForm, IRC, compatibility mode), but "Snowflake interop" and the Delta-table triggers carry minor overlap risk with closely related Databricks-Delta, Unity Catalog, or Snowflake skills. It fits the mostly-distinct anchor at 4 rather than the minimal-conflict anchor at 5, while being far more specific than the overlap examples at 3.

4 / 5

Total

19

/

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

Warning

Total

14

/

16

Passed

Repository

databricks/databricks-agent-skills

Path

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