databricks-iceberg — Claude Code skill: Iceberg tables on Databricks
databricks-iceberg — a skill for creating and managing Apache Iceberg tables on Databricks, syncing Delta with Iceberg via UniForm, and exposing tables to external engines through REST Catalog.
no license 327 installs ★ 408 updated 2026-10-24
npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a claude-codeWhat databricks-iceberg does
The skill teaches the agent three core patterns: managed Iceberg tables that read and write as Iceberg everywhere; Delta tables with UniForm, which write as Delta in Databricks but read as Iceberg externally; and the Iceberg REST Catalog, which exposes UC tables to external engines (PyIceberg, Spark, Snowflake, Flink) over REST.
It embeds critical rules that prevent data corruption: do not install Iceberg libraries into DBR (version conflicts), do not manually manage metadata paths, choose between PARTITIONED BY and CLUSTER BY correctly, disable deletion vectors on v2 with clustering. The skill teaches which pattern fits each use case and how to set up external engine access with credential vending.
Requires Unity Catalog and Databricks CLI (≥ v1.0.0). Compatible across all listed platforms, but primary commands are SQL DDL/DML.
What it helps with
- create an Iceberg table with correct partitioning for external engine access
- enable reading Delta tables as Iceberg without rewriting data
- configure REST Catalog so PyIceberg or Spark can read UC tables
- integrate Snowflake with Databricks through Iceberg catalog
- prevent version conflicts and metadata corruption when working with Iceberg
Example prompts for the agent
- Create a managed Iceberg table from raw_events, partitioned by event_date
- Enable External Iceberg Reads on my existing customers Delta table via UniForm
- Set up external access to my tables through the Iceberg REST Catalog for a PyIceberg client
How to install databricks-iceberg
1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a claude-code2Manually: put the files in place
~/.claude/skills/databricks-iceberg/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/databricks-iceberg/
1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a codex2Manually: put the files in place
.agents/skills/databricks-iceberg/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a cursor2Manually: put the files in place
.cursor/skills/databricks-iceberg/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install databricks/databricks-agent-skills skills/databricks-iceberg2Manually: put the files in place
.github/skills/databricks-iceberg/SKILL.md1Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a gemini-cli2Platform CLI
gemini skills install https://github.com/databricks/databricks-agent-skills --path skills/databricks-icebergManually: put the files in place
.devin/skills/databricks-iceberg/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about databricks-iceberg
How do I install databricks-iceberg in Claude Code?
Run npx skills add databricks/databricks-agent-skills --skill databricks-iceberg -a claude-code, then check ~/.claude/skills/databricks-iceberg/SKILL.md to verify.
What does databricks-iceberg do?
It equips the agent with knowledge of creating and managing Iceberg tables on Databricks, syncing Delta and Iceberg via UniForm, and granting external engines access to tables through REST Catalog.
Do I need to install an Iceberg library into Databricks Runtime?
No — DBR includes built-in Iceberg support. Adding a library will cause version conflicts and errors.