microsoft/skills

Skills, MCP servers, Custom Agents, Agents.md for SDKs to ground Coding Agents

Microsoft / skills – Azureを活用するAIコーディングエージェント向けのエージェントスキル

何であるか – Azureサービス、Microsoft Foundryプラットフォーム、およびその他のMicrosoft SDKと効果的に連携できるようにAIコーディングエージェント(例:GitHub Copilot CLI、VS CodeのCopilot)に教えるための、選別された*「スキル」*のコレクションです。各スキルは個別のフォルダ(例:azure-cosmos-db-py/)にあり、エージェントの.github/skills/ディレクトリにインストールすることで、適切なSDKを呼び出し、ボイラープレートコードを生成、または一般的な操作を実行できます。低レベルのコードを自分で書く必要がありません。


なぜ重要なのか

  • エージェント向けのドメイン知識 – 大規模言語モデルエージェントはAzure SDKの構造を既に把握していますが、適切なアクティベーションコンテキストがなければ、正しいパターンを提示できません。スキルはそのコンテキストを提供し、汎用LLMを専門的なAzure開発者に変換します。
  • プラグアンドプレイ – 170以上のスキルがAzureコアサービス(Cosmos DB、Storage、Event Gridなど)、AIサービス(OpenAI、Vision、Speech)、Microsoft 365、および新しく登場したFoundryエージェントプラットフォームをカバーしています。必要なスキルのみをインストールすることで、エージェントのプロンプトサイズを小さく保ち、トークン予算を効率化できます。
  • 一貫性のあるツールセット – スキルにはMCP(Model‑Control‑Plane)サーバーテンプレート、カスタムエージェント、AGENTS.md構成ファイルも同梱されており、バックエンド、フロントエンド、インフラストラクチャ、計画担当など、さまざまな役割のエージェントを再現可能な方法で構築できます。

クイックスタート(ワンライナー)

npx skills add microsoft/skills   # インストールしたいスキルを選択するウィザードを起動

ウィザードは選択したスキルフォルダをプロジェクトにコピーし(例:.github/skills/azure-cosmos-db-py/)、複数のエージェント間で同じスキルを共有する場合にシンボリックリンクを作成します。

代替案:リポジトリをクローンして必要なフォルダを手動でコピーするか、マルチプロジェクト構成ではシンボリックリンクを使用します。


リポジトリの主要な構成要素

要素 提供される内容
スキルカタログ(約175スキル) Azure SDK、Foundry API、その他のMicrosoftサービス向けの、言語別に準備されたラッパー。各スキルにはサンプルコード、skill.mdの説明、およびオプションのMCPサーバースケルトンが含まれます。
プラグイン 小規模なnpm/py/nugetパッケージ(例:deep-wikiazure‑skills)で、エージェントのランタイムに追加して追加のツール機能を提供できます。
カスタムエージェント ロール指向のエージェントテンプレート(バックエンド、フロントエンド、インフラ、プランナー)で、AGENTS.mdファイルが事前に埋め込まれており、エージェントの振る舞いを定義します。
MCP構成 ドキュメント検索、ウェブ検索、コードインタプリタ、A2Aツールオーケストレーションなどに使用可能な、事前に構成されたModel‑Control‑Planeサーバー。
ドキュメントとスキルエクスプローラー 全スキルを一覧表示し、ワンクリックインストールボタンと詳細な使用ドキュメントへのリンクを提供するWeb UI(https://microsoft.github.io/skills/)。

一般的な利用例

  1. Azure SDK開発の加速azure-storage-blob-pyを追加し、Copilotに即座に正しいBlobストレージCRUDコードを生成させます。
  2. Foundryホストエージェントの構築foundry-hosted-agentsスキルを使用して、コンテナ化されたエージェントをスケルトン化。Foundry MCPに登録し、独自のEntra IDを取得し、Foundry API経由で呼び出せます。
  3. エージェントの長期記憶の実現foundry-memoryをインストールして、セッション間で保存される永続的な知識ストアをエージェントに提供します。
  4. ガバナンスの強制foundry-governanceをデプロイして、多数のエージェントに対してRBAC、ルーティングポリシー、責任あるAIチェックを設定します。
  5. 本番環境対応のスケルトン生成fastapi-router-pyとストレージスキルを組み合わせて、認証とデータ永続化を備えた完全に型安全なFastAPIサービスを迅速に起動します。

どの人向けか

  • Azure上でAI支援ツールを開発する開発者 – Copilot/FoundryエージェントがAzure固有のパターンを即座に理解できるようにしたい人。
  • DevOps / プラットフォームエンジニア – 複数のリポジトリやチーム間で再現可能でバージョン管理されたスキルセットが必要な人。
  • 機械学習エンジニア – Azure AIサービス(OpenAI、Vision、Speech)を活用し、エージェントが正しいSDK呼び出しを生成できるようにしたい人。
  • プロダクトチームcloud-solution-architectスキルを使って、一貫したアーキテクチャ(例:well-architectedクラウドソリューション)を強制したい人。

ヘルプの取得 / コントリビューション

  • テストとCI – READMEの上部にあるバッジは、すべてのスキルがテストハーネスとCopilot-SDK評価ワークフローで検証されていることを示しています。
  • コントリビューション – リポジトリは作業中とマークされています。新しいスキルの追加、ドキュメントの改善、テストカバレッジの拡張など、PRを提出できます。
  • ドキュメント – 完全なドキュメントは https://microsoft.github.io/skills/ にあります(インストールガイド、スキルカタログ、APIリファレンス)。

TL;DR

microsoft/skillsは、数百ものプラグアンドプレイ「スキル」(コードテンプレート、MCPサーバー、構成ファイル)を提供することで、汎用AIコーディングエージェントをAzureに精通したアシスタントに変える本物で、積極的にメンテナンスされているツールボックスです。必要なスキルのみをインストールし、エージェントのコンテキストを小さく保ち、即座に正しいAzure SDKコードを生成できます。


リンク

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト