Agent Skills

[!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 132 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.

<details> <summary>Alternative installation methods</summary>

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

</details>

---

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 | |----------|-------------| | 128 Skills | Domain-specific knowledge for Azure SDK and Foundry development | | Plugins | Installable plugin packages (deep-wiki, azure-skills and more) | | Custom Agents | Role-specific agents (backend, frontend, infrastructure, planner) | | AGENTS.md | Template for configuring agent behavior in your projects | | MCP Configs | Pre-configured servers for docs, GitHub, browser automation | | Documentation | Repo docs and usage guides |

---

Skill Catalog

132 skills in .github/skills/ — flat structure with language suffixes for automatic discovery

| Language | Count | Suffix | |----------|-------|--------| | Core | 9 | — | | Python | 41 | -py | | .NET | 28 | -dotnet | | TypeScript | 25 | -ts | | Java | 25 | -java | | Rust | 7 | -rust |

---

Core

9 skills — tooling, infrastructure, language-agnostic

| Skill | Description | |-------|-------------| | cloud-solution-architect | Design well-architected Azure cloud systems. Architecture styles, 44 design patterns, technology choices, mission-critical design, WAF pillars. | | copilot-sdk | Build applications powered by GitHub Copilot using the Copilot SDK. Session management, custom tools, streaming, hooks, MCP servers, BYOK, deployment patterns. | | 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 | Review and create distinctive frontend interfaces. Design system compliance, quality pillars, accessibility, and creative aesthetics. | | 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. |

---

Python

41 skills • suffix: -py

<details> <summary><strong>Foundry & AI</strong> (7 skills)</summary>

| Skill | Description | |-------|-------------| | agent-framework-azure-ai-py | Agent Framework SDK — persistent agents, hosted tools, MCP servers, streaming. | | 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. | | agents-v2-py | Foundry Agents SDK — container-based agents with ImageBasedHostedAgentDefinition, custom images, tools. | | 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. |

</details> <details> <summary><strong>M365</strong> (1 skill)</summary>

| Skill | Description | |-------|-------------| | m365-agents-py | Microsoft 365 Agents SDK — aiohttp hosting, AgentApplication routing, streaming, Copilot Studio client. |

</details> <details> <summary><strong>AI Services</strong> (8 skills)</summary>

| Skill | Description | |-------|-------------| | 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. | | azure-speech-to-text-rest-py | Speech to Text REST API — transcribe short audio (≤60 seconds) via HTTP without Speech SDK. |

</details> <details> <summary><strong>Data & Storage</strong> (7 skills)</summary>

| 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 Stor