.github/skills/*/SKILL.md とは
.github/skills/*/SKILL.md ファイルは、このプロジェクト独自で定義されたスキル定義ドキュメントです。GitHub Copilot などの AI アシスタントが参照し、ブログ記事執筆やドキュメント管理の支援を行う際のコンテキストを提供します。
利用の前提
.github/skills/*/SKILL.md を利用するには、GitHub Copilot でカスタムスキルを有効にする必要があります。
Visual Studio Code の設定から chat.useAgentSkills を検索します。

作り方
いくつかの作り方があります。
- ゼロから作成する
- VS Code の機能で作成する
- コマンドパレット>「チャット: New Skill File」
- Use Agent Skills in VS Code
カスタムエージェントファイルのフォーマットは、VS Code のドキュメントに詳しく記載されています。
Anthropics 社が公開している skill-creator というスキルを作るスキルが便利です。
効果があるところ
.github/skills/*/SKILL.md は、VS Code などの Copilot Chat で参照されます。
指示したタスクを行う際に、定義されたスキルを参照して適切なアクションを実行できます。
参考:Awesome Copilot
スキルの参考として github/awesome-copilot のリポジトリをオススメします。
ここからベースとなるスキルをコピーしてきて、プロジェクトに合わせてカスタマイズします。
まとめ
.github に配置できるファイルの一覧はこちらの記事でまとめています。