チュートリアル: Unity Catalog スキルの発見と使用
コーディングエージェントをチームが Unity Catalog に公開したスキルに接続し、任意のエージェントセッションからそれらを発見して使用します。全員が同じガバナンス対象のスキーマを参照するため、既存のものを再構築するのではなく、再利用します。独自のスキルを作成および公開するには、「Unity Catalog スキルの作成と共有」を参照してください。
スキルの使用方法は2通りあります。ディスクにdownloadしてセッションごとに読み込むか、Databricks Skills MCPサーバーからライブで読み込んで常に最新の公開バージョンを取得するかのいずれかです。
要件
- Unity Catalogが有効化されたDatabricksワークスペース、および ワークスペースURL（例:
https://my-company.cloud.databricks.com）。 - マシン上の Python 3.12 以降および uv (
ucodeのインストールに使用)。 - MCP対応のコーディングエージェント (MCP、Model Context Protocolは、エージェントがツールに接続するために使用するオープン標準です)。
USE CATALOG、使用するスキルに対するUSE SCHEMAおよびREAD VOLUME。これらはDatabricks管理者が付与します。コマンドが権限エラーで失敗した場合は、チームのスキーマに対してこれらの権限を管理者にリクエストしてください。
Databricks スキルレジストリに接続する
ucode をインストールし、それを使用してコーディングエージェントをDatabricksワークスペースのスキルレジストリに接続します。
ucode はワークスペースへのサインインを行い、エージェントがスキルのリスト表示、ロード、download に使用する Databricks Skills MCP server (databricks-skill-registry) を登録します。
エージェントにucodeをインストールおよび接続させます：
Install ucode from its Git source and connect my coding agent to Databricks:
1. Run: uv tool install git+https://github.com/databricks/ucode
2. Run: ucode configure --agents <your-agent> --workspaces https://<workspace-host>
3. Run: ucode configure skills
Use <your-agent> = my coding agent (claude, codex, gemini, opencode, or copilot) and
<workspace-host> = my workspace URL host (for example, my-company.cloud.databricks.com).
A browser will open during step 2 for me to sign in.
ご自身で行う場合は、ターミナルで同じコマンドを実行してください：
uv tool install git+https://github.com/databricks/ucode
ucode configure --agents <your-agent> --workspaces https://<workspace-host>
ucode configure skills
<your-agent> を使用するコーディングエージェントの名前（例：claude、codex、gemini、opencode、または copilot）に置き換え、<workspace-host> をワークスペースの URL ホストに置き換えます。ucode configure の実行中にブラウザが開き、サインインするように求められます。その後、エージェントを再起動（ucode <your-agent>）して、新しいツールを読み込めるようにします。
スキルの検出
エージェントに平易な言葉で質問すると、databricks-skill-registry MCP サーバー上の適切なツールが呼び出されます。使用権限のあるスキルのみが表示されます。
スキーマを一覧表示して、その中のすべてのスキルを確認します:
List the Databricks skills in acme.sql_skills.
エージェントは list_skills MCPツールを呼び出し、スキーマの内容を報告します。
スキルの使用
見つかったスキルを使用する方法は3つあります：
- スキルを一度読み込む ：このセッションのみ。保存されたアイテムはありません。単発の利用に最適です。
- download a skill : セッションごと。ディスクにdownloadされるため、セッションごとに自動的にロードされ、オフラインでも動作します。毎日使用する少数の項目に最適です。コピーは時点ごとのデータです。更新するには再downloadしてください。
- スキーマをライブでロード : 常に最新の状態。MCPサーバーのスコープをスキーマ全体に設定することで、その中のすべてのスキルがローカルに保存されることなく、常に利用可能かつ最新の状態に保たれます。大規模で変化の速いセットに最適ですが、接続が必要です。
いずれの場合も、プロンプトとはエージェントに尋ねる内容であり、その後にエージェントが呼び出すツールや実行するコマンドが続きます。
スキルを 1 回読み込む
Use acme.sql_skills.databricks-sql-guide to review this query.
エージェントはload_skill MCPツールを呼び出してスキルの指示をコンテキストに読み込み、スキルがサポートファイルをバンドルしている場合はget_skill_filesします。
download a skill
Download acme.sql_skills.databricks-sql-guide with ucode so I have it every session:
run ucode configure skills --location acme.sql_skills --skill databricks-sql-guide.
ucode configure skills --location acme.sql_skills --skill databricks-sql-guide # one skill
ucode configure skills --location acme.sql_skills --skill databricks-sql-guide,dbt-conventions # several skills
ucode configure skills --location acme.sql_skills # a whole schema
--location はスキルを保持するスキーマです。--skillは、その中のスキル名のコンマ区切りリストにdownloadを絞り込みます。スキーマ内のすべてのスキルを download するには、 --skill を省略します。
その後、エージェントを再起動します（ucode <your-agent>）。ダウンロードしたスキルはローカルのスキルフォルダ（.claude/skills/および.agents/skills/）に保存され、セッションごとに読み込まれます。コマンドを指定せずに試してください。エージェントがタスクをスキルと照合し、それに従います：
Using our SQL guide skill, write a query on samples.nyctaxi.trips for average fare by trip distance.
samples.nyctaxi.trips すべてのワークスペースに存在するため、セットアップなしで機能します。
download スキルは、特定の時点のコピーです。新しいバージョンをdownloadし直すか、スキーマをライブで読み込んで (以下を参照)、常に最新の状態を取得してください。
スキーマをライブでロード
Databricks Skills MCPサーバーをスキーマにスコープ設定し、その中のすべてのスキルが ライブツール として公開されるようにします。
Load the skills in acme.sql_skills live so I always get the latest version:
run ucode configure skills --location acme.sql_skills --mcp.
ucode configure skills --location acme.sql_skills --mcp
その後、エージェントを再起動して (ucode <your-agent>)、スキーマのスキルがロードされるようにします。acme.sql_skills 内のすべてのスキルが、skill_acme.sql_skills.<skill> という名前のライブツールとして表示されます。タスクがスキルの説明と一致すると、エージェントはオンデマンドでそのスキルをロードします。新しいバージョンを公開すると、接続しているすべてのユーザーが直ちにそのバージョンを取得できます。これは、中央チームが Git から同期を維持しているスキーマと適切に連携します。
ライブロードは、一度にスキーマ全体に対して機能します。単一のスキルにスコープを設定することはできません。スキーマ全体をロードせずに1つのスキルのみを使用するには、代わりにワンオフとしてロードしてください。
サポートされているエージェントの場合、ucode はライブスキルを自動的に読み込むように接続を構成します。他のエージェントには、オンにする必要がある独自の「常に読み込む」（または同等の）設定が公開されている場合があります。
リファレンス
ucode はオープンソースです。完全な最新のコマンドリファレンスについては、ucodeリポジトリを参照してください。このチュートリアルで使用するコマンドは、上記のステップ内にインラインで記載されています。
スキルツール （接続後、エージェントがdatabricks-skill-registry MCPサーバー上でこれらを呼び出します）：
ツール | 目的 |
|---|---|
| 1つのスキーマ内のスキルをリスト表示する |
| スキルの指示を現在のセッションに読み込む |
| スキルから特定のバンドルファイルを取得する |
次のステップ
- このチュートリアルの背景にある概念については、「Unity Catalog スキルとは」を参照してください。
- Unity Catalogスキルを作成して共有し、独自のスキルを公開します。
- スキルの管理：スキルを読み取りおよび共有できるユーザーを制御する権限を設定します。