Skills

Agent Skills

[](https://github.com/microsoft/skills/actions/workflows/test-harness.yml) [](https://github.com/microsoft/skills/actions/workflows/skill-evaluation.yml) [](https://skills.sh/microsoft/skills) [](https://microsoft.github.io/skills/#documentation)

> [!NOTE] > 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!

Skills, custom agents, AGENTS.md templates, and MCP configurations for AI coding agents working with Azure SDKs and Microsoft AI Foundry.

> Blog post: Context-Driven Development: Agent Skills for Microsoft Foundry and Azure

> 🔍 Skill Explorer: Browse all 175 skills with 1-click install

Quick Start

npx skills add microsoft/skills

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)

# Clone and copy specific skills
git clone https://github.com/microsoft/skills.git
cp -r agent-skills/.github/skills/azure-cosmos-db-py your-project/.github/skills/

# Or use symlinks for multi-project setups
ln -s /path/to/agent-skills/.github/skills/mcp-builder /path/to/your-project/.github/skills/mcp-builder

# Share skills across different agent configs in the same repo
ln -s ../.github/skills .opencode/skills
ln -s ../.github/skills .claude/skills

---

Coding agents like Copilot CLI and GitHub Copilot in VS Code 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.

> [!IMPORTANT] > Use skills selectively. Loading all skills causes context rot: diluted attention, wasted tokens, conflated patterns. Only copy skills essential for your current project.

---

---

What's Inside

| Resource | Description | |----------|-------------| | [174 Skills](#skill-catalog) | Domain-specific knowledge for Azure SDK and Foundry development | | [Plugins](#plugins) | Installable plugin packages (deep-wiki, azure-skills and more) | | [Custom Agents](#agents) | Role-specific agents (backend, frontend, infrastructure, planner) | | [AGENTS.md](AGENTS.md) | Template for configuring agent behavior in your projects | | [MCP Configs](#mcp-servers) | Pre-configured servers for docs, GitHub, browser automation | | Documentation | Repo docs and usage guides |

---

Skill Catalog

> 175 skills across language plugins — see [skill catalog](#skill-catalog) below for the full breakdown

| Language | Count | Suffix | |----------|-------|--------| | [Core](#core) | 11 | — | | [Foundry (Language-Agnostic)](#foundry-language-agnostic) | 11 | — | | [Python](#python) | 39 | -py | | [.NET](#net) | 28 | -dotnet | | [TypeScript](#typescript) | 25 | -ts | | [Java](#java) | 25 | -java | | [Rust](#rust) | 7 | -rust |

---

Core

> 11 skills — tooling, infrastructure, language-agnostic

| Skill | Description | |-------|-------------| | [cloud-solution-architect](.github/skills/cloud-solution-architect/) | Design well-architected Azure cloud systems. Architecture styles, 44 design patterns, technology choices, mission-critical design, WAF pillars. | | [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. | | [debugview](.github/skills/debugview/) | Sysinternals DebugView CLI — capture and analyze usermode/kernel-mode Windows debug output. Bounded execution, filtering, boot logging, remote monitoring. | | [entra-agent-id](.github/skills/entra-agent-id/) | Microsoft Entra Agent ID (preview) — create OAuth2-capable AI agent identities via Microsoft Graph beta API. Blueprints, BlueprintPrincipals, permissions, WIF. | | [frontend-design-review](.github/skills/frontend-design-review/) | Review and create distinctive frontend interfaces. Design system compliance, quality pillars, accessibility, and creative aesthetics. | | [github-issue-creator](.github/skills/github-issue-creator/) | Convert raw notes, error logs, or screenshots into structured GitHub issues. | | [github-primer-brand](.github/skills/github-primer-brand/) | Design GitHub-branded marketing surfaces with @primer/react-brand. Color, typography, layout, components, theming, motion, voice, and anti-patterns for landing pages, launch sites, and campaign surfaces. | | [mcp-builder](.github/skills/mcp-builder/) | Build MCP servers for LLM tool integration. Python (FastMCP), Node/TypeScript, or C#/.NET. | | [podcast-generation](.github/skills/podcast-generation/) | Generate podcast-style audio with Azure OpenAI Realtime API. Full-stack React + FastAPI + WebSocket. | | [skill-creator](.github/skills/skill-creator/) | Guide for creating effective skills for AI coding agents. |

---

Foundry (Language-Agnostic)

> 11 skills — Microsoft Foundry agent platform (preview), language-agnostic via azd, az CLI, and Foundry MCP

| Skill | Description | |-------|-------------| | [microsoft-foundry](.github/plugins/azure-skills/skills/microsoft-foundry/) | Router skill for the Foundry agent platform — maps user intent onto the right sub-skill and discovery surface (Microsoft Docs MCP, Foundry MCP, azd ai agent, az CLI). | | [foundry-projects-resources](.github/plugins/azure-skills/skills/foundry-projects-resources/) | Provision Foundry resources/projects, configure project connections (key, OAuth, managed identity, agent identity), and set up standard or private-network agent infrastructure. | | [foundry-models](.github/plugins/azure-skills/skills/foundry-models/) | Discover, deploy, and manage models on Foundry — preset/customized deployments, capacity discovery, quota management, PTU vs pay-as-you-go. | | [foundry-hosted-agents](.github/plugins/azure-skills/skills/foundry-hosted-agents/) | Build, deploy, and manage Foundry hosted agents — containerized agents exposing Responses or Invocations protocols, with per-agent Entra identity and dedicated endpoints. | | [foundry-toolboxes](.github/plugins/azure-skills/skills/foundry-toolboxes/) | Curate intent-based Foundry Toolboxes (preview) — a single MCP-compatible endpoint bundling tools (MCP, Web Search, AI Search, Code Interpreter, File Search, OpenAPI, A2A) for any agent to consume. | | [foundry-workflows](.github/plugins/azure-skills/skills/foundry-workflows/) | Build multi-agent workflows — declarative orchestration for handing off control between specialist agents, plus the Connected Agents pattern. | | [foundry-iq-knowledge-bases](.github/plugins/azure-skills/skills/foundry-iq-knowledge-bases/) | Build Foundry IQ knowledge bases (preview) — multi-source, permission-aware grounding for agents using the agentic retrieval pipeline. | | [foundry-managed-skills](.github/plugins/azure-skills/skills/foundry-managed-skills/) | Manage SKILL.md files as a Foundry-side resource (preview) — author behavioral guidelines once, store via the Skills REST API, load into hosted agent containers. | | [foundry-memory](.github/plugins/azure-skills/skills/foundry-memory/) | Build personalized Foundry agents with managed long-term memory (preview) — extract, consolidate, and retrieve user-specific context across sessions. | | [foundry-observability](.github/plugins/azure-skills/skills/foundry-observability/) | Trace, monitor, and evaluate Foundry hosted agents end-to-end — OpenTelemetry GenAI traces in App Insights, eval-trace correlation, batch evals, regression detection. | | [foundry-governance](.github/plugins/azure-skills/skills/foundry-governance/) | Govern Foundry agent fleets at scale — tool catalog visibility, AI Gateway MCP routing/policy, RBAC, agent identity, RAI policies on model deployments. |

---

Python

> 39 skills • suffix: -py

Foundry & AI (5 skills)

| Skill | Description | |-------|-------------| | [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. | | [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. | | [azure-ai-contentunderstanding-py](.github/plugins/azure-sdk-python/skills/azure-ai-contentunderstanding-py/) | Content Understanding SDK — multimodal extraction from documents, images, audio, video. | | [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. | | [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. |

M365 (1 skill)

| Skill | Description | |-------|-------------| | [m365-agents-py](.github/plugins/azure-sdk-python/skills/m365-agents-py/) | Microsoft 365 Agents SDK — aiohttp hosting, AgentApplication routing, streaming, Copilot Studio client. |

AI Services (8 skills)

| Skill | Description | |-------|-------------| | [azure-ai-ml-py](.github/plugins/azure-sdk-python/skills/azure-ai-ml-py/) | ML SDK v2 — workspaces, jobs, models, datasets, compute, pipelines. | | [azure-ai-textanalytics-py](.github/plugins/azure-sdk-python/skills/azure-ai-textanalytics-py/) | Text Analytics — sentiment, entities, key phrases, PII detection, healthcare NLP. | | [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. | | [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. | | [azure-ai-translation-text-py](.github/plugins/azure-sdk-python/skills/azure-ai-translation-text-py/) | Text Translation — real-time translation, transliteration, language detection. | | [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. | | [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. | | [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. |

Data & Storage (7 skills)

| Skill | Description | |-------|-------------| | [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. | | [azure-cosmos-py](.github/plugins/azure-sdk-python/skills/azure-cosmos-py/) | Cosmos DB SDK — document CRUD, queries, containers, globally distributed data. | | [azure-data-tables-py](.github/plugins/azure-sdk-python/skills/azure-data-tables-py/) | Tables SDK — NoSQL key-value storage, entity CRUD, batch operations. | | [azure-storage-blob-py](.github/plugins/azure-sdk-python/skills/azure-storage-blob-py/) | Blob Storage — upload, download, list, containers, lifecycle management. | | [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. | | [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. | | [azure-storage-queue-py](.github/plugins/azure-sdk-python/skills/azure-storage-queue-py/) | Queue Storage — reliable message queuing, task distribution. |

Messaging & Events (4 skills)

| Skill | Description | |-------|-------------| | [azure-eventgrid-py](.github/plugins/azure-sdk-python/skills/azure-eventgrid-py/) | Event Grid — publish events, CloudEvents, event-driven architectures. | | [azure-eventhub-py](.github/plugins/azure-sdk-python/skills/azure-eventhub-py/) | Event Hubs — high-throughput streaming, producers, consumers, checkpointing. | | [azure-messaging-webpubsubservice-py](.github/plugins/azure-sdk-python/skills/azure-messaging-webpubsubservice-py/) | Web PubSub — real-time messaging, WebSocket connections, pub/sub. | | [azure-servicebus-py](.github/plugins/azure-sdk-python/skills/azure-servicebus-py/) | Service Bus — queues, topics, subscriptions, enterprise messaging. |

Entra (2 skills)

| Skill | Description | |-------|-------------| | [azure-identity-py](.github/plugins/azure-sdk-python/skills/azure-identity-py/) | Identity SDK — DefaultAzureCredential, managed identity, service principals. | | [azure-keyvault-py](.github/plugins/azure-sdk-python/skills/azure-keyvault-py/) | Key Vault — secrets, keys, and certificates management. |

Monitoring (4 skills)

| Skill | Description | |-------|-------------| | [azure-monitor-ingestion-py](.github/plugins/azure-sdk-python/skills/azure-monitor-ingestion-py/) | Monitor Ingestion — send custom logs via Logs Ingestion API. | | [azure-monitor-opentelemetry-exporter-py](.github/plugins/azure-sdk-python/skills/azure-monitor-opentelemetry-exporter-py/) | OpenTelemetry Exporter — low-level export to Application Insights. | | [azure-monitor-opentelemetry-py](.github/plugins/azure-sdk-python/skills/azure-monitor-opentelemetry-py/) | OpenTelemetry Distro — one-line App Insights setup with auto-instrumentation. | | [azure-monitor-query-py](.github/plugins/azure-sdk-python/skills/azure-monitor-query-py/) | Monitor Query — query Log Analytics workspaces and Azure metrics. |

Integration & Management (5 skills)

| Skill | Description | |-------|-------------| | [azure-appconfiguration-py](.github/plugins/azure-sdk-python/skills/azure-appconfiguration-py/) | App Configuration — centralized config, feature flags, dynamic settings. | | [azure-containerregistry-py](.github/plugins/azure-sdk-python/skills/azure-containerregistry-py/) | Container Registry — manage container images, artifacts, repositories. | | [azure-mgmt-apicenter-py](.github/plugins/azure-sdk-python/skills/azure-mgmt-apicenter-py/) | API Center — API inventory, metadata, governance. | | [azure-mgmt-apimanagement-py](.github/plugins/azure-sdk-python/skills/azure-mgmt-apimanagement-py/) | API Management — APIM services, APIs, products, policies. | | [azure-mgmt-botservice-py](.github/plugins/azure-sdk-python/skills/azure-mgmt-botservice-py/) | Bot Service — create and manage Azure Bot resources. |

Patterns & Frameworks (3 skills)

| Skill | Description | |-------|-------------| | [azure-mgmt-fabric-py](.github/plugins/azure-sdk-python/skills/azure-mgmt-fabric-py/) | Fabric Management — Microsoft Fabric capacities and resources. | | [fastapi-router-py](.github/plugins/azure-sdk-python/skills/fastapi-router-py/) | FastAPI routers — CRUD operations, auth dependencies, response models. | | [pydantic-models-py](.github/plugins/azure-sdk-python/skills/pydantic-models-py/) | Pydantic patterns — Base, Create, Update, Response, InDB model variants. |

---

.NET

> 29 skills • suffix: -dotnet

Foundry & AI (6 skills)

| Skill | Description | |-------|-------------| | [azure-ai-docume

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: microsoft
• Source: microsoft/skills
• License: MIT
• Homepage: https://microsoft.github.io/skills/

Install and usage instructions live in the source repository linked above.