Official agent skill

Databricks Unity Catalog

by databricks in databricks/databricks-agent-skills

Unity Catalog governance, access control, and observability.

OfficialCustom licenceAuto-check passedGame Development

Install Databricks Unity Catalog

skills CLI
$ npx skills add databricks/databricks-agent-skills --skill databricks-unity-catalog -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install databricks/databricks-agent-skills databricks-unity-catalog --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/databricks/databricks-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/databricks-unity-catalog .claude/skills/databricks-unity-catalog && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
databricks-unity-catalog
GitHub stars
345
Token cost
~3k tokens
SKILL.md length
860 words
Files
11 (incl. references, assets)
Skills in repo
32
Repo updated
First seen
Licence
Custom licence

At a glance

Unity Catalog governance, access control, and observability.

  • Works in 5 steps: Grant minimal access - Apply least… → Filter by date - System tables can be… → Use appropriate retention - Check your… → …
  • Revoke access (GRANT/REVOKE)
  • SKILL.md covers When to Use This Skill, Reference Files, Quick Start and Running SQL from the CLI, plus 3 more sections
  • Calls databricks

What it does

Databricks Unity Catalog is an agent skill from databricks/databricks-agent-skills, published by the product's own GitHub organization. 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/.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including reference files and assets (for example `agents/openai.yaml`, `references/1-access-control.md` and `references/2-external-locations.md`). Compatibility notes: Requires databricks CLI (= v1.0.0)

It sits in Game Development, covering Authorization and RBAC and Observability. It works with Databricks. The repository describes itself as: Databricks AI Tools: skills and plugins for building on Databricks with Claude Code, Cursor, Codex, GitHub Copilot, and other AI coding agents.

When your agent uses it

  • 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

Example prompts

  • “who can read this table”
  • “/databricks-unity-catalog”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): Requires databricks CLI (>= v1.0.0)

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Grant minimal access - Apply least privilege; grant at the narrowest securable that works
  2. Filter by date - System tables can be large; always use date filters
  3. Use appropriate retention - Check your workspace's retention settings
  4. Schedule reports - Create scheduled queries for regular monitoring
  5. Prefer SQL/SDK over experimental CLI - For anything beyond quick checks

What it can do on your machine

Read from SKILL.md and the folder at commit f4fcec5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • databricks

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.databricks.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires databricks CLI (>= v1.0.0)

    From compatibility in the SKILL.md frontmatter.

Context cost

Databricks Unity Catalog loads about 3k tokens when it runs, and up to ~24k if it reads all its reference files. Until then it costs about 110 tokens; SKILL.md has 860 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~110
When it runs · the whole SKILL.md, loaded when a task matches
~3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~24k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 860 words (~3,038 tokens).

“Guidance for Unity Catalog governance — access control, the privilege model, external locations, securable DDL, and fine-grained access — plus system tables and volume file operations.”

— opening of SKILL.md by databricks, Custom licence
name
databricks-unity-catalog
compatibility
Requires databricks CLI (>= v1.0.0)
metadata.version
0.3.0
parent
databricks-core

Read the full SKILL.md on GitHub

Files

SKILL.md and 10 other files (references, assets) in skills/databricks-unity-catalog of databricks/databricks-agent-skills.

  • SKILL.md
  • agents/openai.yaml
  • assets/databricks.png
  • assets/databricks.svg
  • references/1-access-control.md
  • references/2-external-locations.md
  • references/3-securables-ddl.md
  • references/4-fine-grained-access.md
  • references/5-system-tables.md
  • references/6-volumes.md
  • references/7-data-profiling.md

Open the folder on GitHubat commit f4fcec5

Compare with similar skills

Databricks Unity Catalog next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Databricks Unity Catalog compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Databricks Unity Catalog this skilldatabricks/databricks-agent-skills345—~3kAutomated safety check: PassCustom licence
Neonsmontlouis/bible-strong171—~7.1kAutomated safety check: NotesGPL-3.0
Security Sensitive Path InstrumenterArabelaTso/Skills-4-SE253—~1.1kAutomated safety check: PassApache-2.0
Azure Data ExplorerMicrosoftDocs/Agent-Skills775—~4.9kAutomated safety check: PassCC-BY-4.0
Databricks CLIaehrc/pathling137—~2.1kAutomated safety check: PassApache-2.0
Cookbook External Servicesdatabricks-solutions/databricks-apps-cookbook183—~1.1kAutomated safety check: PassCustom licence

Similar skills

  • Neon

    smontlouis/bible-strong

    Overview of Neon, a complete set of cloud backend primitives for apps and agents, spanning Lakebase Postgres, Auth, the Data API, Object Storage, Compute Functions, and the AI Gateway.

    171 GitHub stars~7.1k tokensUpdated today
    Backend & APIsAuto-check: notes
  • Instruments authentication, authorization, and input-handling code paths to monitor security-relevant events and states at runtime.

    253 GitHub stars~1.1k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Azure Data Explorer

    MicrosoftDocs/Agent-Skills

    Official

    Expert knowledge for Azure Data Explorer development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration…

    775 GitHub stars~4.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Databricks CLI

    aehrc/pathling

    Expert guidance for using the Databricks CLI to manage Databricks workspaces, clusters, jobs, pipelines, Unity Catalog, SQL warehouses, serving endpoints, secrets, bundles, and all other Databricks…

    137 GitHub stars~2.1k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Cookbook External Services

    databricks-solutions/databricks-apps-cookbook

    Connect Databricks Apps to external services using Unity Catalog HTTP connections and retrieve Databricks secrets.

    183 GitHub stars~1.1k tokensUpdated 3 days ago
    Game DevelopmentAuto-check passed
  • Cookbook Unity Catalog

    databricks-solutions/databricks-apps-cookbook

    Browse Unity Catalog objects (catalogs, schemas) from Databricks Apps.

    183 GitHub stars~899 tokensUpdated 3 days ago
    Game DevelopmentAuto-check passed

More from databricks/databricks-agent-skills

All 32 skills in this repo
  • Databricks Dbsql

    databricks/databricks-agent-skills

    Official

    Databricks SQL (DBSQL) advanced features and SQL warehouse capabilities.

    345 GitHub starsUsed in 1 repo~2.8k tokens
    Auto-check passed
  • Databricks Synthetic Data Gen

    databricks/databricks-agent-skills

    Official

    Generate realistic synthetic data using Spark + Faker (strongly recommended).

    345 GitHub stars~3.2k tokensUpdated yesterday
    Auto-check passed
  • Databricks Model Serving

    databricks/databricks-agent-skills

    Official

    Databricks Model Serving endpoint lifecycle and ops. An agent skill from databricks/databricks-agent-skills.

    345 GitHub starsUsed in 1 repo~3.3k tokens
    Auto-check passed
  • Databricks Python SDK

    databricks/databricks-agent-skills

    Official

    Databricks development guidance including Python SDK, Databricks Connect, CLI, and REST API.

    345 GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed
  • Databricks Spark Structured Streaming

    databricks/databricks-agent-skills

    Official

    Comprehensive guide to Spark Structured Streaming for production workloads.

    345 GitHub starsUsed in 1 repo~956 tokens
    Auto-check passed
  • Databricks App Design

    databricks/databricks-agent-skills

    Official

    Design the UX of custom-code Databricks Apps (AppKit/React) data screens — KPI/overview pages, reports, charts, tables, and Genie/chat data assistants — mapped to concrete AppKit components.

    345 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Databricks Unity Catalog

What does Databricks Unity Catalog do?

Unity Catalog governance, access control, and observability. Databricks Unity Catalog is an agent skill from databricks/databricks-agent-skills, published by the product's own GitHub organization. Unity Catalog governance, access control, and observability.

When should I use Databricks Unity Catalog?

Databricks Unity Catalog fits situations like: 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.

How do I install Databricks Unity Catalog in Claude Code?

Run `npx skills add databricks/databricks-agent-skills --skill databricks-unity-catalog -a claude-code`. Or copy the skill folder (skills/databricks-unity-catalog in databricks/databricks-agent-skills) into .claude/skills/databricks-unity-catalog in your project. Claude Code loads it when a task matches its description.

How do I install Databricks Unity Catalog in Codex?

Run `npx skills add databricks/databricks-agent-skills --skill databricks-unity-catalog -a codex`. Or copy the skill folder (skills/databricks-unity-catalog in databricks/databricks-agent-skills) into .agents/skills/databricks-unity-catalog in your project. Codex loads it when a task matches its description.

Can I use Databricks Unity Catalog in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add databricks/databricks-agent-skills --skill databricks-unity-catalog -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/databricks-unity-catalog, .gemini/skills/databricks-unity-catalog, .github/skills/databricks-unity-catalog and .opencode/skills/databricks-unity-catalog in your project.

What does Databricks Unity Catalog need to run?

Going by SKILL.md and its folder, Databricks Unity Catalog needs the command-line tools its instructions call (databricks). Our summary lists: Python 3. Compatibility (from SKILL.md): Requires databricks CLI (>= v1.0.0).

Does Databricks Unity Catalog access the network?

SKILL.md names 1 domain. As links in the text: docs.databricks.com. This is read from the text; nothing was executed.

Is Databricks Unity Catalog safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Databricks Unity Catalog use?

Databricks Unity Catalog has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Databricks Unity Catalog use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 21k tokens, read only when the agent opens those files.

What are the alternatives to Databricks Unity Catalog?

Skills that share tags, products or a category with Databricks Unity Catalog: Neon (smontlouis/bible-strong, 171 stars), Security Sensitive Path Instrumenter (ArabelaTso/Skills-4-SE, 253 stars), Azure Data Explorer (MicrosoftDocs/Agent-Skills, 775 stars) and Databricks CLI (aehrc/pathling, 137 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Databricks Unity Catalog?

databricks (a GitHub organization, an official publisher) maintains it in databricks/databricks-agent-skills, which has 345 GitHub stars. The repository holds 32 skills in this directory. The repository was last updated on October 6, 2026.

Source: databricks/databricks-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.