Skills, prompts, 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
Coding agents like 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.
This repo provides that context:
- 127 skills for Azure SDK and Microsoft Foundry development
- Live Foundry docs — Context7-indexed documentation, updated via GitHub Actions workflow
- MCP server configs — Pre-configured servers for docs, GitHub, browser automation (full implementations)
- Custom Agents — Role-specific agents (backend, frontend, infrastructure, planner) with domain expertise
- AGENTS.md — Template for configuring agent behavior in your projects
Important
Use skills selectively. Loading all skills causes context rot: diluted attention, wasted tokens, conflated patterns. Only copy skills essential for your current project.
npx skills add microsoft/agent-skillsSelect 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.
Manual installation
# Clone and copy specific skills
git clone https://github.com/microsoft/agent-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/skills127 skills in
.github/skills/— flat structure with language suffixes for automatic discovery
| Language | Count | Suffix |
|---|---|---|
| Core | 5 | — |
| Python | 41 | -py |
| .NET | 29 | -dotnet |
| TypeScript | 24 | -ts |
| Java | 28 | -java |
5 skills — tooling, infrastructure, language-agnostic
| Skill | Description |
|---|---|
| azd-deployment | Deploy to Azure Container Apps with Azure Developer CLI (azd). Bicep infrastructure, remote builds, multi-service deployments. |
| github-issue-creator | Convert raw notes, error logs, or screenshots into structured GitHub issues. |
| mcp-builder | Build MCP servers for LLM tool integration. Python (FastMCP), Node/TypeScript, or C#/.NET. |
| podcast-generation | Generate podcast-style audio with Azure OpenAI Realtime API. Full-stack React + FastAPI + WebSocket. |
| skill-creator | Guide for creating effective skills for AI coding agents. |
41 skills • suffix:
-py
Foundry & AI (7 skills)
| Skill | Description |
|---|---|
| agent-framework-azure-ai-py | Agent Framework SDK — persistent agents, hosted tools, MCP servers, streaming. |
| azure-ai-agents-py | Low-level agents SDK — threads, messages, streaming, tools (File Search, Code Interpreter, Bing, OpenAPI). |
| azure-ai-contentsafety-py | Content Safety SDK — detect harmful content in text/images with multi-severity classification. |
| azure-ai-contentunderstanding-py | Content Understanding SDK — multimodal extraction from documents, images, audio, video. |
| azure-ai-evaluation-py | Evaluation SDK — quality, safety, and custom evaluators for generative AI apps. |
| azure-ai-projects-py | High-level Foundry SDK — project client, versioned agents, evals, connections, OpenAI-compatible clients. |
| azure-search-documents-py | AI Search SDK — vector search, hybrid search, semantic ranking, indexing, skillsets. |
AI Services (8 skills)
| Skill | Description |
|---|---|
| azure-ai-inference-py | Inference SDK — chat completions, embeddings with Azure AI Foundry endpoints. |
| azure-ai-ml-py | ML SDK v2 — workspaces, jobs, models, datasets, compute, pipelines. |
| azure-ai-textanalytics-py | Text Analytics — sentiment, entities, key phrases, PII detection, healthcare NLP. |
| azure-ai-transcription-py | Transcription SDK — real-time and batch speech-to-text with timestamps, diarization. |
| azure-ai-translation-document-py | Document Translation — batch translate Word, PDF, Excel with format preservation. |
| azure-ai-translation-text-py | Text Translation — real-time translation, transliteration, language detection. |
| azure-ai-vision-imageanalysis-py | Vision SDK — captions, tags, objects, OCR, people detection, smart cropping. |
| azure-ai-voicelive-py | Voice Live SDK — real-time bidirectional voice AI with WebSocket, VAD, avatars. |
Data & Storage (7 skills)
| Skill | Description |
|---|---|
| azure-cosmos-db-py | Cosmos DB patterns — FastAPI service layer, dual auth, partition strategies, TDD. |
| azure-cosmos-py | Cosmos DB SDK — document CRUD, queries, containers, globally distributed data. |
| azure-data-tables-py | Tables SDK — NoSQL key-value storage, entity CRUD, batch operations. |
| azure-storage-blob-py | Blob Storage — upload, download, list, containers, lifecycle management. |
| azure-storage-file-datalake-py | Data Lake Gen2 — hierarchical file systems, big data analytics. |
| azure-storage-file-share-py | File Share — SMB file shares, directories, cloud file operations. |
| azure-storage-queue-py | Queue Storage — reliable message queuing, task distribution. |
Messaging & Events (4 skills)
| Skill | Description |
|---|---|
| azure-eventgrid-py | Event Grid — publish events, CloudEvents, event-driven architectures. |
| azure-eventhub-py | Event Hubs — high-throughput streaming, producers, consumers, checkpointing. |
| azure-messaging-webpubsubservice-py | Web PubSub — real-time messaging, WebSocket connections, pub/sub. |
| azure-servicebus-py | Service Bus — queues, topics, subscriptions, enterprise messaging. |
Identity & Security (2 skills)
| Skill | Description |
|---|---|
| azure-identity-py | Identity SDK — DefaultAzureCredential, managed identity, service principals. |
| azure-keyvault-py | Key Vault — secrets, keys, and certificates management. |
Monitoring (4 skills)
| Skill | Description |
|---|---|
| azure-monitor-ingestion-py | Monitor Ingestion — send custom logs via Logs Ingestion API. |
| azure-monitor-opentelemetry-exporter-py | OpenTelemetry Exporter — low-level export to Application Insights. |
| azure-monitor-opentelemetry-py | OpenTelemetry Distro — one-line App Insights setup with auto-instrumentation. |
| azure-monitor-query-py | Monitor Query — query Log Analytics workspaces and Azure metrics. |
Integration & Management (5 skills)
| Skill | Description |
|---|---|
| azure-appconfiguration-py | App Configuration — centralized config, feature flags, dynamic settings. |
| azure-containerregistry-py | Container Registry — manage container images, artifacts, repositories. |
| azure-mgmt-apicenter-py | API Center — API inventory, metadata, governance. |
| azure-mgmt-apimanagement-py | API Management — APIM services, APIs, products, policies. |
| azure-mgmt-botservice-py | Bot Service — create and manage Azure Bot resources. |
Patterns & Frameworks (4 skills)
| Skill | Description |
|---|---|
| azure-mgmt-fabric-py | Fabric Management — Microsoft Fabric capacities and resources. |
| fastapi-router-py | FastAPI routers — CRUD operations, auth dependencies, response models. |
| foundry-iq-py | Foundry IQ — agentic retrieval with knowledge bases and Foundry Agent Service. |
| pydantic-models-py | Pydantic patterns — Base, Create, Update, Response, InDB model variants. |
29 skills • suffix:
-dotnet
Foundry & AI (8 skills)
| Skill | Description |
|---|---|
| azure-ai-agents-persistent-dotnet | Agents Persistent SDK — agent CRUD, threads, runs, streaming, function calling. |
| azure-ai-document-intelligence-dotnet | Document Intelligence — extract text, tables from invoices, receipts, IDs, forms. |
| azure-ai-inference-dotnet | Inference SDK — chat completions, embeddings for Azure AI Foundry endpoints. |
| azure-ai-openai-dotnet | Azure OpenAI — chat, embeddings, image generation, audio, assistants. |
| azure-ai-projects-dotnet | AI Projects SDK — Foundry project client, agents, connections, evals. |
| azure-ai-voicelive-dotnet | Voice Live — real-time voice AI with bidirectional WebSocket. |
| azure-mgmt-weightsandbiases-dotnet | Weights & Biases — ML experiment tracking via Azure Marketplace. |
| azure-search-documents-dotnet | AI Search — full-text, vector, semantic, hybrid search. |
Data & Storage (6 skills)
| Skill | Description |
|---|---|
| azure-mgmt-fabric-dotnet | Fabric ARM — provision, scale, suspend/resume Fabric capacities. |
| azure-resource-manager-cosmosdb-dotnet | Cosmos DB ARM — create accounts, databases, containers, RBAC. |
| azure-resource-manager-mysql-dotnet | MySQL Flexible Server — servers, databases, firewall, HA. |
| azure-resource-manager-postgresql-dotnet | PostgreSQL Flexible Server — servers, databases, firewall, HA. |
| azure-resource-manager-redis-dotnet | Redis ARM — cache instances, firewall, geo-replication. |
| azure-resource-manager-sql-dotnet | SQL ARM — servers, databases, elastic pools, failover groups. |
Messaging (3 skills)
| Skill | Description |
|---|---|
| azure-eventgrid-dotnet | Event Grid — publish events, CloudEvents, EventGridEvents. |
| azure-eventhub-dotnet | Event Hubs — high-throughput streaming, producers, processors. |
| azure-servicebus-dotnet | Service Bus — queues, topics, sessions, dead letter handling. |
Identity & Security (3 skills)
| Skill | Description |
|---|---|
| azure-identity-dotnet | Identity SDK — DefaultAzureCredential, managed identity, service principals. |
| azure-security-keyvault-keys-dotnet | Key Vault Keys — key creation, rotation, encrypt/decrypt, sign/verify. |
| microsoft-azure-webjobs-extensions-authentication-events-dotnet | Entra Auth Events — custom claims, token enrichment, attribute collection. |
Compute & Integration (6 skills)
| Skill | Description |
|---|---|
| azure-maps-search-dotnet | Azure Maps — geocoding, routing, map tiles, weather. |
| azure-mgmt-apicenter-dotnet | API Center — API inventory, governance, versioning, discovery. |
| azure-mgmt-apimanagement-dotnet | API Management ARM — APIM services, APIs, products, policies. |
| azure-mgmt-botservice-dotnet | Bot Service ARM — bot resources, channels (Teams, DirectLine). |
| azure-resource-manager-durabletask-dotnet | Durable Task ARM — schedulers, task hubs, retention policies. |
| azure-resource-manager-playwright-dotnet | Playwright Testing ARM — workspaces, quotas. |
Monitoring & Partner (3 skills)
| Skill | Description |
|---|---|
| azure-mgmt-applicationinsights-dotnet | Application Insights — components, web tests, workbooks. |
| azure-mgmt-arizeaiobservabilityeval-dotnet | Arize AI — ML observability via Azure Marketplace. |
| azure-mgmt-mongodbatlas-dotnet | MongoDB Atlas — manage Atlas orgs as Azure ARM resources. |
24 skills • suffix:
-ts
Foundry & AI (9 skills)
| Skill | Description |
|---|---|
| azure-ai-agents-ts | Agents SDK — tools (Code Interpreter, File Search), threads, streaming. |
| azure-ai-contentsafety-ts | Content Safety — moderate text/images, detect harmful content. |
| azure-ai-document-intelligence-ts | Document Intelligence — extract from invoices, receipts, IDs, forms. |
| azure-ai-inference-ts | Inference REST client — chat completions, embeddings, function tools. |
| azure-ai-projects-ts | AI Projects SDK — Foundry client, agents, connections, evals. |
| azure-ai-translation-ts | Translation — text translation, transliteration, document batch. |
| azure-ai-voicelive-ts | Voice Live — real-time voice AI with WebSocket, Node.js or browser. |
| azure-search-documents-ts | AI Search — vector/hybrid search, semantic ranking, knowledge bases. |
| fluent-ui-dark-ts | Fluent UI Dark — Vite + React + Framer Motion dark-themed UI design system. |
Data & Storage (4 skills)
| Skill | Description |
|---|---|
| azure-cosmos-ts | Cosmos DB — document CRUD, queries, bulk operations. |
| azure-storage-blob-ts | Blob Storage — upload, download, list, SAS tokens, streaming. |
| azure-storage-file-share-ts | File Share — SMB shares, directories, file operations. |
| azure-storage-queue-ts | Queue Storage — send, receive, peek, visibility timeout. |
Messaging (3 skills)
| Skill | Description |
|---|---|
| azure-eventhub-ts | Event Hubs — high-throughput streaming, partitioned consumers. |
| azure-servicebus-ts | Service Bus — queues, topics, sessions, dead-letter handling. |
| azure-web-pubsub-ts | Web PubSub — WebSocket real-time features, group chat, notifications. |
Identity, Security & Integration (4 skills)
| Skill | Description |
|---|---|
| azure-appconfiguration-ts | App Configuration — settings, feature flags, Key Vault references. |
| azure-identity-ts | Identity SDK — DefaultAzureCredential, managed identity, browser login. |
| azure-keyvault-keys-ts | Key Vault Keys — create, encrypt/decrypt, sign, rotate keys. |
| azure-keyvault-secrets-ts | Key Vault Secrets — store and retrieve application secrets. |
Monitoring & Frontend (4 skills)
| Skill | Description |
|---|---|
| azure-microsoft-playwright-testing-ts | Playwright Testing — scale browser tests, CI/CD integration. |
| azure-monitor-opentelemetry-ts | OpenTelemetry — tracing, metrics, logs with Application Insights. |
| react-flow-node-ts | React Flow nodes — custom nodes with TypeScript, handles, Zustand. |
| zustand-store-ts | Zustand stores — TypeScript, subscribeWithSelector, state/action separation. |
28 skills • suffix:
-java
Foundry & AI (9 skills)
| Skill | Description |
|---|---|
| azure-ai-agents-java | Agents SDK — models, tools, OpenAI capabilities. |
| azure-ai-agents-persistent-java | Agents Persistent — threads, messages, runs, streaming. |
| azure-ai-anomalydetector-java | Anomaly Detector — univariate/multivariate time-series analysis. |
| azure-ai-contentsafety-java | Content Safety — text/image analysis, blocklist management. |
| azure-ai-formrecognizer-java | Form Recognizer — extract text, tables, key-value pairs from documents. |
| azure-ai-inference-java | Inference SDK — chat completions, embeddings with Foundry endpoints. |
| azure-ai-projects-java | AI Projects — Foundry project management, connections, datasets. |
| azure-ai-vision-imageanalysis-java | Vision SDK — captions, OCR, object detection, tagging. |
| azure-ai-voicelive-java | Voice Live — real-time voice conversations with WebSocket. |
Communication (5 skills)
| Skill | Description |
|---|---|
| azure-communication-callautomation-java | Call Automation — IVR, call routing, recording, DTMF, TTS. |
| azure-communication-callingserver-java | CallingServer (legacy) — deprecated, use callautomation for new projects. |
| azure-communication-chat-java | Chat SDK — threads, messaging, participants, read receipts. |
| azure-communication-common-java | Common utilities — token credentials, user identifiers. |
| azure-communication-sms-java | SMS SDK — notifications, alerts, OTP delivery, bulk messaging. |
Data & Storage (3 skills)
| Skill | Description |
|---|---|
| azure-cosmos-java | Cosmos DB — NoSQL operations, global distribution, reactive patterns. |
| azure-data-tables-java | Tables SDK — Table Storage or Cosmos DB Table API. |
| azure-storage-blob-java | Blob Storage — upload, download, containers, streaming. |
Messaging (3 skills)
| Skill | Description |
|---|---|
| azure-eventgrid-java | Event Grid — publish events, pub/sub patterns. |
| azure-eventhub-java | Event Hubs — high-throughput streaming, event-driven architectures. |
| azure-messaging-webpubsub-java | Web PubSub — WebSocket messaging, live updates, chat. |
Identity & Security (3 skills)
| Skill | Description |
|---|---|
| azure-identity-java | Identity SDK — DefaultAzureCredential, managed identity, service principals. |
| azure-security-keyvault-keys-java | Key Vault Keys — RSA/EC keys, encrypt/decrypt, sign/verify, HSM. |
| azure-security-keyvault-secrets-java | Key Vault Secrets — passwords, API keys, connection strings. |
Monitoring & Integration (5 skills)
| Skill | Description |
|---|---|
| azure-appconfiguration-java | App Configuration — settings, feature flags, snapshots. |
| azure-compute-batch-java | Batch SDK — large-scale parallel and HPC jobs. |
| azure-monitor-ingestion-java | Monitor Ingestion — custom logs via Data Collection Rules. |
| azure-monitor-opentelemetry-exporter-java | OpenTelemetry Exporter — traces, metrics, logs to Azure Monitor. (Deprecated) |
| azure-monitor-query-java | Monitor Query — Kusto queries, Log Analytics, metrics. (Deprecated) |
AGENTS.md # Agent configuration template
.github/
├── skills/ # All 127 skills (flat structure)
├── prompts/ # Reusable prompt templates
├── agents/ # Agent persona definitions
├── scripts/ # Automation scripts (doc scraping)
├── workflows/ # GitHub Actions (daily doc updates)
└── copilot-instructions.md
output/ # Generated llms.txt files (daily workflow)
├── llms.txt # Links + summaries
└── llms-full.txt # Full content
skills/ # Symlinks for backward compatibility
├── python/ # -> ../.github/skills/*-py
├── dotnet/ # -> ../.github/skills/*-dotnet
├── typescript/ # -> ../.github/skills/*-ts
└── java/ # -> ../.github/skills/*-java
.vscode/
└── mcp.json # MCP server configurations
Reference configurations in .vscode/mcp.json:
| Category | Servers |
|---|---|
| Documentation | microsoft-docs, context7, deepwiki |
| Development | github, playwright, terraform, eslint |
| Utilities | sequentialthinking, memory, markitdown |
For full MCP server implementations for Azure services, see microsoft/mcp.
Role-specific agent personas in .github/agents/:
| Agent | Expertise |
|---|---|
backend.agent.md |
FastAPI, Pydantic, Cosmos DB, Azure services |
frontend.agent.md |
React, TypeScript, React Flow, Zustand, Tailwind |
infrastructure.agent.md |
Bicep, Azure CLI, Container Apps, networking |
planner.agent.md |
Task decomposition, architecture decisions |
presenter.agent.md |
Documentation, demos, technical writing |
Use AGENTS.md as a template for configuring agent behavior in your own projects.
Reusable prompt templates in .github/prompts/ for code reviews, component creation, and common workflows.
Context7 indexes this repo's Foundry documentation with semantic search. Updated daily via GitHub workflow:
- Scrapes the latest Azure AI Foundry TOC from Microsoft Learn
- Generates
llms.txt(links + summaries) andllms-full.txt(full content) - Creates a PR if documentation has changed
These files follow the llms.txt specification for LLM-friendly documentation.
- Add new skills for Azure SDKs
- Improve existing prompts and agents
- Share MCP server configurations
MIT