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

Quality

88%

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.

The body is a well-structured overview: executable SQL covering the common cases, a capability matrix, a scenario-to-reference routing table, and clean one-level-deep progressive disclosure into five substantive reference files. The two weak spots are one overly dense critical-rules bullet and validation guidance for risky ALTER TABLE operations being relegated to the issues table instead of the workflow.

Suggestions

Split the long 'PARTITIONED BY and CLUSTER BY produce the same Iceberg metadata' bullet into a one-line rule plus a compact two-column comparison (syntax / DV-row-tracking handling), moving the explanation of what external engines see into references/1-managed-iceberg-tables.md.

Add an inline validation step after the 'Enable UniForm on an Existing Delta Table' example (e.g., 'Verify with DESCRIBE EXTENDED ... that universalFormat is enabled and Iceberg metadata generation has caught up'), so the check is part of the workflow rather than only appearing under Common Issues.

DimensionReasoningScore

Conciseness

The body is dominated by terse tables, executable SQL, and dense critical rules that add Databricks-specific knowledge Claude cannot be assumed to have. It is not 5 because the 'MUST know that both PARTITIONED BY and CLUSTER BY produce the same Iceberg metadata' bullet is a ~120-word parenthetical wall that should be split into a short rule plus a comparison row in the Quick Start comments; it is not 3 because padding is the exception, not the rule.

4 / 5

Actionability

The Quick Start gives copy-paste-ready SQL for the common cases — including the exact TBLPROPERTIES ('delta.enableDeletionVectors' = false, 'delta.enableRowTracking' = false, 'format-version' = '3') — and the Common Issues table pairs each problem with a concrete fix ('set write.parquet.compression-codec to snappy', 'Check status with DESCRIBE EXTENDED table_name').

5 / 5

Workflow Clarity

The entry workflow is explicit ('MUST determine which Iceberg pattern fits the use case before writing code') with a When to Use routing table mapping every scenario to a reference file, and verification appears in the issues table (DESCRIBE EXTENDED for UniForm async delay). It is not 5 because the risky ALTER TABLE ... SET TBLPROPERTIES operations in Quick Start have no inline validation checkpoint — the check lives only in the Common Issues section.

4 / 5

Progressive Disclosure

The body is a lean overview: a Reference Files table with per-file summaries and keywords, a When to Use routing section, and five real one-level-deep reference files (verified present, 107-349 lines each, no nested references). Content is appropriately split with clear navigation.

5 / 5

Total

18

/

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: it enumerates concrete capabilities, includes the renamed alias '(fka Uniform)', and pairs a clear 'what' with a multi-scenario explicit 'Use when' clause. The only weaknesses are a few missing natural synonyms (Trino, Flink, EMR) and slight trigger overlap with the sibling databricks-pipelines skill.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities ('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') with comprehensive coverage matching the skill's full scope. It is not 4 because there are no meaningful coverage gaps; the enumerated feature set covers every subtopic the skill addresses.

5 / 5

Completeness

Explicitly answers both: what ('Apache Iceberg tables on Databricks — Managed Iceberg tables, ... credential vending') and when ('Use when creating Iceberg tables, enabling External Iceberg Reads ... configuring external engines ... integrating with Snowflake catalog to read Foreign Iceberg tables'). The 'when' clause is explicit with multiple concrete trigger scenarios, matching the 5 anchor.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'creating Iceberg tables', 'enabling External Iceberg Reads (uniform)', 'Snowflake catalog', 'PyIceberg', 'OSS Spark', 'credential vending'. It is not 5 because several natural variations users would say (Trino, Flink, EMR, Delta-Iceberg compatibility) are absent; it is not 3 because the keyword set is broad, natural, and includes the renamed-alias '(fka Uniform)'.

4 / 5

Distinctiveness Conflict Risk

'Apache Iceberg tables on Databricks' carves a clear niche with Iceberg-specific triggers, but the trigger on 'Streaming Tables and Materialized Views via compatibility mode' overlaps with a sibling databricks-pipelines skill, creating minor conflict risk. It is not 5 because of that overlap; it is not 3 because the niche and triggers are otherwise distinct and specific.

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