エージェント スキルは、ビルド パイプラインの実行、定型文の生成、チームのコーディング標準に従うなど、特定のタスクの実行方法をCopilotエージェントに教える再利用可能な一連の命令です。 スキルを 1 回定義することで、時間を節約し、ワークフロー全体で一貫した動作を確保できます。
スキルは 、カスタム エージェント と カスタム命令を補完します。 カスタム エージェントはペルソナとツール セットを定義し、カスタム命令は一般的なコーディング設定を設定しますが、スキルは、すべてのエージェントが自動的に検出して使用できる、タスク固有のガイダンスを提供します。
Prerequisites
エージェント スキルのしくみ
agent モードを使用すると、Copilotはリポジトリとユーザー プロファイルからスキルを自動的に検出します。 エージェントは、スキルが要求に関連するタイミングを決定し、アクティブ化します。 スキルがアクティブになると、そのスキルがチャットに表示され、適用されていることを通知します。
スキルの場所
スキルは、次の場所から取得されます。
| スキルの種類 | 場所 |
|---|---|
| ワークスペースまたはプロジェクトのスキル（リポジトリに格納されている） |
.github/skills/、.claude/skills/、.agents/skills/ |
| 個人のスキル (ユーザー プロファイルに格納) |
~/.copilot/skills/、~/.claude/skills/、~/.agents/skills/ |
ワークスペースのスキルは、ソース管理を通じてチームと共有されます。 個人のスキルはすべてのプロジェクトに適用され、どのリポジトリにもコミットされません。
スキルの作成
ファイル システムでスキルを手動で作成できます。
スキルを手動で作成する
各スキルは、agentskills.io 仕様に従う SKILL.md ファイルを含むディレクトリ です。
スキル ディレクトリを作成します。 ワークスペース スキルの場合は、リポジトリのルートにある
.github/skills/を使用します。 個人のスキルの場合は、~/.copilot/skills/を使用します。スキルのサブディレクトリを作成します。 各スキルには、独自のディレクトリ (たとえば、
.github/skills/github-issues/) が必要です。スキル ディレクトリに
SKILL.mdファイルを作成します。 このファイルには、メタデータと Markdown 命令が続く YAML frontmatter が含まれています。必要に応じて、スキルのディレクトリにスクリプト、例、またはその他のリソースを追加します。
スキル ディレクトリ構造
your-repo/
└── .github/
└── skills/
└── github-issues/
├── SKILL.md # Required: metadata + instructions
├── scripts/ # Optional: executable code
├── references/ # Optional: documentation
└── assets/ # Optional: templates, resources
SKILL.md 形式
SKILL.md ファイルには、YAML frontmatter とそれに続く Markdown コンテンツが含まれている必要があります。
---
name: github-issues
description: Creates and manages GitHub issues following team conventions. Use when working with issue tracking, bug reports, or feature requests.
---
When creating GitHub issues:
- Use the standard title format: [Component] Brief description
- Add appropriate labels based on issue type
- Include reproduction steps for bug reports
- Link related issues and PRs
Frontmatter プロパティ
| 財産 | 必須 | 説明 |
|---|---|---|
name |
はい | 小文字、数字、ハイフンのみ。 親ディレクトリ名と一致する必要があります。 最大 64 文字。 |
description |
はい | スキルが実行する内容と、それを使用するタイミングについて説明します。 最大 1,024 文字。 |
license |
いいえ | バンドルされたライセンス ファイルへのライセンス名または参照。 |
compatibility |
いいえ | 目的の製品や必要なシステム パッケージなどの環境要件。 |
metadata |
いいえ | 追加のメタデータに対するキーと値の任意のマッピング。 |
allowed-tools |
いいえ | スキルが使用できる、スペースで区切られた事前承認済みツールの文字列。 |
効果的なスキルを書く際のヒント
- メイン
SKILL.mdは 500 行以下にしてください。 詳細な参照資料を、references/ディレクトリ内の個別のファイルに移動します。 - エージェントがスキルが関連するタイミングを識別するのに役立つ特定のキーワードを含む明確な
descriptionを記述します。 - 詳細な手順、例、一般的なエッジ ケースを含めます。
スキル パネルからスキルを管理する
Copilot Chatの右下隅にある Tools アイコンを選択して、検出されたすべてのスキルの専用ビューであるスキル パネルを開きます。 [スキル] パネルは、Visual Studio 2026 Insider でのみ使用できます。
パネルから、次のことができます。
-
編集:
SKILL.mdメニューからエディターでスキルのを直接開きます。 - ファイルの場所を開く: ディスク上のスキル ディレクトリにジャンプします。
- 検索: 名前またはキーワードでスキルをフィルター処理します。
このパネルには、スキル構成エラーの診断も表示されるため、問題をすばやく特定して修正できます。
コミュニティ スキル
コミュニティが共有するスキルの例については、 awesome-copilot リポジトリ を参照してください。
関連するコンテンツ
- GitHub Copilot のエージェントモードで始める
GitHub Copilot - チャット応答をカスタマイズし、コンテキストを設定する
- MCP サーバーを使用する