Claude CodeからGitHub Copilotへ移植したらAgent Skillsが動かない？原因と解決策

Claude CodeのSkillsがCopilotで発火しない・読み込まれない原因は発火メカニズムの違い。description強化、トークン予算、Instructionsルーティングで解決。

はじめに

ども！GitHub Copilotが徐々に育ってきて、ニコニコな龍ちゃんです。1月後半から2月にかけてGitHub Copilot関連のブログが多めに出ています。ブログが出ているということは育っている証拠ですね。

今回は、前回紹介していた Agent Skills の話題です。「網羅5種ブログ」と「Claude Code→GitHub Copilot移行」では補足として触れていた Agent Skills を、Claude Code から実際に移植したという部分にフォーカスしていきます。

「Claude Code で使っていた Skills をそのまま GitHub Copilot に移植したら、まったく発火しない…」

同じ SKILL.md 形式なのに、なぜ動かないのか？本記事では、発火しない根本原因と3つの解決策を解説します。

検証環境

• 検証日: 2026年2月2日
• 環境: VS Code 1.108以降 + GitHub Copilot
• 参考: VS Code Docs – Agent Skills

前提：Agent Skills の基本

Agent Skills の基本（ディレクトリ構造、SKILL.md の書き方）は「【2026年版】Agent Skills 入門：SKILL.md の基本から実践まで」を参照してください。

本記事では「発火しない」問題と解決策に特化します。

発火しない原因：Claude Code との根本的な違い

結論から言うと、Claude Code と GitHub Copilot ではスキルの発火メカニズムが根本的に異なります。

注: 以下は4つのスキルを実際に移植した際の動作検証から分析した内容です。公式ドキュメントで詳細が公開されていない部分は推測を含みます。

決定的 vs 確率的

GitHub Copilot も Claude Code も、Agent Skills には「Progressive Disclosure」という設計思想を採用しています。全スキルを事前に読み込むのではなく、関連度に基づいて必要なスキルのみを読み込む仕組みです。

違いは「どの段階で絞り込むか」にあります。

Claude Code は全スキルを把握した上で内部判断で選択するのに対し、Copilot は事前に絞り込んでから選択するため、description の書き方次第で「漏れ」が発生するのです。

注: GitHub 公式では関連度スコアリングの詳細な実装方法は公開されていません。本記事の説明は動作検証からの推測を含みます。

description の設計思想が違う

ここが核心です。

Claude Code では「何をするか」をベースで書けばOKです。

description: ブログ記事をスクレイピングしてMarkdownに変換

内部ルーティングが賢いので、この程度の説明でも意図を理解してくれます。

GitHub Copilot では「スキルの機能と発火条件の両方」を書く必要があります。公式ガイドラインでは「describe BOTH what the skill does AND when to use it」と明記されています。

description: |
  ブログ記事をスクレイピングしてMarkdownに変換するスキル。
  Use when: ブログを取得したい、記事を保存したい、tech-lab.sios.jp の内容を取得したい。
  Triggers on: scrape blog, fetch article, ブログ取得, 記事取得.

関連度スコアリングではユーザーが実際に使う言葉を埋め込まないとスコアが上がりません。

核心の一文: Claude Code と同じ感覚で作ると発火しない。「技術的な説明」ではなく「ユーザーの発話」を埋め込む必要がある。

雑に作ると動かない理由

まとめると、こういうことです。

Claude Code のノリで雑にぶち込むと動きません。ただし、作法に従って厳密に作れば、Claude Code と同等の機能を実現できます。

公式が推奨するベストプラクティスに盲目的に従う必要はないですが、一度は目を通しておいたほうがよい！という感じですね。Microsoftが公開しているリポジトリに含まれているGitHub Copilot Agent Skillsのガイドラインです。

補足: 比較のために大げさに書いていますが、Claude Code の Skills もちゃんと設計したほうが良いです！

解決策①：description を強化する

落とし穴：「英語で書くべき」Tips が逆効果になる場合

よく「システムプロンプトは英語で書くべき」というTipsがありますよね。GitHub Copilot Agent Skills では、これが逆効果になる可能性があります。

Copilot の関連度判定は文字列の類似度で判断していると推測されます。ユーザーの発話と description の言葉が近いほどスコアが上がります。日本語でプロンプトを書くユーザーには、日本語の発火キーワードが必要になります。英語だけで書くと、日本語クエリとの類似度が低くなり、発火しにくくなります。

結論: description には日本語・英語両方の発火キーワードを列挙しましょう。

推奨フォーマット

description: |
  [機能の簡潔な説明（何をするスキルか）].
  Use when: [どんな時に使うか（ユーザーの意図）].
  Triggers on: [発火キーワード（日本語・英語）].

Before / After

Before（発火しない）:

description: HTMLをPlaywrightでレンダリングしてPNG画像に変換

After（発火する）:

description: |
  HTMLファイルをPlaywrightでレンダリングしてPNG画像に変換するスキル。
  Use when: HTMLを画像化したい、スクリーンショットを撮りたい。
  Triggers on: HTMLをPNGに変換, HTML to PNG, 画像に変換, HTMLを画像に, screenshot HTML, HTMLをキャプチャ.

ポイントは「技術的に何をするか」ではなく、「ユーザーがどう言うか」を想像して書くことです。

解決策②：トークン予算を守る

Copilot はトークン効率を重視する設計です。SKILL.md が長すぎると、そもそも読み込まれない可能性があります。

分割パターン

長くなりそうな場合は、詳細を references/ に分割しましょう。

.github/skills/my-skill/
├── SKILL.md              # 概要 + Quick Start（〜60行）
└── references/
    ├── commands.md       # コマンド詳細
    └── troubleshooting.md

SKILL.md は「ルーター役」に徹して、詳細は必要な時だけ読み込まれるようにします。

解決策③：Instructions ルーティング（力技）

正直、関連度スコアリングは不安定です。description を強化しても、発火したりしなかったりすることがあります。

そこで最終手段として、copilot-instructions.md に明示的なルーティングテーブルを追加する方法があります。

## Agent Skills Routing

| キーワード                             | スキル       | パス                                   |
|----------------------------------------|--------------|----------------------------------------|
| ブログスクレイピング, tech-lab.sios.jp | blog-scraper | `.github/skills/blog-scraper/SKILL.md` |
| フローチャート, 図                     | html-diagram | `.github/skills/html-diagram/SKILL.md` |

なぜ有効か

• Instructions は常に読み込まれる
• 関連度スコアリングをバイパスできる
• 発火が安定する

デメリット（トレードオフ）

力技ゆえのデメリットも認識しておきましょう。

• 保守性の低下: スキルを追加・変更するたびにルーティングテーブルの更新が必要
• スケーラビリティ: スキル数が増えると Instructions ファイルが肥大化
• 本来の設計思想から外れる: Progressive Disclosure の恩恵を受けられない

結論: 確実に発火させたい重要なスキル（3〜5個程度）に限定して使うのがおすすめです。

検証結果：4スキルで発火確認

実際に Claude Code から移植した4つのスキルで検証しました。

結論: Instructions ルーティングテーブルで全スキル安定発火しました。

検証に使用したスキルの概要:

移植チェックリスト

Claude Code Skills → GitHub Copilot への移植手順をまとめました。

- [ ] `.claude/skills/` → `.github/skills/` にコピー
- [ ] `allowed-tools` を削除（Copilot では実験的機能）
- [ ] description に `Use when` / `Triggers on` を追加
- [ ] ユーザー発話を日本語・英語で列挙
- [ ] SKILL.md を 500トークン以下（約60行目安）に削減
- [ ] `copilot-instructions.md` にルーティングテーブル追加（重要スキルのみ）
- [ ] VS Code リロード後、5〜10分待機
- [ ] 発火テスト

このチェックリストに従えば、Claude Code で作ったスキルを GitHub Copilot でも活用できます。

まとめ

Agent Skills が発火しない問題と解決策を整理しました。

発火しない場合は、本記事の3つの解決策を順番に試してみてください。特に Instructions ルーティングは確実性が高いのでおすすめです。

参考リンク

公式ドキュメント

• VS Code Docs – Agent Skills
• GitHub Docs – About Agent Skills
• GitHub Changelog – Agent Skills リリース

公式リポジトリ

• github/awesome-copilot – ベストプラクティス
• Microsoft GitHub-Copilot-for-Azure – Agent Skills 実装例
• anthropics/claude-cookbooks – Skills – Progressive Disclosure

関連記事

• GitHub Copilot設定5種を網羅！生産性を最大化する使い分け術
• Claude Code→GitHub Copilot移行で使える設定ファイル6つの対応表
• 【2026年版】Agent Skills 入門：SKILL.md の基本から実践まで

ここまで読んでいただき、ありがとうございました！

Agent Skills の発火問題で困っている方の参考になれば幸いです。Claude Code から移行する方は、ぜひ移植チェックリストを活用してください。