注: このドキュメントセットは、Gemini Enterprise の Standard、Plus、従量課金、Frontline エディションを対象としています。Business エディションのドキュメントについては、Gemini Enterprise - Business エディションのヘルプセンターをご覧ください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

スキルを作成して管理する

スキルとは、Gemini Enterprise アシスタントが特定のタスク（法的契約の確認やブランドの声での執筆など）を実行するのに役立つ、再利用可能なカスタム指示です。

各スキルは、SKILL.md プロンプトファイルを含むパッケージです。スキルパッケージには、アシスタントがタスクを完了するために使用するスクリプト、ファイル、バックグラウンドコンテキストを含めることもできます。デフォルトでは、Gemini Enterprise は作成したスキルを有効にします。

サポートされるエディション

スキルを作成、アップロード、使用できるかどうかは、サブスクライブしている Gemini Enterprise エディションによって異なります。

Standard、Plus、従量課金制: カスタムスキルを作成してアップロードできます。また、Google が管理するスキルと、共有されたユーザー作成スキルを使用できます。
Frontline: Google が管理するスキルと、共有されているユーザー作成スキルを閲覧、インストール、使用できます。カスタムスキルを作成またはアップロードすることはできません。

概要

スキルの主な側面は次のとおりです。

オープンスタンダード: オープンスキルスタンダードに基づいて構築された各スキルは、コア SKILL.md ファイルによって定義され、追加のファイルやスクリプトで拡張できます。
モジュラー拡張: スキルを使用すると、カスタム指示とコンテキストを使用して、エージェントにドメイン固有のタスクを教えることができます。
動的アクセス: Gemini Enterprise は、質問やタスクに関連する専門的な指示に自動的にアクセスします。

スキルを作成して

Gemini Enterprise ウェブアプリで新しいスキルを作成する手順は次のとおりです。

Gemini Enterprise ウェブアプリにログインします。
ナビゲーションメニューで [スキル] をクリックします。
追加アイコンをクリックし、[Gemini でスキルを作成] をクリックします。
スキルの名前を入力します。
説明を入力します。Gemini Enterprise は、この説明を使用して、スキルがプロンプトやタスクに役立つかどうかを判断します。説明にトリガー指示を追加して、Gemini Enterprise をガイドすることもできます。
チャットボックスまたは [指示] フィールドに、自然言語でスキルの指示を入力します。カスタムの Markdown または YAML フロントマターを含む既存の SKILL.md ファイルを使用してスキルを作成するには、スキルをアップロードするをご覧ください。
[保存] をクリックします。Gemini Enterprise では、新しいスキルがデフォルトで有効になります。

スキルのアップロード

既存のスキルを追加するには、マークダウンファイルまたは ZIP ファイルとしてアップロードします。Gemini Enterprise は、SKILL.md ファイルからスキルの名前と説明を自動的に抽出します。

スキルファイルのファイル形式とディレクトリ構造

スキルパッケージは、必須の SKILL.md プロンプトファイルと、スクリプト、リファレンスドキュメント、アセット用のオプションのサブディレクトリで構成されます。スタンドアロンの SKILL.md ファイル、または次のディレクトリ構造を持つ ZIP アーカイブをアップロードできます。

my-skill/
├── SKILL.md              # Required: YAML frontmatter + Markdown instructions
├── scripts/              # Optional: executable helper scripts (Python, Bash)
├── references/           # Optional: supplementary context loaded as needed
└── assets/               # Optional: templates or images used in output

ファイルまたはディレクトリ	必須	説明
`SKILL.md`	はい	スキルの YAML フロントマターメタデータ（`name` や `description` など）と、Gemini Enterprise アシスタントをガイドするマークダウン指示が含まれます。
`scripts/`	いいえ	決定的または繰り返しのオペレーション用の実行可能な Python または Bash ヘルパースクリプト。
`references/`	いいえ	スキーマ、チートシート、API リファレンスドキュメントなど、オンデマンドで読み込まれる補足コンテキスト。
`assets/`	いいえ	Gemini Enterprise のプロンプトコンテキストに直接読み込まれない、出力で使用されるファイル（テンプレートや画像など）。

YAML フロントマターの要件

SKILL.md ファイルは、ファイルの先頭で --- 区切り文字で囲まれた有効な YAML フロントマターブロックで始まり、その後に Markdown の指示本文が続く必要があります（ハードリミットは 500,000 文字です。この上限を超えるアップロードは失敗します）。

YAML frontmatter は、次のフィールドをサポートしています。

フィールド	必須	形式と制約
`name`	はい	スキルの固有識別子（1 ～ 64 文字）。使用できるのは、英小文字（`a-z`）、数字（`0-9`）、ハイフン（`-`）のみです。先頭または末尾をハイフン（`-`）にすることはできません。また、連続するハイフン（`--`）を含めることはできません。フォルダ内にアップロードする場合、`name` 値は親フォルダ名と一致する必要があります。
`description`	はい	スキルが何を行うか、Gemini Enterprise がいつ呼び出すかを説明する機能説明（1 ～ 1,024 文字）。Gemini Enterprise がスキルが関連するタイミングを特定できるように、トリガーキーワードを含めます。これはハードリミットです。説明が 1,024 文字を超えると、スキルのアップロードは失敗し、エラー `A field in your SKILL.md is too long. Shorten the name, description or the instructions.` が発生します。
`license`	いいえ	スキルパッケージに適用されるソフトウェアまたはコンテンツ配布ライセンス（最大 1,024 文字）。オープンソースの SPDX ライセンス識別子（`Apache-2.0` や `MIT` など）や `Proprietary` など。このフィールドには、Gemini Enterprise 企業ユーザーまたはアプリのサブスクリプションライセンスではなく、スキルファイル自体の利用規約を指定します。指定する場合、値を空にすることはできません。
`metadata`	いいえ	カスタムタグ、作成者、バージョンパラメータのオプションの Key-Value マップ。キーはスカラー文字列、値はスカラー文字列またはスカラー文字列のリストにする必要があります。

`SKILL.md` ファイルの例

次の例は、有効な SKILL.md ファイルを示しています。

---
name: brand-voice-reviewer
description: Reviews marketing copy and legal contracts to ensure compliance with brand voice guidelines. Use when asked to review, edit, or draft customer-facing text.
---

# Brand Voice Reviewer

Follow these guidelines when reviewing or drafting customer-facing text:

1. Use clear, concise, and active language.
2. Avoid jargon and unverified claims.
3. Verify that terminology aligns with the company style guide.

ZIP アーカイブの制約

スキルを ZIP アーカイブとしてアップロードする場合は、アーカイブが次の検証要件を満たしていることを確認してください。

単一の SKILL.md ファイル: 各 ZIP アーカイブには、アーカイブルート（SKILL.md）または単一の最上位ラッパーフォルダ（my-skill/SKILL.md など、最大 3 レベルの深さ）に配置された SKILL.md ファイルが 1 つだけ含まれている必要があります。
アーカイブサイズ: 圧縮された ZIP アーカイブの最大サイズは 100 MB、非圧縮時の合計サイズは 100 MB 以下。
ファイル数: ZIP アーカイブあたり最大 100 個。
ディレクトリのネストの深さ: スキルルートを基準としたディレクトリのネストの深さは最大 10 レベルです。
パスの整合性: 重複するファイルパスと親ディレクトリ参照（..）は使用できません。

ウェブアプリにスキルをアップロードする

スキルをアップロードする手順は次のとおりです。

Gemini Enterprise ウェブアプリにログインします。
ナビゲーションメニューで [スキル] をクリックします。
追加アイコンをクリックし、[スキルをアップロード] をクリックします。
Markdown ファイルまたは ZIP ファイルをドラッグするか、参照して、[インポート] をクリックします。Gemini Enterprise では、このスキルがデフォルトで有効になっています。

注: アップロードが失敗し、

Upload failed.
Details: Request contains an invalid argument

などのエラーが発生した場合は、次の点を確認してください。

SKILL.md ファイルは、--- 区切り文字で囲まれた有効な YAML フロントマターで始まります。
フロントマターには、必須の name フィールドと description フィールドが文字数制限内で含まれています。
name フィールドには、小文字、数字、ハイフンのみを使用します（ZIP アーカイブでアップロードする場合は、親フォルダ名と一致します）。
アーカイブが ZIP アーカイブの制約に準拠している。

スキルを参照

スキルを閲覧してインストールするには、次のセクションを使用してリストをフィルタします。

セクション	説明
すべて	Google が管理するスキルとユーザーが作成したスキルの両方。
Google	Google が提供する組み込みスキル。
共有アイテム	他のユーザーが共有した、読み取り専用のユーザー作成スキル。

スキルを閲覧してインストールする手順は次のとおりです。

Gemini Enterprise ウェブアプリにログインします。
ナビゲーションメニューで [スキル] をクリックします。
追加アイコンをクリックし、[スキルを参照] をクリックします。
使用するスキルを見つけて、[+ インストール] をクリックします。

スキルを更新する

既存のスキルを更新する手順は次のとおりです。

Gemini Enterprise ウェブアプリにログインします。
ナビゲーションメニューで [スキル] をクリックします。
更新するスキルの名前をクリックします。
スキルの横にあるアイコンをクリックし、[編集] をクリックします。
手順、名前、説明に必要な更新を加えます。
[保存] をクリックします。

[スキル] ページに戻るには、 [スキル] をクリックします。

スキルを共有する

Gemini Enterprise 管理者がスキル共有を有効にしている場合、作成したスキルを他のユーザーと共有できます。

スキルを共有する手順は次のとおりです。

Gemini Enterprise ウェブアプリにログインします。
ナビゲーションメニューで [スキル] をクリックします。
作成したスキルの中から、共有するスキルを見つけます。
スキルの横にあるアイコンをクリックし、[共有] をクリックします。
[スキルを共有] ダイアログで、スキルを共有するユーザーのメールアドレスをカンマ区切りで入力します。
[完了] をクリックします。

スキルを使用する

スキルは、Gemini Enterprise ウェブアプリのチャット会話内で直接使用できます。

[スキル] ページからスキルをテストする

スキルをテストするには、[スキル] ページから直接、そのスキルを使用して新しいチャットセッションを開始します。

Gemini Enterprise ウェブアプリにログインします。
ナビゲーションメニューで [スキル] をクリックします。
スキルの横にあるアイコンをクリックし、[新しいチャット] をクリックします。Gemini Enterprise で、選択したスキルを参照する新しいチャットが開きます。

会話でスキルを呼び出す

会話中にスキルを動的に呼び出して、アシスタントのレスポンスをカスタマイズできます。

Gemini Enterprise アシスタントとチャットする際に、次の方法でスキルを使用できます。

手動メンション: チャットボックスの @ または / メンション機能（@Brand Voice や /Brand Voice など）を使用して、スキルを明示的に呼び出すことができます。/ と入力すると、使用可能なスキルのみを表示するメニューが開き、@ と入力すると、一般的なメンションメニューが開きます。
直接リクエスト: Gemini Enterprise に特定のスキルを使用させる必要がある場合は、プロンプトで直接リクエストできます。例: Use the brand voice skill to review this
自動選択: Gemini Enterprise は、スキルの説明とトリガー指示に基づいて、タスクに関連するスキルを自動的に使用します。

スキルをオフにする

Gemini Enterprise が特定のスキルを使用しないようにするには、そのスキルをオフにします。スキルをオフにすると、Gemini Enterprise は会話でそのスキルを呼び出しません。

スキルをオフにする手順は次のとおりです。

Gemini Enterprise ウェブアプリにログインします。
ナビゲーションメニューで [スキル] をクリックします。
[スキル] ページで、オフにするスキルを見つけます。
スキルの横にある切り替えボタンをクリックしてオフにします。

スキルをアンインストールする

インストール済みのスキルを [スキル] ページから削除する手順は次のとおりです。

Gemini Enterprise ウェブアプリにログインします。
ナビゲーションメニューで [スキル] をクリックします。
スキルの横にあるアイコンをクリックし、[アンインストール] をクリックします。

スキルの状態

スキルを自分で有効または無効にすることに加えて、管理者がスキルの状態を変更することもできます。これにより、スキルの可用性が影響を受けます。

一時停止: 管理者がスキルを一時的に無効にしています。[スキル] ページには一時停止ステータスで表示されますが、管理者が再度有効にするまで、他のユーザーは会話で呼び出すことができません。スキルのオーナーは、スキルを更新してテストできます。
無効: 管理者がスキルを他のユーザーに一時的に非表示にし、[スキル] ページから削除します。スキルはスキルオーナーに表示されたままになり、管理者が再度有効にするまで、スキルオーナーはスキルを更新してテストできます。
削除済み: 管理者が Gemini Enterprise ウェブアプリからスキルを完全に削除したため、使用できなくなりました。

制限事項

このセクションでは、Gemini Enterprise のスキルの制限事項について説明します。

スキルはエージェントで使用できません。
スキルは Python と Bash の実行のみをサポートしています。
ウェブアプリエディタでは、フォームフィールドに指示を入力するか、アシスタントとチャットすることでスキルを作成できます。これにより、1 つの SKILL.md ファイルが自動的に生成されます。追加のスクリプトやファイルを必要とする複雑なスキルは、ZIP ファイルとしてアップロードする必要があります。
自然言語スキル作成では、会話コンテキストやコネクタを入力として使用してスキルを作成することはありません。
スキルに SKILL.md ファイルが 1 つしかない場合、スキルは Canvas で最適に機能します。
SKILL.md ファイルには、name の場合は 64 文字、description の場合は 1,024 文字、Markdown の指示本文の場合は 500,000 文字という厳格な長さ制限があります。アップロードする ZIP アーカイブは、100 MB（圧縮または非圧縮）、100 ファイル、10 レベルのディレクトリネストを超えることはできません。

次のステップ

管理者がスキルを管理する方法を確認する。