Visual Studio 2026 version 18.8で組み込みAgent Skillsが表示されない場合、まず確認すべきなのは不具合ではなく、Visual Studioのバージョン、対応workloadの有無、skillごとの有効化状態です。18.8の組み込みskillsは既定でオフになっており、対応する.NETまたはAzure workloadがインストールされていない場合は、一覧そのものに表示されません。
Azureへアプリを配置するときは、azure-prepare、azure-validate、azure-deployの順に使用します。準備や検証を飛ばしてazure-deployだけを実行するのではなく、インフラ構成の生成、権限や設定の事前検証、実際のデプロイという順序で進めるのが基本です。(Microsoft for Developers)
Visual Studio組み込みAgent Skillsが表示されない主な理由
Visual Studio 18.8の組み込みAgent Skillsには、利用開始までに複数の条件があります。特に混同しやすいのが、「skillが一覧にない状態」と「一覧にはあるがオフになっている状態」です。
| 確認項目 | 条件を満たしていない場合 | 対処 |
|---|---|---|
| Visual Studioのバージョン | Built-inカテゴリや対象skillが表示されない | Visual Studio 2026 version 18.8以降へ更新する |
| .NET／Azure workload | 対応する組み込みskill自体が一覧に出ない | Visual Studio Installerから該当workloadを追加する |
| skillの有効化 | skillは見えるが利用されない | Skillsパネルで対象skillをオンにする |
| Azure認証と権限 | skillは使えるがAzure操作に失敗する | Azureへのサインイン、サブスクリプション、RBACを確認する |
Microsoftの説明では、組み込みskillsは対応する.NETまたはAzure開発workloadがインストールされている場合にのみ表示されます。また、表示されたskillも既定ではオフです。したがって、「18.8へ更新しただけ」では利用できないケースがあります。(Microsoft for Developers)
一覧にない場合とOffの場合は原因が異なる
Skillsパネルを開いたとき、対象skillの状態によって対応を分けます。
dotnet-webapiなどの名前がまったく見つからない
対応する.NET workloadが不足している可能性があります。azure-prepareなどのAzure skillsが見つからない
「AzureとAI開発」workload、またはその中の「Azure Skills」コンポーネントを確認します。- skillは表示されるが
Offになっている
仕様どおりの状態です。使用するskillだけを個別にオンにします。 Onなのに期待した処理で使われない
Agent Skillsはタスクに応じて動的に選択されるため、skillの目的が分かる具体的な依頼に言い換えます。
「表示されない」と「有効になっていない」を分けて確認するだけでも、原因をかなり絞り込めます。
Visual Studio 18.8で組み込みAgent Skillsを有効化する手順
Visual Studio 2026 version 18.8以降か確認する
Visual Studioを開き、次の順に確認します。
- メニューから「ヘルプ」を開く
- 「Microsoft Visual Studioのバージョン情報」を選ぶ
- バージョンが18.8以降であることを確認する
18.7以前では、今回の.NET／Azure組み込みskillsを前提とした確認はできません。Visual Studio Installerを起動し、対象インスタンスを更新してから進めます。組み込み.NET／Azure skillsは18.8で導入されています。(Microsoft for Developers)
必要なworkloadを追加する
Visual Studio Installerを起動し、インストール済みのVisual Studio 2026で「変更」を選択します。
.NET系skillsを使う場合は、対象プロジェクトに対応する.NET workloadを導入します。dotnet-webapiをASP.NET Coreプロジェクトで使う場合は、実務上「ASP.NETとWeb開発」が最初の確認候補です。
Azure deployment skill chainを使う場合は、次の手順で追加します。
- Visual Studio Installerで「変更」を選ぶ
- 「ワークロード」タブを開く
- 「AzureとAI開発」を選択する
- 右側の「インストールの詳細」を展開する
- 「Azure Skills」が選択されていることを確認する
- 「変更」または「ダウンロード中にインストール」を実行する
- インストール後にVisual Studioを再起動する
Visual Studio版のAzure Skillsは、Azure MCP ServerとともにVisual Studio Installerから導入されます。Microsoftの公式手順では、Visual Studio 2026 version 18.8以降を前提に、「AzureとAI開発」workload内で「Azure Skills」を選択します。通常は別のVisual Studio拡張機能を手動で追加する必要はありません。(Microsoft Learn)
主な組み込みskillsと確認すべき環境は次のとおりです。
| skill識別子 | 主な用途 | インストール時の確認先 |
|---|---|---|
dotnet-webapi | ASP.NET Core HTTP APIの作成・変更 | 対象プロジェクトに対応する.NET workload。Web APIでは「ASP.NETとWeb開発」を確認 |
analyzing-dotnet-performance | C#／.NETコードの性能問題を分析 | 対象プロジェクトに対応する.NET workload |
azure-prepare | Azure向け構成とIaCの準備 | 「AzureとAI開発」内の「Azure Skills」 |
azure-validate | デプロイ前の構成・権限・IaC検証 | 「AzureとAI開発」内の「Azure Skills」 |
azure-deploy | Azureへの実デプロイ | 「AzureとAI開発」内の「Azure Skills」 |
Microsoftは、個々の.NET skillとVisual Studio Installer上の全workload名の一対一対応までは示していません。対象skillが出ない場合は、プロジェクト種別に必要な.NET workloadがインストールされているかを基準に確認するのが安全です。
Skillsパネルでskillを明示的にオンにする
workloadをインストールしただけでは、組み込みskillsは自動的に有効になりません。
- Visual Studioで対象ソリューションを開く
- GitHub Copilot Chatを表示する
- Copilot Chat右下のツールアイコンを選ぶ
- 「Skills」タブを開く
- 「Built-in」カテゴリを表示する
- 使用するskillを検索する
- 対象skillのスイッチを
Onにする
Azureへ新規デプロイする場合は、少なくとも次の3つをまとめてオンにします。
azure-prepareazure-validateazure-deploy
Built-inカテゴリでは、skillにマウスポインターを合わせると説明と保存場所を確認できます。三点メニューからskill本体やフォルダーを開くことも可能です。(Microsoft for Developers)
検索欄に文字が残っていると対象skillが隠れることがあります。見つからないときは、フィルターを消したうえで識別子を完全一致で検索してください。
管理者設定と利用者設定を分けて考える
組織でVisual Studioを配布している場合、管理者がworkloadを導入しても、それだけで各利用者のAgent Skillsがすべて有効になるとは限りません。
実務では、次の4層に分けて管理すると切り分けやすくなります。
| 管理対象 | 主な担当 | 適用範囲 | 確認内容 |
|---|---|---|---|
| Visual Studioのバージョン | IT管理者 | 端末または開発環境 | 18.8以降か |
| workloadとコンポーネント | IT管理者 | Visual Studioインスタンス | .NET workload、AzureとAI開発、Azure Skills |
| Built-in skillのOn／Off | 開発者 | Skillsパネルで選択するskill | 必要なskillがオンか |
| Azure認証とRBAC | Azure管理者、開発者 | テナント、サブスクリプション、リソース | 正しいアカウントと権限か |
管理者側では「skillを利用できる土台があるか」、開発者側では「対象skillを有効にしたか」を確認します。問い合わせを受ける際も、「workloadは入っていますか」だけで終わらせず、Skillsパネルのスクリーンショットとskill識別子を確認すると解決が早くなります。
組み込みskillとソリューションskillの適用範囲
Visual Studioでは、Microsoftが提供する組み込みskillsとは別に、チームや個人で独自のAgent Skillsを作成できます。
| 種類 | 保存場所の例 | 主な用途 |
|---|---|---|
| 組み込みskill | Visual Studioとworkloadから提供 | .NET、Azureなどの標準的な専門作業 |
| ソリューションskill | .github/skills/、.claude/skills/、.agents/skills/ | チーム共通のビルド、レビュー、デプロイ手順 |
| 個人用skill | ~/.copilot/skills/、~/.claude/skills/、~/.agents/skills/ | 利用者個人の作業手順やテンプレート |
ソリューションskillはリポジトリ内に置けるため、Gitで共有できます。個人用skillはユーザープロファイルに保存され、複数のソリューションから利用できます。skillが実際に選択されると、Copilot Chat上にも使用中のskillが表示されます。(Microsoft for Developers)
一方、コーディング規約のように常に適用したいルールは、Agent SkillsよりもCustom Instructionsが適しています。Agent Skillsはタスク単位で動的に読み込まれるため、複数工程の作業、診断手順、デプロイ手順などに向いています。(Microsoft for Developers)
.NET組み込みskillsの使い分け
dotnet-webapiはHTTP APIの実装品質を整える
dotnet-webapiは、ASP.NET Core HTTP APIのエンドポイント作成や変更に適したskillです。単にControllerやMinimal APIのコードを追加するだけでなく、HTTPの意味に合ったステータスコード、OpenAPIメタデータ、エラー処理を含めた実装を支援します。(Microsoft for Developers)
たとえば、次のように依頼します。
既存のASP.NET Core APIに、処理済みデータをアーカイブへ移動するエンドポイントを追加してください。HTTPメソッド、ステータスコード、OpenAPIメタデータ、入力検証、例外処理も整えてください。
「エンドポイントを追加して」だけではなく、API設計上の判断要素を含めるのがポイントです。
実装後は、少なくとも次を人が確認します。
- 認証・認可が必要なエンドポイントに適切な制御があるか
200、201、204、400、404などの使い分けが適切か- 内部例外や機密情報をレスポンスへ出していないか
- OpenAPI上のレスポンス定義が実装と一致しているか
- 既存のAPIバージョニングや命名規則を壊していないか
analyzing-dotnet-performanceは改善候補の抽出に使う
analyzing-dotnet-performanceは、C#／.NETコードを対象に、非同期処理、メモリ、文字列、コレクション、LINQ、正規表現、シリアライズ、I/Oなどの性能アンチパターンを調べるskillです。公式skillでは約50種類のパターンを対象とし、重要度を付けて結果を整理します。(GitHub)
次のように、対象範囲と判断基準を指定すると実用的な結果を得やすくなります。
このソリューションを性能観点でレビューしてください。APIリクエストごとに通る処理をホットパスとして扱い、影響が大きい順に上位3件を示してください。各項目について、該当ファイル、根拠、修正例、BenchmarkDotNetまたはプロファイラーによる検証方法を提示してください。
このskillは既知のAPI使用パターンを見つける用途に適していますが、アルゴリズム全体の計算量を自動的に保証するものではありません。また、ホットパスではないコードまで無条件に最適化すると、可読性だけを損なう可能性があります。修正前後をプロファイラーやベンチマークで比較してください。(GitHub)
Azure deployment skill chainはprepare、validate、deployの順で使う
Azure deployment skill chainの正しい順序は、次のとおりです。
azure-prepare
↓
azure-validate
↓
azure-deployこの3つは独立した無関係のskillではなく、アプリをAzureへ配置するための一連のチェーンとして設計されています。すべて有効な場合は、処理内容に応じて次のskillへ引き継ぐこともできます。(Microsoft for Developers)
| 順序 | skill | 実行する内容 | 完了前に確認すること |
|---|---|---|---|
| 1 | azure-prepare | IaC、Azure構成、コンテナ関連ファイルなどを準備 | サービス、リージョン、SKU、リソース名、認証方式 |
| 2 | azure-validate | IaC、設定、RBAC、マネージドID、事前差分を検証 | エラーや重大な警告が残っていないか |
| 3 | azure-deploy | Azureリソースの作成・更新とアプリ配置を実行 | 対象サブスクリプション、変更内容、費用、承認 |
azure-prepareでデプロイ可能な状態を作る
azure-prepareは、アプリの構造を分析し、Azureで動かすために必要な構成を準備します。Microsoftの説明では、BicepまたはTerraform、azure.yaml、Dockerfile、マネージドIDなどの生成が対象です。(Microsoft for Developers)
初回は、いきなり「Azureへデプロイして」と依頼するより、実行を止めた状態で準備結果を確認します。
このASP.NET CoreアプリをAzure Container AppsへマネージドIDで配置できるように準備してください。Bicepを使用し、まず構成案と生成予定ファイルを提示してください。まだAzureリソースの作成やデプロイは実行しないでください。
生成後は、次を確認します。
- App Service、Container Apps、Functionsなどの選定が要件に合っているか
- リージョンが組織の方針やデータ所在地要件に合っているか
- 本番環境として過大または過小なSKUになっていないか
- シークレットをソースコードやIaCへ直接書いていないか
- マネージドIDで代替できる接続情報がないか
- リソース名やタグが組織標準に合っているか
azure-validateで実行前の問題を止める
azure-validateは、実際にAzureへ変更を加える前の事前検証を担当します。
対象には、構成ファイル、BicepやTerraform、RBAC、マネージドIDの権限、what-ifやビルドによる確認が含まれます。これにより、デプロイ開始後に権限不足や構成ミスで停止する問題を事前に見つけやすくなります。(Microsoft for Developers)
生成されたAzureデプロイ構成を検証してください。Bicep、azure.yaml、RBAC、マネージドID、コンテナ設定を確認し、what-if相当の変更内容を要約してください。重大な問題がある場合はデプロイへ進まないでください。
検証でエラーが出た場合は、azure-deployへ進まず修正します。特にRBACの不足を解決するために、必要以上に強いロールを付与しないことが重要です。
azure-deployで実際の変更を実行する
azure-deployは、azd up、azd deploy、Bicep、terraform applyなどを利用して、実際のデプロイ処理を進めます。デプロイ中にエラーが発生した場合の復旧も、このskillの役割に含まれます。(Microsoft for Developers)
検証結果に重大な問題がないことを確認してください。対象テナント、サブスクリプション、リージョン、作成・更新されるリソース、削除予定のリソースを先に提示し、承認を得てからデプロイしてください。
新規環境では、azure-deployだけをオンにして実行する運用は避けた方が安全です。既存のIaCがレビュー済みで、直前の検証結果も有効な再デプロイであればdeployから始められる場合はありますが、通常はprepareから順番に実行します。
自動チェーンと段階実行を使い分ける
3つのskillを有効にした状態で、次のような一括プロンプトを送ることもできます。
このASP.NET CoreアプリをマネージドIDを使用してAzure Container Appsへデプロイしてください。
公式には、3つのskillが自動的に引き継ぐデプロイチェーンとして紹介されています。(Microsoft for Developers)
ただし、本番環境、公共系システム、個人情報を扱うシステム、費用管理が厳しい環境では、次のように作業を分ける方が安全です。
azure-prepareでファイルを生成する- 生成されたIaCをGitへコミットする
- Pull Requestで構成と費用影響をレビューする
azure-validateで事前検証する- 対象サブスクリプションを再確認する
- 承認後に
azure-deployを実行する
「skill chainが自動でつながる」ことと、「確認なしで本番まで実行してよい」ことは別です。
Azure認証とサブスクリプションを事前確認する
Azure Skillsは、Visual StudioにサインインしているAzureアカウントを利用できます。資格情報を取得できない場合は、Azure CLIの認証も確認します。Microsoft Learnでは、ローカル開発時の認証方法としてAzure CLIが推奨されています。(Microsoft Learn)
Visual StudioのターミナルまたはPowerShellで、次を実行します。
az login
az account show
az account list --output table複数のサブスクリプションを利用している場合は、デプロイ先を明示します。
az account set --subscription "<サブスクリプションIDまたは名前>"
az account showAzure Developer CLIを使ったデプロイでは、こちらの認証も確認します。
azd auth loginAzure Skillsの公式リポジトリでも、Azure CLIではaz login、azdを使うデプロイではazd auth loginを実行し、正しいサブスクリプションが選択されていることを確認するよう案内されています。(GitHub)
認証できていても、対象リソースを作成するRBACロールがなければデプロイは失敗します。認証エラーと権限不足は別問題なので、エラーメッセージに応じて切り分けます。
組み込みAgent Skillsが有効になったか確認する方法
Skillsパネルで識別子を確認する
SkillsパネルのBuilt-inカテゴリで、次の識別子を一つずつ検索します。
dotnet-webapi
analyzing-dotnet-performance
azure-prepare
azure-validate
azure-deploy対象skillが表示され、スイッチがOnになっていることを確認します。マウスポインターを合わせて、説明とパスも確認してください。
明示的なプロンプトで動作確認する
最初の確認では、曖昧な依頼を避けます。
dotnet-webapiの確認例：
ASP.NET Core APIのエンドポイントを追加し、HTTPステータス、OpenAPIメタデータ、エラー処理を整えてください。
analyzing-dotnet-performanceの確認例：
このC#プロジェクトを性能観点で分析し、影響が大きい上位3件を根拠とともに示してください。
azure-prepareの確認例：
このプロジェクトをAzureへ配置するために必要なサービスとインフラ構成を整理してください。まだデプロイは実行しないでください。
Azure接続の確認例：
現在のAzureアカウントで参照できるリソースグループを一覧表示してください。
skillが選択されると、Copilot Chat上に適用中のskillが表示されます。単なる一般的な回答ではなく、skillに沿った構造化された手順やツール実行が行われるかも確認します。(Microsoft for Developers)
表示されない・動かない場合の切り分け
| 症状 | 主な原因 | 対処 |
|---|---|---|
| Built-inカテゴリが見当たらない | Visual Studioが18.8未満 | Visual Studio 2026を18.8以降へ更新 |
| .NET skillsだけ表示されない | 対応.NET workloadが未導入 | Visual Studio Installerでプロジェクト種別に合う.NET workloadを追加 |
| Azure skillsだけ表示されない | 「AzureとAI開発」または「Azure Skills」が未導入 | workloadのインストール詳細を確認 |
| skillがOffになっている | 18.8では既定オフ | 使用するskillを個別にオン |
| Onだがskillが選ばれない | 依頼内容が抽象的、タスクとskillが一致していない | skill名と目的が分かる具体的なプロンプトにする |
| workload追加後も一覧が変わらない | 再読み込みが完了していない | Visual Studioを完全に終了して再起動 |
| Azure操作だけ失敗する | 未認証、期限切れ、別テナント | Visual Studioのアカウント、az login、az account showを確認 |
azd実行時に認証エラー | Azure Developer CLIが未認証 | azd auth loginを実行 |
| リソース作成が拒否される | RBAC不足またはポリシー違反 | ロール割り当て、Azure Policy、対象スコープを確認 |
| validateで失敗する | IaC、権限、マネージドID、設定の不整合 | deployへ進まず、検証結果を修正 |
| 一部のskillだけ見えない | Skillsパネルの検索条件が残っている | 検索欄をクリアして再検索 |
Azure Skillsが認識されない場合、公式リポジトリでもホストの再起動や再読み込みによる再インデックスが案内されています。認証エラーではaz loginとazd auth loginを再実行し、正しいサブスクリプションを確認します。(GitHub)
利用時に注意したいコストとセキュリティ
必要なskillだけを有効にする
Visual Studio 18.8の組み込みskillsが既定でオフなのは、利用者が内容を確認し、必要なものだけを選べるようにするためです。Microsoftはskillの有効性とコスト、Copilotのトークン消費も評価していると説明しています。(Microsoft for Developers)
常にすべてのskillsをオンにするのではなく、作業に応じて選びます。
- API開発時は
dotnet-webapi - 性能レビュー時は
analyzing-dotnet-performance - Azureデプロイ時は3つのdeployment skills
- デプロイ完了後、不要になった実行系skillはオフにする
azure-deployは実リソースを変更する
azure-deployは説明を返すだけのskillではありません。設定と権限がそろっていれば、Azureリソースの作成や更新を伴う処理へ進みます。
実行前には、最低限次を確認します。
- Azureテナント
- サブスクリプション名とID
- リージョン
- リソースグループ
- 作成・変更・削除されるリソース
- SKUと概算費用
- Azure Policyへの適合
- RBACの割り当て範囲
- マネージドIDの利用可否
- IaCの差分
特に検証環境と本番環境で同じAzureアカウントを使っている場合、サブスクリプションの取り違えに注意が必要です。
シークレットをチャットへ貼り付けない
クライアントシークレット、接続文字列、アクセストークン、秘密鍵をCopilot Chatへ直接貼り付けないようにします。
Azureサービス間の認証では、可能な範囲でマネージドIDを選びます。サービスプリンシパルが必要な場合も、シークレットをIaCやリポジトリへ直接保存せず、組織のシークレット管理方法に従ってください。
次に行うべきこと
Visual Studio組み込みAgent Skillsが表示されない場合は、次の順番で確認します。
- Visual Studio 2026がversion 18.8以降か確認する
- 対象プロジェクトに必要な.NET workloadをインストールする
- Azure利用時は「AzureとAI開発」と「Azure Skills」を追加する
- Visual Studioを再起動する
- Copilot ChatのSkillsパネルでBuilt-inカテゴリを開く
- 必要なskillを個別にオンにする
- Azure認証、サブスクリプション、RBACを確認する
- Azureデプロイは
azure-prepare、azure-validate、azure-deployの順に実行する
最初に確認すべきポイントは、「skillが表示されないのか」「表示されているがOffなのか」「OnだがAzure実行で失敗しているのか」の区別です。この3つを分けて調べれば、workload不足、既定オフ、認証・権限エラーを効率よく切り分けられます。
コメント