エージェント スキルの追加 GitHub Copilot

特定のタスクで動作する Copilotの動作と機能を変更できます。

この記事で

メモ

エージェント スキルは、Copilot クラウドエージェントでGitHub Copilot CLI（コマンドラインインターフェース）、Visual Studio Code、およびエージェント モードで動作します。

エージェント スキルは、関連がある場合に特殊なタスクのパフォーマンスを向上させるために読み込むことができる命令、スクリプト、およびリソースのフォルダーです。 詳細については、「エージェントのスキルについて」を参照してください。

スキルの作成と追加

エージェント スキルを作成するには、 SKILL.md ファイルと、必要に応じて、 SKILL.md の手順で参照する補助 Markdown ファイルやスクリプトなどの他のリソースを記述します。

  1. まだ作成していない場合は、次のいずれかの場所に skills ディレクトリを作成します。 ここで、スキルや、将来作成する可能性のあるその他のスキルを見つけることができます。

    1 つのリポジトリに固有の プロジェクト スキルの場合は、リポジトリに .github/skills、 .claude/skills、または .agents/skills ディレクトリを作成します。

           **個人のスキル**の場合は、プロジェクト間で共有し、ローカル ホーム ディレクトリに`~/.copilot/skills`、`~/.claude/skills`、または`~/.agents/skills`ディレクトリを作成します。

  2.        `skills` ディレクトリ内に、新しいスキルのサブディレクトリを作成します。 各スキルには、独自のディレクトリ (たとえば、 `.github/skills/webapp-testing`) が必要です。

    スキルサブディレクトリ名は小文字で、スペースにはハイフンを使用する必要があります。

  3. スキルサブディレクトリで、スキルの指示を含む SKILL.md ファイルを作成します。

    重要

    スキル ファイルには、 SKILL.mdという名前を付ける必要があります。

           `SKILL.md` ファイルは、YAML frontmatter を含む Markdown ファイルです。 最も単純な形式では、次のものが含まれます。
    • YAMLフロントマター
      • name (必須): スキルのユニークな識別子。 スペースにはハイフンを使用して、小文字にする必要があります。 通常、これはスキルのディレクトリの名前と一致します。
      • description (必須): スキルが実行する内容と、それを使用する必要があるタイミング Copilot 説明。
      • license (省略可能): このスキルに適用されるライセンスの説明。
    • Copilotが従う手順、例、ガイドラインを含む Markdown 本文。

  4. 必要に応じて、スキルのディレクトリにスクリプト、例、またはその他のリソースを追加します。

    詳細については、「スキルでスクリプトを実行できるようにする」を参照してください。

          `SKILL.md` ファイルの例

          **プロジェクト スキル**の場合、このファイルはリポジトリの`.github/skills/github-actions-failure-debugging` ディレクトリにあります。

          **個人のスキル**の場合、このファイルは `~/.copilot/skills/github-actions-failure-debugging` ディレクトリにあります。
Markdown
---
name: github-actions-failure-debugging
description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.
---

To debug failing GitHub Actions workflows in a pull request, follow this process, using tools provided from the GitHub MCP Server:

1. Use the `list_workflow_runs` tool to look up recent workflow runs for the pull request and their status
2. Use the `summarize_job_log_failures` tool to get an AI summary of the logs for failed jobs, to understand what went wrong without filling your context windows with thousands of lines of logs
3. If you still need more information, use the `get_job_logs` or `get_workflow_run_logs` tool to get the full, detailed failure logs
4. Try to reproduce the failure yourself in your own environment.
5. Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.

スキルでスクリプトを実行できるようにする

スキルが呼び出されると、 Copilot はスキルのディレクトリ内のすべてのファイルを自動的に検出し、スキルの指示と共に使用できるようにします。 つまり、スキル ディレクトリにスクリプトやその他のリソースを含め、 SKILL.md の手順でそれらを参照できます。

スクリプトを実行するスキルを作成するには:

  1.        **スキルのディレクトリにスクリプトを追加します。** たとえば、SVG 画像を PNG に変換するスキルは、次の構造を持つ場合があります。

    .github/skills/image-convert/
├── SKILL.md
└── convert-svg-to-png.sh

  2.        **必要に応じて、スキルに必要なツールを事前に承認します。** 
       `SKILL.md` frontmatter では、[`allowed-tools`] フィールドを使用して、毎回確認を求めずに使用できるツールCopilot一覧表示できます。 ツールが [ `allowed-tools` ] フィールドに表示されていない場合は、 Copilot を使用する前にアクセス許可を求められます。

    ---
name: image-convert
description: Converts SVG images to PNG format. Use when asked to convert SVG files.
allowed-tools: shell
---

    警告

    このスキルと参照されているスクリプトを確認し、そのソースを完全に信頼している場合にのみ、 shell または bash ツールを事前に承認してください。 shellまたはbashを事前に承認すると、ターミナル コマンドを実行するための確認手順が削除され、攻撃者が制御するスキルやプロンプトインジェクションが環境内で任意のコマンドを実行できるようになります。 不明な場合は、shellからbashとallowed-toolsを省略して、Copilotがターミナル コマンドを実行する前に明示的な確認を要求する必要があります。

  3.        **スクリプトの使用方法 Copilot 指示する手順を記述します。** 
       `SKILL.md`の Markdown 本文で、スクリプトを実行するタイミングと方法について説明します。

    When asked to convert an SVG to PNG, run the `convert-svg-to-png.sh` script
from this skill's base directory, passing the input SVG file path as the
first argument.

他のユーザーが作成したスキルの追加

独自のスキルを作成するだけでなく、他のユーザーが作成したスキルを追加することもできます。

ヒント

          `gh skill`のGitHub CLIを使用して、エージェント スキルの検索、インストール、更新、発行を行うこともできます。 詳細については、「[AUTOTITLE](/copilot/how-tos/use-copilot-agents/cloud-agent/add-skills#managing-skills-with-github-cli)」を参照してください。

  1. スキル ディレクトリ (つまり、SKILL.md ファイルを含むディレクトリ、および必要に応じて他のファイルとサブディレクトリ) をダウンロードします。

    たとえば、Awesome GitHub Copilot リポジトリ ( https://awesome-copilot.github.com/skills/) からスキルをダウンロードします。

  2.        `.zip` ファイルをダウンロードした場合は、これを解凍します。

  3. スキル ディレクトリを必要な場所に移動します。

    • 1 つのリポジトリに固有の プロジェクト スキルの場合: リポジトリ内の .github/skills、 .claude/skills、または .agents/skills 。

    • 個人のスキルの場合は、プロジェクト間で共有されます。ローカル ホーム ディレクトリの~/.copilot/skills、~/.claude/skills、または~/.agents/skills。

          GitHub CLIでスキルを管理する

メモ

          `gh skill` は パブリック プレビュー であり、変更される可能性があります。 これを使用するには、 GitHub CLI をバージョン 2.90.0 以降に更新します。

          `gh skill`の GitHub CLI コマンドを使用して、GitHub リポジトリからエージェント スキルを検出、インストール、更新、発行できます。

          `gh skill`サブコマンドの完全なリストについては、`gh skill --help`を実行するか、`gh skill`マニュアルの「GitHub CLI」セクションを参照してください。

スキルのインストール

スキルの検索、プレビュー、 GitHub リポジトリからのインストールを行うことができます。

警告

スキルは GitHub によって検証されず、プロンプトインジェクション、隠された命令、または悪意のあるスクリプトが含まれている可能性があります。 gh skill previewを使用してインストールする前に、スキルの内容を常に検査してください。

  1. トピックでスキルを検索する:

    gh skill search TOPIC

  2. インストールする前に、スキルをプレビューして内容を調べます。 これにより、スキルの SKILL.md とファイル ツリーがターミナルにレンダリングされ、何もインストールされません。

    gh skill preview OWNER/REPOSITORY SKILL

  3. スキルをインストールします。 完全に対話型フローの引数なしで gh skill install を実行することも、リポジトリを指定してスキルを対話形式で参照することもできます。

    gh skill install OWNER/REPOSITORY

    特定のスキルを直接インストールするには:

    gh skill install OWNER/REPOSITORY SKILL

    たとえば、 github/awesome-copilot リポジトリからスキルをインストールするには、次のようにします。

    Shell
    gh skill install github/awesome-copilot documentation-writer

           `@TAG`または`@SHA`を使用して、特定のバージョンをインストールできます。
    Shell
    gh skill install github/awesome-copilot documentation-writer@v1.2.0

    スキルを特定のバージョンにロックする (または SHA をコミットする) ため、更新中にスキップされるようにするには、次の --pinを使用します。

    Shell
    gh skill install github/awesome-copilot documentation-writer --pin v1.2.0

    メモ

           `@VERSION`構文と`--pin` フラグは相互に排他的です。 両方ではなく、いずれか一方を使用します。

    特定のエージェント ホストのスキルをインストールするには、 --agent フラグを使用します。 インストール スコープを制御するには、次の --scopeを使用します。

    Shell
    gh skill install github/awesome-copilot documentation-writer --agent claude-code --scope user

スキルは、エージェント ホストの正しいディレクトリに自動的にインストールされます。 既定では、スキルはプロジェクト スコープで Copilot 用にインストールされます。

スキルの更新

          `gh skill`を使用してスキルをインストールすると、ソース リポジトリ、ref、ツリー SHA など、実績メタデータがスキルの `SKILL.md` frontmatter に書き込まれます。 
          `gh skill update` コマンドは、このメタデータを使用してアップストリームの変更を確認します。

対話形式で更新プログラムを確認するには:

gh skill update

特定のスキルを更新するには:

gh skill update SKILL

プロンプトを表示せずにインストールされているすべてのスキルを更新するには:

gh skill update --all

ピン留めされたスキルは更新中にスキップされます。 ピン留めされたスキルを更新するには、新しい --pin 値で再インストールします。

出版スキル

スキル リポジトリを管理する場合は、 GitHub CLIを使用してスキルを検証して公開できます。

          [エージェント スキル仕様](https://agentskills.io/specification)に照らしてスキルを検証し、タグ保護、シークレット スキャン、コード スキャンなどのリモート設定を公開せずに確認するには、`--dry-run`を使用します。

gh skill publish --dry-run

スキル ファイル内のメタデータの問題を自動修正するには、 --fixを使用します。 これにより、スキルは公開されません。

gh skill publish --fix

スキルを検証して公開するには:

gh skill publish


          Copilotがエージェント スキルを使用する方法

タスクを実行する場合、Copilot は、プロンプトとスキルの説明に基づいて、スキルを使用するタイミングを決定します。

Copilotがスキルの使用を選択すると、SKILL.md ファイルがエージェントのコンテキストに挿入され、エージェントが指示にアクセスできるようになります。 その後、これらの手順に従って、スキルのディレクトリに含めてきたスクリプトや例を使用できます。

スキルとカスタム命令

スキルとカスタム命令の両方を使用して、 Copilot をリポジトリで作業する方法と特定のタスクを実行する方法を教えることができます。

ほぼすべてのタスクに関連する簡単な手順 (リポジトリのコーディング標準に関する情報など) と、Copilot が関連する場合にのみアクセスする必要があるより詳細な手順のスキルには 、カスタム命令を使用することをお勧めします。

リポジトリのカスタム手順の詳細については、 GitHub Copilot用のリポジトリカスタム命令の追加 を参照してください。