Skills, custom agents, AGENTS.md templates, and MCP configurations for AI coding agents working with Azure SDKs and Microsoft AI Foundry. Select the skills you need from the wizard. Skills are installed to your chosen agent's directory (e.g., .github/skills/ for GitHub Copilot) and symlinked if you use multiple agents. Alternative installation methods Manual installation (git clone) Coding agents
Add this skill
npx mdskills install microsoft/skillsComprehensive catalog of 131+ Azure SDK skills with clear organization and installation tooling
1# Agent Skills23[](https://github.com/microsoft/skills/actions/workflows/test-harness.yml)4[](https://github.com/microsoft/skills/actions/workflows/skill-evaluation.yml)5[](https://skills.sh/microsoft/skills)6[](https://microsoft.github.io/skills/#documentation)78> [!NOTE]9> **Work in Progress** — This repository is under active development. More skills are being added, existing skills are being updated to use the latest SDK patterns, and tests are being expanded to ensure quality. Contributions welcome!1011Skills, custom agents, AGENTS.md templates, and MCP configurations for AI coding agents working with Azure SDKs and Microsoft AI Foundry.1213> **Blog post:** [Context-Driven Development: Agent Skills for Microsoft Foundry and Azure](https://devblogs.microsoft.com/all-things-azure/context-driven-development-agent-skills-for-microsoft-foundry-and-azure/)1415> **🔍 Skill Explorer:** [Browse all 131 skills with 1-click install](https://microsoft.github.io/skills/)1617## Quick Start1819```bash20npx skills add microsoft/skills21```2223Select the skills you need from the wizard. Skills are installed to your chosen agent's directory (e.g., `.github/skills/` for GitHub Copilot) and symlinked if you use multiple agents.2425<details>26<summary>Alternative installation methods</summary>2728**Manual installation (git clone)**2930```bash31# Clone and copy specific skills32git clone https://github.com/microsoft/skills.git33cp -r agent-skills/.github/skills/azure-cosmos-db-py your-project/.github/skills/3435# Or use symlinks for multi-project setups36ln -s /path/to/agent-skills/.github/skills/mcp-builder /path/to/your-project/.github/skills/mcp-builder3738# Share skills across different agent configs in the same repo39ln -s ../.github/skills .opencode/skills40ln -s ../.github/skills .claude/skills41```4243</details>4445---4647Coding agents like [Copilot CLI](https://github.com/features/copilot/cli) are powerful, but they lack domain knowledge about your SDKs. The patterns are already in their weights from pretraining. All you need is the right activation context to surface them.4849> [!IMPORTANT]50> **Use skills selectively.** Loading all skills causes context rot: diluted attention, wasted tokens, conflated patterns. Only copy skills essential for your current project.5152---53545556---5758## What's Inside5960| Resource | Description |61|----------|-------------|62| **[126 Skills](#skill-catalog)** | Domain-specific knowledge for Azure SDK and Foundry development |63| **[Plugins](#plugins)** | Installable plugin packages (deep-wiki, azure-skills and more) |64| **[Custom Agents](#agents)** | Role-specific agents (backend, frontend, infrastructure, planner) |65| **[AGENTS.md](AGENTS.md)** | Template for configuring agent behavior in your projects |66| **[MCP Configs](#mcp-servers)** | Pre-configured servers for docs, GitHub, browser automation |67| **[Documentation](https://microsoft.github.io/skills/#documentation)** | Repo docs and usage guides |6869---7071## Skill Catalog7273> 131 skills in `.github/skills/` — flat structure with language suffixes for automatic discovery7475| Language | Count | Suffix |76|----------|-------|--------|77| [Core](#core) | 7 | — |78| [Python](#python) | 41 | `-py` |79| [.NET](#net) | 28 | `-dotnet` |80| [TypeScript](#typescript) | 25 | `-ts` |81| [Java](#java) | 25 | `-java` |82| [Rust](#rust) | 7 | `-rust` |8384---8586### Core8788> 7 skills — tooling, infrastructure, language-agnostic8990| Skill | Description |91|-------|-------------|92| [copilot-sdk](.github/skills/copilot-sdk/) | Build applications powered by GitHub Copilot using the Copilot SDK. Session management, custom tools, streaming, hooks, MCP servers, BYOK, deployment patterns. |93| [frontend-design-review](.github/skills/frontend-design-review/) | Review and create distinctive frontend interfaces. Design system compliance, quality pillars, accessibility, and creative aesthetics. |94| [github-issue-creator](.github/skills/github-issue-creator/) | Convert raw notes, error logs, or screenshots into structured GitHub issues. |95| [mcp-builder](.github/skills/mcp-builder/) | Build MCP servers for LLM tool integration. Python (FastMCP), Node/TypeScript, or C#/.NET. |96| [podcast-generation](.github/skills/podcast-generation/) | Generate podcast-style audio with Azure OpenAI Realtime API. Full-stack React + FastAPI + WebSocket. |97| [skill-creator](.github/skills/skill-creator/) | Guide for creating effective skills for AI coding agents. |9899---100101### Python102103> 41 skills • suffix: `-py`104105<details>106<summary><strong>Foundry & AI</strong> (7 skills)</summary>107108| Skill | Description |109|-------|-------------|110| [agent-framework-azure-ai-py](.github/plugins/azure-sdk-python/skills/agent-framework-azure-ai-py/) | Agent Framework SDK — persistent agents, hosted tools, MCP servers, streaming. |111| [azure-ai-contentsafety-py](.github/plugins/azure-sdk-python/skills/azure-ai-contentsafety-py/) | Content Safety SDK — detect harmful content in text/images with multi-severity classification. |112| [azure-ai-contentunderstanding-py](.github/plugins/azure-sdk-python/skills/azure-ai-contentunderstanding-py/) | Content Understanding SDK — multimodal extraction from documents, images, audio, video. |113| [agents-v2-py](.github/plugins/azure-sdk-python/skills/agents-v2-py/) | Foundry Agents SDK — container-based agents with ImageBasedHostedAgentDefinition, custom images, tools. |114| [azure-ai-projects-py](.github/plugins/azure-sdk-python/skills/azure-ai-projects-py/) | High-level Foundry SDK — project client, versioned agents, evals, connections, OpenAI-compatible clients. |115| [azure-search-documents-py](.github/plugins/azure-sdk-python/skills/azure-search-documents-py/) | AI Search SDK — vector search, hybrid search, semantic ranking, indexing, skillsets. |116117</details>118119<details>120<summary><strong>M365</strong> (1 skill)</summary>121122| Skill | Description |123|-------|-------------|124| [m365-agents-py](.github/plugins/azure-sdk-python/skills/m365-agents-py/) | Microsoft 365 Agents SDK — aiohttp hosting, AgentApplication routing, streaming, Copilot Studio client. |125126</details>127128<details>129<summary><strong>AI Services</strong> (8 skills)</summary>130131| Skill | Description |132|-------|-------------|133| [azure-ai-ml-py](.github/plugins/azure-sdk-python/skills/azure-ai-ml-py/) | ML SDK v2 — workspaces, jobs, models, datasets, compute, pipelines. |134| [azure-ai-textanalytics-py](.github/plugins/azure-sdk-python/skills/azure-ai-textanalytics-py/) | Text Analytics — sentiment, entities, key phrases, PII detection, healthcare NLP. |135| [azure-ai-transcription-py](.github/plugins/azure-sdk-python/skills/azure-ai-transcription-py/) | Transcription SDK — real-time and batch speech-to-text with timestamps, diarization. |136| [azure-ai-translation-document-py](.github/plugins/azure-sdk-python/skills/azure-ai-translation-document-py/) | Document Translation — batch translate Word, PDF, Excel with format preservation. |137| [azure-ai-translation-text-py](.github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py/) | Text Translation — real-time translation, transliteration, language detection. |138| [azure-ai-vision-imageanalysis-py](.github/plugins/azure-sdk-python/skills/azure-ai-vision-imageanalysis-py/) | Vision SDK — captions, tags, objects, OCR, people detection, smart cropping. |139| [azure-ai-voicelive-py](.github/plugins/azure-sdk-python/skills/azure-ai-voicelive-py/) | Voice Live SDK — real-time bidirectional voice AI with WebSocket, VAD, avatars. |140| [azure-speech-to-text-rest-py](.github/plugins/azure-sdk-python/skills/azure-speech-to-text-rest-py/) | Speech to Text REST API — transcribe short audio (≤60 seconds) via HTTP without Speech SDK. |141142</details>143144<details>145<summary><strong>Data & Storage</strong> (7 skills)</summary>146147| Skill | Description |148|-------|-------------|149| [azure-cosmos-db-py](.github/plugins/azure-sdk-python/skills/azure-cosmos-db-py/) | Cosmos DB patterns — FastAPI service layer, dual auth, partition strategies, TDD. |150| [azure-cosmos-py](.github/plugins/azure-sdk-python/skills/azure-cosmos-py/) | Cosmos DB SDK — document CRUD, queries, containers, globally distributed data. |151| [azure-data-tables-py](.github/plugins/azure-sdk-python/skills/azure-data-tables-py/) | Tables SDK — NoSQL key-value storage, entity CRUD, batch operations. |152| [azure-storage-blob-py](.github/plugins/azure-sdk-python/skills/azure-storage-blob-py/) | Blob Storage — upload, download, list, containers, lifecycle management. |153| [azure-storage-file-datalake-py](.github/plugins/azure-sdk-python/skills/azure-storage-file-datalake-py/) | Data Lake Gen2 — hierarchical file systems, big data analytics. |154| [azure-storage-file-share-py](.github/plugins/azure-sdk-python/skills/azure-storage-file-share-py/) | File Share — SMB file shares, directories, cloud file operations. |155| [azure-storage-queue-py](.github/plugins/azure-sdk-python/skills/azure-storage-queue-py/) | Queue Storage — reliable message queuing, task distribution. |156157</details>158159<details>160<summary><strong>Messaging & Events</strong> (4 skills)</summary>161162| Skill | Description |163|-------|-------------|164| [azure-eventgrid-py](.github/plugins/azure-sdk-python/skills/azure-eventgrid-py/) | Event Grid — publish events, CloudEvents, event-driven architectures. |165| [azure-eventhub-py](.github/plugins/azure-sdk-python/skills/azure-eventhub-py/) | Event Hubs — high-throughput streaming, producers, consumers, checkpointing. |166| [azure-messaging-webpubsubservice-py](.github/plugins/azure-sdk-python/skills/azure-messaging-webpubsubservice-py/) | Web PubSub — real-time messaging, WebSocket connections, pub/sub. |167| [azure-servicebus-py](.github/plugins/azure-sdk-python/skills/azure-servicebus-py/) | Service Bus — queues, topics, subscriptions, enterprise messaging. |168169</details>170171<details>172<summary><strong>Entra</strong> (2 skills)</summary>173174| Skill | Description |175|-------|-------------|176| [azure-identity-py](.github/plugins/azure-sdk-python/skills/azure-identity-py/) | Identity SDK — DefaultAzureCredential, managed identity, service principals. |177| [azure-keyvault-py](.github/plugins/azure-sdk-python/skills/azure-keyvault-py/) | Key Vault — secrets, keys, and certificates management. |178179</details>180181<details>182<summary><strong>Monitoring</strong> (4 skills)</summary>183184| Skill | Description |185|-------|-------------|186| [azure-monitor-ingestion-py](.github/plugins/azure-sdk-python/skills/azure-monitor-ingestion-py/) | Monitor Ingestion — send custom logs via Logs Ingestion API. |187| [azure-monitor-opentelemetry-exporter-py](.github/plugins/azure-sdk-python/skills/azure-monitor-opentelemetry-exporter-py/) | OpenTelemetry Exporter — low-level export to Application Insights. |188| [azure-monitor-opentelemetry-py](.github/plugins/azure-sdk-python/skills/azure-monitor-opentelemetry-py/) | OpenTelemetry Distro — one-line App Insights setup with auto-instrumentation. |189| [azure-monitor-query-py](.github/plugins/azure-sdk-python/skills/azure-monitor-query-py/) | Monitor Query — query Log Analytics workspaces and Azure metrics. |190191</details>192193<details>194<summary><strong>Integration & Management</strong> (5 skills)</summary>195196| Skill | Description |197|-------|-------------|198| [azure-appconfiguration-py](.github/plugins/azure-sdk-python/skills/azure-appconfiguration-py/) | App Configuration — centralized config, feature flags, dynamic settings. |199| [azure-containerregistry-py](.github/plugins/azure-sdk-python/skills/azure-containerregistry-py/) | Container Registry — manage container images, artifacts, repositories. |200| [azure-mgmt-apicenter-py](.github/plugins/azure-sdk-python/skills/azure-mgmt-apicenter-py/) | API Center — API inventory, metadata, governance. |201| [azure-mgmt-apimanagement-py](.github/plugins/azure-sdk-python/skills/azure-mgmt-apimanagement-py/) | API Management — APIM services, APIs, products, policies. |202| [azure-mgmt-botservice-py](.github/plugins/azure-sdk-python/skills/azure-mgmt-botservice-py/) | Bot Service — create and manage Azure Bot resources. |203204</details>205206<details>207<summary><strong>Patterns & Frameworks</strong> (3 skills)</summary>208209| Skill | Description |210|-------|-------------|211| [azure-mgmt-fabric-py](.github/plugins/azure-sdk-python/skills/azure-mgmt-fabric-py/) | Fabric Management — Microsoft Fabric capacities and resources. |212| [fastapi-router-py](.github/plugins/azure-sdk-python/skills/fastapi-router-py/) | FastAPI routers — CRUD operations, auth dependencies, response models. |213| [pydantic-models-py](.github/plugins/azure-sdk-python/skills/pydantic-models-py/) | Pydantic patterns — Base, Create, Update, Response, InDB model variants. |214215</details>216217---218219### .NET220221> 29 skills • suffix: `-dotnet`222223<details>224<summary><strong>Foundry & AI</strong> (6 skills)</summary>225226| Skill | Description |227|-------|-------------|228| [azure-ai-document-intelligence-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-ai-document-intelligence-dotnet/) | Document Intelligence — extract text, tables from invoices, receipts, IDs, forms. |229| [azure-ai-openai-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-ai-openai-dotnet/) | Azure OpenAI — chat, embeddings, image generation, audio, assistants. |230| [azure-ai-projects-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-ai-projects-dotnet/) | AI Projects SDK — Foundry project client, agents, connections, evals. |231| [azure-ai-voicelive-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-ai-voicelive-dotnet/) | Voice Live — real-time voice AI with bidirectional WebSocket. |232| [azure-mgmt-weightsandbiases-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-mgmt-weightsandbiases-dotnet/) | Weights & Biases — ML experiment tracking via Azure Marketplace. |233| [azure-search-documents-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-search-documents-dotnet/) | AI Search — full-text, vector, semantic, hybrid search. |234235</details>236237<details>238<summary><strong>M365</strong> (1 skill)</summary>239240| Skill | Description |241|-------|-------------|242| [m365-agents-dotnet](.github/plugins/azure-sdk-dotnet/skills/m365-agents-dotnet/) | Microsoft 365 Agents SDK — ASP.NET Core hosting, AgentApplication routing, Copilot Studio client. |243244</details>245246<details>247<summary><strong>Data & Storage</strong> (6 skills)</summary>248249| Skill | Description |250|-------|-------------|251| [azure-mgmt-fabric-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-mgmt-fabric-dotnet/) | Fabric ARM — provision, scale, suspend/resume Fabric capacities. |252| [azure-resource-manager-cosmosdb-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-resource-manager-cosmosdb-dotnet/) | Cosmos DB ARM — create accounts, databases, containers, RBAC. |253| [azure-resource-manager-mysql-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-resource-manager-mysql-dotnet/) | MySQL Flexible Server — servers, databases, firewall, HA. |254| [azure-resource-manager-postgresql-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-resource-manager-postgresql-dotnet/) | PostgreSQL Flexible Server — servers, databases, firewall, HA. |255| [azure-resource-manager-redis-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-resource-manager-redis-dotnet/) | Redis ARM — cache instances, firewall, geo-replication. |256| [azure-resource-manager-sql-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-resource-manager-sql-dotnet/) | SQL ARM — servers, databases, elastic pools, failover groups. |257258</details>259260<details>261<summary><strong>Messaging</strong> (3 skills)</summary>262263| Skill | Description |264|-------|-------------|265| [azure-eventgrid-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-eventgrid-dotnet/) | Event Grid — publish events, CloudEvents, EventGridEvents. |266| [azure-eventhub-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-eventhub-dotnet/) | Event Hubs — high-throughput streaming, producers, processors. |267| [azure-servicebus-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-servicebus-dotnet/) | Service Bus — queues, topics, sessions, dead letter handling. |268269</details>270271<details>272<summary><strong>Entra</strong> (3 skills)</summary>273274| Skill | Description |275|-------|-------------|276| [azure-identity-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-identity-dotnet/) | Identity SDK — DefaultAzureCredential, managed identity, service principals. |277| [azure-security-keyvault-keys-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-security-keyvault-keys-dotnet/) | Key Vault Keys — key creation, rotation, encrypt/decrypt, sign/verify. |278| [microsoft-azure-webjobs-extensions-authentication-events-dotnet](.github/plugins/azure-sdk-dotnet/skills/microsoft-azure-webjobs-extensions-authentication-events-dotnet/) | Entra Auth Events — custom claims, token enrichment, attribute collection. |279280</details>281282<details>283<summary><strong>Compute & Integration</strong> (6 skills)</summary>284285| Skill | Description |286|-------|-------------|287| [azure-maps-search-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-maps-search-dotnet/) | Azure Maps — geocoding, routing, map tiles, weather. |288| [azure-mgmt-apicenter-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-mgmt-apicenter-dotnet/) | API Center — API inventory, governance, versioning, discovery. |289| [azure-mgmt-apimanagement-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-mgmt-apimanagement-dotnet/) | API Management ARM — APIM services, APIs, products, policies. |290| [azure-mgmt-botservice-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-mgmt-botservice-dotnet/) | Bot Service ARM — bot resources, channels (Teams, DirectLine). |291| [azure-resource-manager-durabletask-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-resource-manager-durabletask-dotnet/) | Durable Task ARM — schedulers, task hubs, retention policies. |292| [azure-resource-manager-playwright-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-resource-manager-playwright-dotnet/) | Playwright Testing ARM — workspaces, quotas. |293294</details>295296<details>297<summary><strong>Monitoring & Partner</strong> (3 skills)</summary>298299| Skill | Description |300|-------|-------------|301| [azure-mgmt-applicationinsights-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-mgmt-applicationinsights-dotnet/) | Application Insights — components, web tests, workbooks. |302| [azure-mgmt-arizeaiobservabilityeval-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-mgmt-arizeaiobservabilityeval-dotnet/) | Arize AI — ML observability via Azure Marketplace. |303| [azure-mgmt-mongodbatlas-dotnet](.github/plugins/azure-sdk-dotnet/skills/azure-mgmt-mongodbatlas-dotnet/) | MongoDB Atlas — manage Atlas orgs as Azure ARM resources. |304305</details>306307---308309### TypeScript310311> 25 skills • suffix: `-ts`312313<details>314<summary><strong>Foundry & AI</strong> (6 skills)</summary>315316| Skill | Description |317|-------|-------------|318| [azure-ai-contentsafety-ts](.github/plugins/azure-sdk-typescript/skills/azure-ai-contentsafety-ts/) | Content Safety — moderate text/images, detect harmful content. |319| [azure-ai-document-intelligence-ts](.github/plugins/azure-sdk-typescript/skills/azure-ai-document-intelligence-ts/) | Document Intelligence — extract from invoices, receipts, IDs, forms. |320| [azure-ai-projects-ts](.github/plugins/azure-sdk-typescript/skills/azure-ai-projects-ts/) | AI Projects SDK — Foundry client, agents, connections, evals. |321| [azure-ai-translation-ts](.github/plugins/azure-sdk-typescript/skills/azure-ai-translation-ts/) | Translation — text translation, transliteration, document batch. |322| [azure-ai-voicelive-ts](.github/plugins/azure-sdk-typescript/skills/azure-ai-voicelive-ts/) | Voice Live — real-time voice AI with WebSocket, Node.js or browser. |323| [azure-search-documents-ts](.github/plugins/azure-sdk-typescript/skills/azure-search-documents-ts/) | AI Search — vector/hybrid search, semantic ranking, knowledge bases. |324325</details>326327<details>328<summary><strong>M365</strong> (1 skill)</summary>329330| Skill | Description |331|-------|-------------|332| [m365-agents-ts](.github/plugins/azure-sdk-typescript/skills/m365-agents-ts/) | Microsoft 365 Agents SDK — AgentApplication routing, Express hosting, streaming, Copilot Studio client. |333334</details>335336<details>337<summary><strong>Data & Storage</strong> (5 skills)</summary>338339| Skill | Description |340|-------|-------------|341| [azure-cosmos-ts](.github/plugins/azure-sdk-typescript/skills/azure-cosmos-ts/) | Cosmos DB — document CRUD, queries, bulk operations. |342| [azure-postgres-ts](.github/plugins/azure-sdk-typescript/skills/azure-postgres-ts/) | PostgreSQL — connect to Azure Database for PostgreSQL with pg, pooling, Entra ID auth. |343| [azure-storage-blob-ts](.github/plugins/azure-sdk-typescript/skills/azure-storage-blob-ts/) | Blob Storage — upload, download, list, SAS tokens, streaming. |344| [azure-storage-file-share-ts](.github/plugins/azure-sdk-typescript/skills/azure-storage-file-share-ts/) | File Share — SMB shares, directories, file operations. |345| [azure-storage-queue-ts](.github/plugins/azure-sdk-typescript/skills/azure-storage-queue-ts/) | Queue Storage — send, receive, peek, visibility timeout. |346347</details>348349<details>350<summary><strong>Messaging</strong> (3 skills)</summary>351352| Skill | Description |353|-------|-------------|354| [azure-eventhub-ts](.github/plugins/azure-sdk-typescript/skills/azure-eventhub-ts/) | Event Hubs — high-throughput streaming, partitioned consumers. |355| [azure-servicebus-ts](.github/plugins/azure-sdk-typescript/skills/azure-servicebus-ts/) | Service Bus — queues, topics, sessions, dead-letter handling. |356| [azure-web-pubsub-ts](.github/plugins/azure-sdk-typescript/skills/azure-web-pubsub-ts/) | Web PubSub — WebSocket real-time features, group chat, notifications. |357358</details>359360<details>361<summary><strong>Entra & Integration</strong> (4 skills)</summary>362363| Skill | Description |364|-------|-------------|365| [azure-appconfiguration-ts](.github/plugins/azure-sdk-typescript/skills/azure-appconfiguration-ts/) | App Configuration — settings, feature flags, Key Vault references. |366| [azure-identity-ts](.github/plugins/azure-sdk-typescript/skills/azure-identity-ts/) | Identity SDK — DefaultAzureCredential, managed identity, browser login. |367| [azure-keyvault-keys-ts](.github/plugins/azure-sdk-typescript/skills/azure-keyvault-keys-ts/) | Key Vault Keys — create, encrypt/decrypt, sign, rotate keys. |368| [azure-keyvault-secrets-ts](.github/plugins/azure-sdk-typescript/skills/azure-keyvault-secrets-ts/) | Key Vault Secrets — store and retrieve application secrets. |369370</details>371372<details>373<summary><strong>Monitoring & Frontend</strong> (5 skills)</summary>374375| Skill | Description |376|-------|-------------|377| [azure-microsoft-playwright-testing-ts](.github/plugins/azure-sdk-typescript/skills/azure-microsoft-playwright-testing-ts/) | Playwright Testing — scale browser tests, CI/CD integration. |378| [azure-monitor-opentelemetry-ts](.github/plugins/azure-sdk-typescript/skills/azure-monitor-opentelemetry-ts/) | OpenTelemetry — tracing, metrics, logs with Application Insights. |379| [frontend-ui-dark-ts](.github/plugins/azure-sdk-typescript/skills/frontend-ui-dark-ts/) | Frontend UI Dark — Vite + React + Tailwind + Framer Motion dark-themed UI design system. |380| [react-flow-node-ts](.github/plugins/azure-sdk-typescript/skills/react-flow-node-ts/) | React Flow nodes — custom nodes with TypeScript, handles, Zustand. |381| [zustand-store-ts](.github/plugins/azure-sdk-typescript/skills/zustand-store-ts/) | Zustand stores — TypeScript, subscribeWithSelector, state/action separation. |382383</details>384385<details>386<summary><strong>Infrastructure & Orchestration</strong> (1 skill)</summary>387388| Skill | Description |389|-------|-------------|390| [aspire-ts](.github/skills/aspire-ts/) | .NET Aspire orchestration — AddViteApp, AddNodeApp, AddJavaScriptApp, service discovery, telemetry, deployment. |391392</details>393394---395396### Java397398> 26 skills • suffix: `-java`399400<details>401<summary><strong>Foundry & AI</strong> (7 skills)</summary>402403| Skill | Description |404|-------|-------------|405| [azure-ai-anomalydetector-java](.github/plugins/azure-sdk-java/skills/azure-ai-anomalydetector-java/) | Anomaly Detector — univariate/multivariate time-series analysis. |406| [azure-ai-contentsafety-java](.github/plugins/azure-sdk-java/skills/azure-ai-contentsafety-java/) | Content Safety — text/image analysis, blocklist management. |407| [azure-ai-formrecognizer-java](.github/plugins/azure-sdk-java/skills/azure-ai-formrecognizer-java/) | Form Recognizer — extract text, tables, key-value pairs from documents. |408| [azure-ai-projects-java](.github/plugins/azure-sdk-java/skills/azure-ai-projects-java/) | AI Projects — Foundry project management, connections, datasets. |409| [azure-ai-vision-imageanalysis-java](.github/plugins/azure-sdk-java/skills/azure-ai-vision-imageanalysis-java/) | Vision SDK — captions, OCR, object detection, tagging. |410| [azure-ai-voicelive-java](.github/plugins/azure-sdk-java/skills/azure-ai-voicelive-java/) | Voice Live — real-time voice conversations with WebSocket. |411412</details>413414<details>415<summary><strong>Communication</strong> (5 skills)</summary>416417| Skill | Description |418|-------|-------------|419| [azure-communication-callautomation-java](.github/plugins/azure-sdk-java/skills/azure-communication-callautomation-java/) | Call Automation — IVR, call routing, recording, DTMF, TTS. |420| [azure-communication-callingserver-java](.github/plugins/azure-sdk-java/skills/azure-communication-callingserver-java/) | CallingServer (legacy) — deprecated, use callautomation for new projects. |421| [azure-communication-chat-java](.github/plugins/azure-sdk-java/skills/azure-communication-chat-java/) | Chat SDK — threads, messaging, participants, read receipts. |422| [azure-communication-common-java](.github/plugins/azure-sdk-java/skills/azure-communication-common-java/) | Common utilities — token credentials, user identifiers. |423| [azure-communication-sms-java](.github/plugins/azure-sdk-java/skills/azure-communication-sms-java/) | SMS SDK — notifications, alerts, OTP delivery, bulk messaging. |424425</details>426427<details>428<summary><strong>Data & Storage</strong> (3 skills)</summary>429430| Skill | Description |431|-------|-------------|432| [azure-cosmos-java](.github/plugins/azure-sdk-java/skills/azure-cosmos-java/) | Cosmos DB — NoSQL operations, global distribution, reactive patterns. |433| [azure-data-tables-java](.github/plugins/azure-sdk-java/skills/azure-data-tables-java/) | Tables SDK — Table Storage or Cosmos DB Table API. |434| [azure-storage-blob-java](.github/plugins/azure-sdk-java/skills/azure-storage-blob-java/) | Blob Storage — upload, download, containers, streaming. |435436</details>437438<details>439<summary><strong>Messaging</strong> (3 skills)</summary>440441| Skill | Description |442|-------|-------------|443| [azure-eventgrid-java](.github/plugins/azure-sdk-java/skills/azure-eventgrid-java/) | Event Grid — publish events, pub/sub patterns. |444| [azure-eventhub-java](.github/plugins/azure-sdk-java/skills/azure-eventhub-java/) | Event Hubs — high-throughput streaming, event-driven architectures. |445| [azure-messaging-webpubsub-java](.github/plugins/azure-sdk-java/skills/azure-messaging-webpubsub-java/) | Web PubSub — WebSocket messaging, live updates, chat. |446447</details>448449<details>450<summary><strong>Entra</strong> (3 skills)</summary>451452| Skill | Description |453|-------|-------------|454| [azure-identity-java](.github/plugins/azure-sdk-java/skills/azure-identity-java/) | Identity SDK — DefaultAzureCredential, managed identity, service principals. |455| [azure-security-keyvault-keys-java](.github/plugins/azure-sdk-java/skills/azure-security-keyvault-keys-java/) | Key Vault Keys — RSA/EC keys, encrypt/decrypt, sign/verify, HSM. |456| [azure-security-keyvault-secrets-java](.github/plugins/azure-sdk-java/skills/azure-security-keyvault-secrets-java/) | Key Vault Secrets — passwords, API keys, connection strings. |457458</details>459460<details>461<summary><strong>Monitoring & Integration</strong> (5 skills)</summary>462463| Skill | Description |464|-------|-------------|465| [azure-appconfiguration-java](.github/plugins/azure-sdk-java/skills/azure-appconfiguration-java/) | App Configuration — settings, feature flags, snapshots. |466| [azure-compute-batch-java](.github/plugins/azure-sdk-java/skills/azure-compute-batch-java/) | Batch SDK — large-scale parallel and HPC jobs. |467| [azure-monitor-ingestion-java](.github/plugins/azure-sdk-java/skills/azure-monitor-ingestion-java/) | Monitor Ingestion — custom logs via Data Collection Rules. |468| [azure-monitor-opentelemetry-exporter-java](.github/plugins/azure-sdk-java/skills/azure-monitor-opentelemetry-exporter-java/) | OpenTelemetry Exporter — traces, metrics, logs to Azure Monitor. (Deprecated) |469| [azure-monitor-query-java](.github/plugins/azure-sdk-java/skills/azure-monitor-query-java/) | Monitor Query — Kusto queries, Log Analytics, metrics. (Deprecated) |470471</details>472473---474475### Rust476477> 7 skills • suffix: `-rust`478479<details>480<summary><strong>Entra</strong> (4 skills)</summary>481482| Skill | Description |483|-------|-------------|484| [azure-identity-rust](.github/plugins/azure-sdk-rust/skills/azure-identity-rust/) | Identity SDK — DeveloperToolsCredential, ManagedIdentityCredential, ClientSecretCredential. |485| [azure-keyvault-certificates-rust](.github/plugins/azure-sdk-rust/skills/azure-keyvault-certificates-rust/) | Key Vault Certificates — create, import, manage certificates. |486| [azure-keyvault-keys-rust](.github/plugins/azure-sdk-rust/skills/azure-keyvault-keys-rust/) | Key Vault Keys — RSA/EC keys, encrypt/decrypt, sign/verify. |487| [azure-keyvault-secrets-rust](.github/plugins/azure-sdk-rust/skills/azure-keyvault-secrets-rust/) | Key Vault Secrets — passwords, API keys, connection strings. |488489</details>490491<details>492<summary><strong>Data & Storage</strong> (2 skills)</summary>493494| Skill | Description |495|-------|-------------|496| [azure-cosmos-rust](.github/plugins/azure-sdk-rust/skills/azure-cosmos-rust/) | Cosmos DB SDK — document CRUD, queries, containers, partitions. |497| [azure-storage-blob-rust](.github/plugins/azure-sdk-rust/skills/azure-storage-blob-rust/) | Blob Storage — upload, download, containers, streaming. |498499</details>500501<details>502<summary><strong>Messaging</strong> (1 skill)</summary>503504| Skill | Description |505|-------|-------------|506| [azure-eventhub-rust](.github/plugins/azure-sdk-rust/skills/azure-eventhub-rust/) | Event Hubs — high-throughput streaming, producers, consumers, batching. |507508</details>509510---511512## Repository Structure513514```515AGENTS.md # Agent configuration template516517.github/518├── skills/ # Backward-compat symlinks to plugin skills519├── plugins/ # Language-based plugin bundles (azure-sdk-python, etc.)520│ └── azure-sdk-*/ # Each bundle has skills/, commands/, agents/521├── prompts/ # Reusable prompt templates522├── agents/ # Agent persona definitions523├── scripts/ # Automation scripts (doc scraping)524├── workflows/ # GitHub Actions (daily doc updates)525└── copilot-instructions.md526527docs/ # Generated llms.txt files (daily workflow) - GitHub Pages hosted528├── llms.txt # Links + summaries529└── llms-full.txt # Full content530531skills/ # Symlinks for backward compatibility532├── python/ # -> ../.github/skills/*-py533├── dotnet/ # -> ../.github/skills/*-dotnet534├── typescript/ # -> ../.github/skills/*-ts535├── java/ # -> ../.github/skills/*-java536└── rust/ # -> ../.github/skills/*-rust537538.vscode/539└── mcp.json # MCP server configurations540```541542---543544## Plugins545546Plugins are installable packages containing curated sets of agents, commands, and skills. Install via the Copilot CLI:547548```bash549# Inside Copilot CLI, run these slash commands:550/plugin marketplace add microsoft/skills551/plugin install deep-wiki@skills552/plugin install azure-skills@skills553```554555| Plugin | Description | Commands |556|--------|-------------|----------|557| [deep-wiki](https://github.com/microsoft/skills/tree/main/.github/plugins/deep-wiki) | AI-powered wiki generator with Mermaid diagrams, source citations, onboarding guides, AGENTS.md, and llms.txt | `/deep-wiki:generate`, `/deep-wiki:crisp`, `/deep-wiki:catalogue`, `/deep-wiki:page`, `/deep-wiki:research`, `/deep-wiki:ask`, `/deep-wiki:onboard`, `/deep-wiki:agents`, `/deep-wiki:llms`, `/deep-wiki:changelog`, `/deep-wiki:ado`, `/deep-wiki:build`, `/deep-wiki:deploy` |558| [azure-skills](https://github.com/microsoft/skills/tree/main/.github/plugins/azure-skills) | Microsoft Azure MCP integration for cloud resource management, deployments, and Azure services. Includes 18 skills covering AI, storage, diagnostics, cost optimization, compliance, RBAC, and a 3-step deployment workflow (`azure-prepare` → `azure-validate` → `azure-deploy`). | Skills-based (no slash commands) — auto-triggered by intent matching via `azure` and `foundry-mcp` MCP servers |559---560561## MCP Servers562563Reference configurations in [`.vscode/mcp.json`](.vscode/mcp.json):564565| Category | Servers |566|----------|---------|567| **Documentation** | `microsoft-docs`, `context7`, `deepwiki` |568| **Development** | `github`, `playwright`, `terraform`, `eslint` |569| **Utilities** | `sequentialthinking`, `memory`, `markitdown` |570571For full MCP server implementations for Azure services, see **[microsoft/mcp](https://github.com/microsoft/mcp)**.572573---574575## Additional Resources576577### Agents578579Role-specific agent personas in [`.github/agents/`](.github/agents/):580581| Agent | Expertise |582|-------|-----------|583| `backend.agent.md` | FastAPI, Pydantic, Cosmos DB, Azure services |584| `frontend.agent.md` | React, TypeScript, React Flow, Zustand, Tailwind |585| `infrastructure.agent.md` | Bicep, Azure CLI, Container Apps, networking |586| `planner.agent.md` | Task decomposition, architecture decisions |587| `presenter.agent.md` | Documentation, demos, technical writing |588589Use [`AGENTS.md`](AGENTS.md) as a template for configuring agent behavior in your own projects.590591### Prompts592593Reusable prompt templates in [`.github/prompts/`](.github/prompts/):594595| Prompt | Purpose |596|--------|---------|597| [`code-review.prompt.md`](.github/prompts/code-review.prompt.md) | Structured code review with security, performance, and maintainability checks |598| [`create-store.prompt.md`](.github/prompts/create-store.prompt.md) | Zustand store creation with TypeScript and subscribeWithSelector |599| [`create-node.prompt.md`](.github/prompts/create-node.prompt.md) | React Flow custom node creation with handles and Zustand integration |600| [`add-endpoint.prompt.md`](.github/prompts/add-endpoint.prompt.md) | FastAPI endpoint creation with Pydantic models and proper typing |601602### Documentation603604See the docs at https://microsoft.github.io/skills/#documentation.605606---607608## Testing Skills609610The test harness validates that skills produce correct code patterns using the [GitHub Copilot SDK](https://github.com/github/copilot-sdk). It evaluates generated code against acceptance criteria defined for each skill.611612```bash613# Install test dependencies (from tests directory)614cd tests615pnpm install616617# List skills with test coverage618pnpm harness --list619620# Run tests for a specific skill (mock mode for CI)621pnpm harness azure-ai-projects-py --mock --verbose622623# Run with Ralph Loop (iterative improvement)624pnpm harness azure-ai-projects-py --ralph --mock --max-iterations 5 --threshold 85625626# Run unit tests627pnpm test628```629630### Test Coverage Summary631632**127 skills with 1148 test scenarios** — all skills have acceptance criteria and test scenarios.633634| Language | Skills | Scenarios | Top Skills by Scenarios |635|----------|--------|-----------|-------------------------|636| Core | 6 | 62 | `copilot-sdk` (11), `podcast-generation` (8), `skill-creator` (8) |637| Python | 41 | 331 | `azure-ai-projects-py` (12), `pydantic-models-py` (12), `azure-ai-translation-text-py` (11) |638| .NET | 29 | 290 | `azure-resource-manager-sql-dotnet` (14), `azure-resource-manager-redis-dotnet` (14), `azure-servicebus-dotnet` (13) |639| TypeScript | 25 | 270 | `azure-storage-blob-ts` (17), `azure-servicebus-ts` (14), `aspire-ts` (13) |640| Java | 26 | 195 | `azure-storage-blob-java` (12), `azure-identity-java` (12), `azure-data-tables-java` (11) |641642### Adding Test Coverage643644See [`tests/README.md`](tests/README.md) for instructions on adding acceptance criteria and scenarios for new skills.645646### Ralph Loop & Sensei Patterns647648The test harness implements iterative quality improvement patterns inspired by [Sensei](https://github.com/microsoft/GitHub-Copilot-for-Azure/tree/main/.github/skills/sensei):649650**Ralph Loop** — An iterative code generation and improvement system that:6511. **Generate** code for a given skill/scenario6522. **Evaluate** against acceptance criteria (score 0-100)6533. **Analyze** failures and build LLM-actionable feedback6544. **Re-generate** with feedback until quality threshold is met6555. **Report** on quality improvements across iterations656657**Sensei-style Scoring** — Skills are evaluated on frontmatter compliance:658659| Score | Requirements |660|-------|--------------|661| **Low** | Basic description only |662| **Medium** | Description > 150 chars, has trigger keywords |663| **Medium-High** | Has "USE FOR:" triggers AND "DO NOT USE FOR:" anti-triggers |664| **High** | Triggers + anti-triggers + compatibility field |665666---667668## Contributing669670### Adding New Skills671672New skills must follow the full workflow to ensure quality and discoverability:673674**Prerequisites:**675- SDK package name (e.g., `azure-ai-agents`, `Azure.AI.OpenAI`)676- Microsoft Learn documentation URL or GitHub repository677- Target language (py/dotnet/ts/java)678679**Workflow:**6806811. **Create skill** in `.github/skills/<skill-name>/SKILL.md`682 - Naming: `azure-<service>-<language>` (e.g., `azure-ai-projects-py`)683 - Include YAML frontmatter with `name` and `description`684 - Reference official docs via `microsoft-docs` MCP6856862. **Categorize with symlink** in `skills/<language>/<category>/`687 ```bash688 # Example: Python AI agent skill in foundry category689 cd skills/python/foundry690 ln -s ../../../.github/skills/azure-ai-projects-py projects691 ```692693 Categories: `foundry`, `data`, `messaging`, `monitoring`, `entra`, `integration`, `compute`, `m365`, `general`6946953. **Create acceptance criteria** in `.github/skills/<skill>/references/acceptance-criteria.md`696 - Document correct/incorrect import patterns697 - Document authentication patterns698 - Document async variants6997004. **Create test scenarios** in `tests/scenarios/<skill>/scenarios.yaml`701 - Test basic usage, error handling, advanced features702 - Include mock responses for CI7037045. **Verify tests pass**705 ```bash706 cd tests && pnpm harness <skill-name> --mock --verbose707 ```7087096. **Update README.md** — Add to the appropriate language section in the Skill Catalog710711> **Full guide:** See [`.github/skills/skill-creator/SKILL.md`](.github/skills/skill-creator/SKILL.md)712713### Other Contributions714715- Improve existing prompts and agents716- Share MCP server configurations717- Fix bugs in test harness718719---720721## License722723MIT724
Full transparency — inspect the skill content before installing.