Skip to content
Back to search

microsoft-agent-skills

MarketplaceWorks with Claude CodeGitHub

Curated Agent Skills for Microsoft & Azure โ€“ giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/microsoftdocs-agent-skills/badge.svg)](/listings/microsoftdocs-agent-skills)

HTML

<a href="/listings/microsoftdocs-agent-skills"><img src="/api/listings/microsoftdocs-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

A short path to getting started โ€” full installation details are in the [๐Ÿ› ๏ธ Installation](#๏ธ-installation) section below.

**๏ฟฝ Plugin install (recommended):** VS Code, Claude Code, and Codex can install everything as a single agent plugin โ€” no cloning or copying.

- **VS Code:** Command Palette โ†’ **Chat: Install Plugin From Source** โ†’ paste `https://github.com/MicrosoftDocs/agent-skills` - **Claude Code:** `/plugin marketplace add MicrosoftDocs/agent-skills`, then `/plugin install azure-agent-skills@microsoft-agent-skills` - **Codex:** `codex plugin marketplace add MicrosoftDocs/agent-skills`, then install **azure-agent-skills** from `/plugins`

> ๐Ÿ‘‰ See [โšก One-Click Plugin Install](#-one-click-plugin-install) for full steps and the marketplace options.

**๐Ÿ› ๏ธ Other assistants (manual):**

1. Clone the repo:

   git clone https://github.com/MicrosoftDocs/agent-skills.git

2. Copy the contents of the `skills/` folder to your AI assistant's skills path (see [๐Ÿ› ๏ธ Installation](#๏ธ-installation) for the destination table and important notes).

3. VS Code users (manual mode): enable `chat.agent.skills` in Settings so the editor will load skills.

4. Start coding โ€” your AI assistant will automatically discover and use the installed skills.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json ยท Manifest ยท 31 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "microsoft-agent-skills",
  3. "metadata": {
  4. "description": "Azure Agent Skills โ€” a curated marketplace of production-ready agentic skills for Microsoft Azure development.",
  5. "version": "1.0.0"
  6. },
  7. "owner": {
  8. "name": "Microsoft"
  9. },
  10. "plugins": [
  11. {
  12. "name": "azure-agent-skills",
  13. "source": "./",
  14. "description": "193+ production-ready Azure skills covering compute, data, AI/ML, networking, security, and management. Built from Microsoft Learn and following the Agent Skills open standard.",
  15. "version": "1.0.0",
  16. "skills": [
  17. "./skills"
  18. ],
  19. "repository": "https://github.com/MicrosoftDocs/agent-skills",
  20. "license": "MIT",
  21. "keywords": [
  22. "azure",
  23. "microsoft",
  24. "agent-skills",
  25. "cloud",
  26. "devops",
  27. "ai"
  28. ]
  29. }
  30. ]
  31. }
README.md ยท README ยท 489 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # โ˜๏ธ Azure Agent Skills
  2. > ๐Ÿš€ **Agentic Skills for Azure Development**
  3. >
  4. > Supercharge your AI coding assistant with curated, production-ready skills for Microsoft Azure. Works seamlessly with:
  5. >
  6. > ๐ŸŸฃ **Claude Code** | ๐Ÿ”ต **Gemini CLI** | ๐ŸŸข **Codex CLI** | ๐Ÿ”ด **Antigravity IDE** | ๐Ÿฉต **GitHub Copilot** | ๐ŸŸ  **Cursor** | โšช **OpenCode** | ๐ŸŒธ **AdaL CLI**
  7. ---
  8. [![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)
  9. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  10. [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Open%20Standard-green)](https://agentskills.io/)
  11. [![Copilot](https://img.shields.io/badge/GitHub%20Copilot-VSCode-lightblue)](https://github.com/features/copilot)
  12. [![Claude Code](https://img.shields.io/badge/Claude%20Code-Anthropic-purple)](https://claude.ai)
  13. [![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Google-blue)](https://github.com/google-gemini/gemini-cli)
  14. [![Codex CLI](https://img.shields.io/badge/Codex%20CLI-OpenAI-green)](https://github.com/openai/codex)
  15. [![Cursor](https://img.shields.io/badge/Cursor-AI%20IDE-orange)](https://cursor.sh)
  16. [![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray)](https://github.com/opencode-ai/opencode)
  17. [![Antigravity](https://img.shields.io/badge/Antigravity-DeepMind-red)](https://github.com/sickn33/antigravity-awesome-skills)
  18. [![AdaL CLI](https://img.shields.io/badge/AdaL%20CLI-SylphAI-pink)](https://sylph.ai/)
  19. Azure Agent Skills is a curated collection of **high-quality agentic skills** specifically designed for Azure cloud development. These skills follow the [Agent Skills open standard](https://agentskills.io/) and work seamlessly with modern AI coding assistants to provide expert-level guidance on Azure services.
  20. ---
  21. ## ๐Ÿ“ Table of Contents
  22. - [๐Ÿš€ New Here? Start Here!](#-new-here-start-here)
  23. - [โšก One-Click Plugin Install](#-one-click-plugin-install)
  24. - [๐Ÿ”Œ Compatibility & Invocation](#-compatibility--invocation)
  25. - [๐Ÿ“ฆ Features & Categories](#-features--categories)
  26. - [๐ŸŽ Curated Collections (Bundles)](#-curated-collections-bundles)
  27. - [๐Ÿ“š Browse All Skills](#-browse-all-skills)
  28. - [๐Ÿ› ๏ธ Installation](#๏ธ-installation)
  29. - [๐Ÿง  How to Use](#-how-to-use)
  30. - [๐Ÿ“– Agent Skills Documentation](#-agent-skills-documentation)
  31. - [๐Ÿค How to Contribute](#-how-to-contribute)
  32. - [โš–๏ธ License](#๏ธ-license)
  33. ---
  34. ## ๐Ÿš€ New Here? Start Here!
  35. ### 1. ๐Ÿฃ What is this?
  36. AI Agents (like GitHub Copilot, Claude Code, or Cursor) are smart, but they lack specific, up-to-date knowledge about Azure services. **Skills** are folders containing markdown instructions, scripts, and resources that teach AI agents how to work with Azure services correctly, every time.
  37. > ๐Ÿ’ก Skills are reusable, filesystem-based resources that provide AI agents with domain-specific expertise. They load on-demand and eliminate the need to repeatedly provide the same guidance across conversations.
  38. ### 2. ๐Ÿ“š How These Skills Are Created
  39. Microsoft Learn documentation already encodes **decisions, procedures, best practices, and constraints** โ€” exactly what agents need to act effectively. Rather than relying on RAG to retrieve and summarize raw text every time, we **pre-compile this knowledge into structured, executable skills**.
  40. **Documentation as Pre-Built Skills**: Many effective agent skills are not new inventions โ€” they are structured patterns, workflows, and decision logic that already exist in documentation. Consider what Learn content contains:
  41. - API patterns and usage guidance
  42. - Service configuration procedures
  43. - Platform best practices and constraints
  44. - Troubleshooting decision trees
  45. - Security and compliance requirements
  46. **Our approach:**
  47. 1. **Extract** high-value, task-oriented capabilities from Learn content
  48. 2. **Classify** by purpose (limits, troubleshooting, configuration, architecture, etc.)
  49. 3. **Reveal** only when relevant to the user's intent
  50. The knowledge is **pre-compiled into actions, choices, and guardrails** the agent can use directly โ€” not raw text that needs interpretation.
  51. Each skill provides:
  52. - ๐Ÿ“š Curated documentation links organized by topic
  53. - ๐Ÿ”— Direct access to Microsoft Learn content
  54. - ๐ŸŽฏ Best practices and architecture patterns
  55. - โš ๏ธ Troubleshooting guides and common pitfalls
  56. ### 3. โšก๏ธ Quick Start
  57. A short path to getting started โ€” full installation details are in the [๐Ÿ› ๏ธ Installation](#๏ธ-installation) section below.
  58. **๏ฟฝ Plugin install (recommended):** VS Code, Claude Code, and Codex can install everything as a single agent plugin โ€” no cloning or copying.
  59. - **VS Code:** Command Palette โ†’ **Chat: Install Plugin From Source** โ†’ paste `https://github.com/MicrosoftDocs/agent-skills`
  60. - **Claude Code:** `/plugin marketplace add MicrosoftDocs/agent-skills`, then `/plugin install azure-agent-skills@microsoft-agent-skills`
  61. - **Codex:** `codex plugin marketplace add MicrosoftDocs/agent-skills`, then install **azure-agent-skills** from `/plugins`
  62. > ๐Ÿ‘‰ See [โšก One-Click Plugin Install](#-one-click-plugin-install) for full steps and the marketplace options.
  63. **๐Ÿ› ๏ธ Other assistants (manual):**
  64. 1. Clone the repo:
  65. ```bash
  66. git clone https://github.com/MicrosoftDocs/agent-skills.git
  67. ```
  68. 2. Copy the contents of the `skills/` folder to your AI assistant's skills path (see [๐Ÿ› ๏ธ Installation](#๏ธ-installation) for the destination table and important notes).
  69. 3. VS Code users (manual mode): enable `chat.agent.skills` in Settings so the editor will load skills.
  70. 4. Start coding โ€” your AI assistant will automatically discover and use the installed skills.
  71. ### 4. ๐Ÿง  How Skills Work
  72. Skills use **progressive disclosure** to efficiently load content only when needed:
  73. 1. **Level 1 - Discovery**: Agent reads skill `name` and `description` from YAML frontmatter
  74. 2. **Level 2 - Instructions**: When triggered, agent loads the full `SKILL.md` content
  75. 3. **Level 3 - Resources**: Agent accesses additional files (scripts, examples) as needed
  76. Once installed, just ask your AI assistant naturally:
  77. > "Help me set up Azure Functions with Durable Functions"
  78. >
  79. > "What are the best practices for Azure Container Apps?"
  80. >
  81. > "How do I configure Azure API Management?"
  82. The skills will automatically provide context from official Microsoft documentation.
  83. ---
  84. ## โšก One-Click Plugin Install
  85. > ๐Ÿš€ **Recommended.** This repository ships as a ready-to-use **[agent plugin](https://code.visualstudio.com/docs/agent-customization/agent-plugins)** with native manifests for every major assistant. Install once and **all 193+ skills** are available โ€” no cloning, no copying, no manual `skills/` setup.
  86. ### ๐ŸŸฆ VS Code
  87. **Option 1 โ€” Install directly from source**
  88. 1. Open the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`).
  89. 2. Run **Chat: Install Plugin From Source**.
  90. 3. Paste the repository URL:
  91. ```
  92. https://github.com/MicrosoftDocs/agent-skills
  93. ```
  94. 4. VS Code clones and installs the plugin. All skills now appear in **Chat: Configure Skills**.
  95. **Option 2 โ€” Add it as a plugin marketplace**
  96. Register this repo as a marketplace to browse and install (and get updates) from the Extensions view.
  97. 1. Add the repository to your `chat.plugins.marketplaces` setting:
  98. ```jsonc
  99. // settings.json
  100. "chat.plugins.marketplaces": [
  101. "MicrosoftDocs/agent-skills"
  102. ]
  103. ```
  104. 2. Open the **Extensions** view (`Ctrl+Shift+X`) and search `@agentPlugins`.
  105. 3. Find **azure-agent-skills** and select **Install**.
  106. > โš ๏ธ **Preview feature.** Agent plugins require `chat.plugins.enabled` to be set to `true`. This setting may be managed by your organization. If you don't see the option, ask your administrator or use the [manual installation](#๏ธ-installation) below.
  107. ### ๐ŸŸฃ Claude Code
  108. Claude Code installs this repo as a plugin through its marketplace. From within Claude Code:
  109. 1. Add this repository as a marketplace:
  110. ```
  111. /plugin marketplace add MicrosoftDocs/agent-skills
  112. ```
  113. 2. Install the plugin:
  114. ```
  115. /plugin install azure-agent-skills@microsoft-agent-skills
  116. ```
  117. 3. Run `/reload-plugins` (or restart Claude Code) to activate. All skills are now available.
  118. ### ๐ŸŸข OpenAI Codex
  119. Codex installs this repo as a plugin through its plugin browser. From the Codex CLI:
  120. 1. Add this repository as a marketplace:
  121. ```
  122. codex plugin marketplace add MicrosoftDocs/agent-skills
  123. ```
  124. 2. Open the plugin browser and install **azure-agent-skills** from the **microsoft-agent-skills** marketplace:
  125. ```
  126. /plugins
  127. ```
  128. 3. Restart Codex if the skills don't appear immediately.
  129. > ๐Ÿ’ก **One repo, every tool.** The same repository ships native plugin manifests for each ecosystem โ€” [`plugin.json`](plugin.json) (VS Code / Copilot CLI), [`.claude-plugin/`](.claude-plugin/) (Claude Code), and [`.codex-plugin/`](.codex-plugin/) + [`.agents/plugins/`](.agents/plugins/) (Codex) โ€” so a single install gets you all skills wherever you work.
  130. ---
  131. ## ๐Ÿ”Œ Compatibility & Invocation
  132. These skills follow the [Agent Skills open standard](https://agentskills.io/) (`SKILL.md` format) and work with any AI coding assistant that supports agentic skills.
  133. | AI Coding Assistant | Type | Skills Path / Location | How to Invoke |
  134. |-------------------------|----------------|-------------------------------|-------------------------------------|
  135. | **Claude Code** | Anthropic CLI | `.claude/skills/` | Natural language, `/skill-name` |
  136. | **Gemini CLI** | Google DeepMind| `.gemini/skills/` | Natural language |
  137. | **Codex CLI** | OpenAI | `.codex/skills/` | Natural language |
  138. | **Antigravity IDE** | DeepMind IDE | `.agent/skills/` | Agent mode, natural language |
  139. | **GitHub Copilot** | VSCode Ext | `.github/skills/` | Natural language, `@workspace` |
  140. | **Cursor** | AI-native IDE | `.cursor/skills/` | `@skill-name` in Chat |
  141. | **OpenCode** | Open-source CLI| `.agent/skills/` | `opencode run @skill-name` |
  142. | **AdaL CLI** | SylphAI Agent | `.adal/skills/` | Auto-load, natural language |
  143. > ๐Ÿ’ก **Path Note:** `~` refers to your home directory:
  144. > - **macOS/Linux:** `~` = `/Users/yourname` or `/home/yourname`
  145. > - **Windows:** `~` = `%USERPROFILE%` = `C:\Users\yourname` (use `$HOME` in PowerShell)
  146. > ๐Ÿ’ก **Tip:** Most modern tools support `.agent/skills/` as a universal path. For GitHub Copilot, `.github/skills/` is recommended per the [Agent Skills specification](https://agentskills.io/specification).
  147. ---
  148. ## ๐Ÿ“ฆ Features & Categories
  149. The repository is organized by Azure service domains:
  150. | Category | Skills | Examples |
  151. |----------|--------|----------|
  152. | โ˜๏ธ **Compute** | 13 | Azure App Service, Azure Batch, Azure Cloud Services, Azure Cyclecloud, Azure Functions |
  153. | ๐Ÿ”— **Integration** | 16 | Azure API Center, Azure API Management, Azure Business Process Tracking, Azure Communication Services, Azure Data API Builder |
  154. | ๐Ÿ“Š **Data & Analytics** | 19 | Azure Analysis Services, Azure Cache Redis, Azure Cosmos Db, Azure Data Explorer, Azure Data Factory |
  155. | ๐Ÿค– **AI & ML** | 23 | Azure AI Services, Azure AI Vision, Azure Anomaly Detector, Azure Bot Service, Azure Cognitive Search, Azure Foundry Classic, Azure Foundry Local, Microsoft Foundry |
  156. | ๐Ÿ”’ **Security & Identity** | 19 | Azure Active Directory B2C, Azure Attestation, Azure Cloud Hsm, Azure Confidential Computing, Azure Confidential Ledger |
  157. | ๐ŸŒ **Networking** | 23 | Azure Application Gateway, Azure Bastion, Azure DDoS Protection, Azure Dns, Azure Expressroute |
  158. | ๐Ÿ—๏ธ **Infrastructure** | 52 | Azure Advisor, Azure AKS Edge Essentials, Azure API Management, Azure Arc, Azure Architecture, Azure Container Storage, Azure Elastic SAN |
  159. | ๐Ÿ’ฐ **Management** | 39 | Azure Advisor, Azure API Management, Azure Architecture, Azure Artifacts, Azure Automation |
  160. | ๐ŸŽฎ **Specialized** | 26 | Azure AKS Edge Essentials, Azure API Management, Azure App Configuration, Azure App Service, Azure Communication Services |
  161. **Total: 193 skills across 19 categories** โœ“
  162. ---
  163. ## ๐ŸŽ Curated Collections (Bundles)
  164. Not sure where to start? We've created role-based skill bundles to help you get productive quickly.
  165. ๐Ÿ‘‰ **[View Curated Bundles (docs/BUNDLES.md)](docs/BUNDLES.md)**
  166. | Bundle | Description |
  167. |--------|-------------|
  168. | **๐Ÿš€ Quick Start** | Absolute essentials for any Azure developer โ€” master these 7 core services first |
  169. | **โญ Popular** | Popular Azure services. The services that power most workloads |
  170. | **๐ŸŽฏ Core** | Core Azure essentials. The foundation every developer needs before specializing |
  171. | **๐Ÿค– AI/ML Developer** | For AI engineers and ML practitioners. Covers AI services, machine learning, and intelligent applications |
  172. | **๐Ÿ“Š Data Engineer** | For data engineers and analytics professionals. Covers data integration, warehousing, and streaming analytics |
  173. | **๐Ÿ—๏ธ Infrastructure Pro** | For infrastructure engineers and cloud architects. Covers networking, backup, recovery, and resource management |
  174. | **๐Ÿ”’ Security & Compliance** | Secure Azure workloads with RBAC, policy, key management, and compliance |
  175. | **๐ŸŒ DevOps & Automation** | Automate deployments, monitoring, and infrastructure management |
  176. | **๐Ÿ”— Integration** | Connect Azure services with API Management, Event Grid, Logic Apps, and Service Bus |
  177. | **โ˜๏ธ Full-Stack Azure** | Complete coverage with architecture foundations |
  178. > ๐Ÿ’ก **Recommended Path:**
  179. > 1. Start with **Quick Start Bundle**
  180. > 2. Add **Popular Bundle** for broader coverage
  181. > 3. Choose specialized bundles based on your role
  182. ---
  183. ## ๐Ÿ“š Browse All Skills
  184. We've moved the complete skill registry to a dedicated catalog to keep this README clean.
  185. ๐Ÿ‘‰ **[View the Complete Skill Catalog (docs/CATALOG.md)](docs/CATALOG.md)**
  186. | Skill | Description |
  187. |-------|-------------|
  188. | **All Azure Skills** | Full list of all available Azure skills |
  189. | **Skill Descriptions** | Skill descriptions and capabilities |
  190. | **Skill Files** | Links to individual skill files |
  191. ### ๐Ÿ“‚ Repository Structure
  192. | Path | Purpose |
  193. |-----------|---------|
  194. | `skills/` | Production-ready skills for AI agents to consume |
  195. | `plugin.json` | Agent plugin manifest โ€” one-click install in VS Code & GitHub Copilot CLI |
  196. | `.github/plugin/marketplace.json` | Plugin marketplace catalog for VS Code (`chat.plugins.marketplaces`) |
  197. | `.claude-plugin/` | Claude Code plugin + marketplace manifests (`/plugin marketplace add`) |
  198. | `.codex-plugin/plugin.json` | OpenAI Codex plugin manifest |
  199. | `.agents/plugins/marketplace.json` | OpenAI Codex marketplace catalog (`codex plugin marketplace add`) |
  200. | `products/` | Scan results, raw data, and reporting artifacts |
  201. #### About the `products/` Directory
  202. The `products/` folder stores **scan pipeline outputs** and is used for:
  203. - **Raw Data**: Results from the latest documentation scan, including extracted nodes and metadata
  204. - **Classification Reports**: Detailed records of why each node was classified as a skill (or excluded)
  205. - **Incremental Tracking**: Historical scan data to support delta processing and change detection
  206. > โš ๏ธ **Note:** The `products/` directory is for internal pipeline use and contributor reference. End users only need the `skills/` directory.
  207. ---
  208. ## ๐Ÿ› ๏ธ Installation
  209. Choose the installation path based on your preferred AI coding assistant.
  210. ### โšก Option A: Install as an Agent Plugin (Recommended)
  211. The fastest, zero-maintenance path โ€” install once and get all skills, with built-in updates. Works in **VS Code**, **Claude Code**, and **OpenAI Codex**. See [โšก One-Click Plugin Install](#-one-click-plugin-install) for full details.
  212. - **VS Code (from source):** Command Palette โ†’ **Chat: Install Plugin From Source** โ†’ paste `https://github.com/MicrosoftDocs/agent-skills`.
  213. - **VS Code (marketplace):** add `"MicrosoftDocs/agent-skills"` to `chat.plugins.marketplaces`, then install **azure-agent-skills** from the Extensions view (`@agentPlugins`).
  214. - **Claude Code:** `/plugin marketplace add MicrosoftDocs/agent-skills`, then `/plugin install azure-agent-skills@microsoft-agent-skills`.
  215. - **OpenAI Codex:** `codex plugin marketplace add MicrosoftDocs/agent-skills`, then install **azure-agent-skills** from `/plugins`.
  216. > โš ๏ธ In VS Code, this requires the agent plugins preview (`chat.plugins.enabled` set to `true`). If unavailable, use Option B below.
  217. ---
  218. ### ๐Ÿ“‹ Option B: Manual Install (All Assistants)
  219. > โš ๏ธ **Note:** This repository contains skills in the `skills/` subdirectory. Clone the repo first, then copy the skills to your target location.
  220. #### Step 1: Clone the Repository
  221. First, clone this repository to a location on your machine (e.g., your home folder or a temp directory):
  222. ```bash
  223. git clone https://github.com/MicrosoftDocs/agent-skills.git
  224. ```
  225. #### Step 2: Copy Skills to Your Destination
  226. Copy the **contents** inside the `skills/` folder to your target location based on your AI assistant:
  227. | AI Assistant | Project-level (in your repo) | Personal/Global (all projects) |
  228. |--------------|------------------------------|--------------------------------|
  229. | **GitHub Copilot** | `{your-project}/.github/skills/` | `~/.copilot/skills/` |
  230. | **Claude Code** | `{your-project}/.claude/skills/` | `~/.claude/skills/` |
  231. | **OpenAI Codex** | `{your-project}/.codex/skills/` | `~/.codex/skills/` |
  232. | **Cursor** | `{your-project}/.cursor/skills/` | โ€” |
  233. | **Gemini CLI** | `{your-project}/.gemini/skills/` | โ€” |
  234. | **Antigravity IDE** | `{your-project}/.agent/skills/` | `~/.gemini/antigravity/skills/` |
  235. | **OpenCode** | `{your-project}/.agent/skills/` | `~/.agent/skills/` |
  236. | **AdaL CLI** | `{your-project}/.adal/skills/` | `~/.adal/skills/` |
  237. > โš ๏ธ **Important:** Copy the folders **inside** `skills/` (e.g., `azure-functions/`, `azure-container-apps/`), NOT the `skills` folder itself.
  238. >
  239. > โœ… Correct: `.copilot/skills/azure-functions/SKILL.md`
  240. > โŒ Wrong: `.copilot/skills/skills/azure-functions/SKILL.md`
  241. > ๐Ÿ’ก **Path Note:** `~` = Home directory
  242. > - **Windows:** `C:\Users\yourname` (use `$HOME` in PowerShell)
  243. > - **macOS/Linux:** `/Users/yourname` or `/home/yourname`
  244. **Enable Agent Skills in VS Code** (Required for the manual install above):
  245. > ๐Ÿ’ก Using the [agent plugin](#-one-click-plugin-install) (Option A)? You can skip this โ€” the plugin loads its skills automatically once `chat.plugins.enabled` is on.
  246. Agent Skills is currently an **experimental feature**. For the manual copy method, you must enable it manually:
  247. 1. Open VS Code Settings (`Ctrl`+`,` on Windows/Linux, `Cmd`+`,` on macOS)
  248. 2. Search for `chat.agent.skills`
  249. 3. Check the box for **"Chat: Use Agent Skills"**
  250. ![vs-code-use-agent-skills](docs/vs-code-use-agent-skills.png)
  251. > โš ๏ธ **Important:** Without this setting enabled, VS Code will not load or use any skills!
  252. ---
  253. #### Step 3: Cleanup (Optional)
  254. After copying, you can delete the cloned `agent-skills` repository if you no longer need it.
  255. ---
  256. ## ๐Ÿง  How to Use
  257. ### Prerequisites
  258. Most skills require **network access** to fetch the latest documentation from Microsoft Learn.
  259. **Option 1: Microsoft Learn MCP Server (Recommended)**
  260. - Uses `mcp_microsoftdocs:microsoft_docs_fetch` to fetch complete documentation
  261. **Option 2: Web Fetch Tool**
  262. - Uses `fetch_webpage` to retrieve content from documentation URLs
  263. ### Example Workflow
  264. 1. **Ask about an Azure service:**
  265. ```
  266. How do I implement blue-green deployments in Azure Container Apps?
  267. ```
  268. 2. **The skill provides:**
  269. - Direct links to official Microsoft documentation
  270. - Best practices from Microsoft Learn
  271. - Architecture patterns and code examples
  272. 3. **AI fetches documentation:**
  273. - The AI assistant uses MCP tools to fetch the latest content
  274. - You get accurate, up-to-date guidance
  275. ---
  276. ## ๐Ÿ“– Agent Skills Documentation
  277. Agent Skills is an **open standard** for giving AI agents new capabilities. Learn more about how each platform implements skills:
  278. ### Official Documentation
  279. | Platform | Documentation | Description |
  280. |----------|---------------|-------------|
  281. | **Agent Skills Standard** | [agentskills.io](https://agentskills.io/) | The open specification for `SKILL.md` format |
  282. | **GitHub Copilot** | [About Agent Skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) | Skills for Copilot coding agent, CLI, and VS Code |
  283. | **VS Code Copilot** | [Agent Skills in VS Code](https://code.visualstudio.com/docs/copilot/customization/agent-skills) | Using skills in VS Code with agent mode |
  284. | **Claude Code** | [Agent Skills Overview](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) | Skills in Claude Code and Claude API |
  285. | **OpenAI Codex** | [Agent Skills](https://developers.openai.com/codex/skills/) | Skills for Codex CLI and IDE extensions |
  286. ### Example Skill Repositories
  287. | Repository | Description |
  288. |------------|-------------|
  289. | [anthropics/skills](https://github.com/anthropics/skills) | Official Anthropic skills (DOCX, PDF, PPTX, XLSX) |
  290. | [openai/skills](https://github.com/openai/skills) | OpenAI Codex skills catalog |
  291. | [github/awesome-copilot](https://github.com/github/awesome-copilot) | Community collection for GitHub Copilot |
  292. ### Skill Structure
  293. Every skill requires a `SKILL.md` file with YAML frontmatter:
  294. ```yaml
  295. ---
  296. name: your-skill-name # Lowercase, hyphens only, max 64 chars
  297. description: What it does # When to use it, max 1024 chars
  298. ---
  299. # Your Skill Name
  300. ## Instructions
  301. [Clear, step-by-step guidance for the AI agent]
  302. ## Examples
  303. [Concrete examples of using this skill]
  304. ```
  305. ---
  306. ## ๐Ÿค How to Contribute
  307. Thanks for your interest in contributing. Due to limited maintainer capacity right now, we do **not** accept contributions that manually create or edit any skills. Please update the relevant Microsoft Learn documentation, then create an issue to request a re-crawl, or wait for our automatic weekly crawl. We appreciate your understanding, and things may change in the future.
  308. ---
  309. ## โš–๏ธ License
  310. This project uses a dual license:
  311. - **Documentation content**: [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode) - See [LICENSE](LICENSE)
  312. - **Code**: [MIT License](https://opensource.org/licenses/MIT) - See [LICENSE-CODE](LICENSE-CODE)
  313. ---
  314. ## ๐Ÿ“š Additional Resources
  315. - [Agent Skills Specification](https://agentskills.io/specification) - The complete format specification
  316. - [Microsoft Learn Documentation](https://learn.microsoft.com/)
  317. - [Azure Architecture Center](https://learn.microsoft.com/azure/architecture/)
  318. - [Azure Well-Architected Framework](https://learn.microsoft.com/azure/well-architected/)
  319. ---
  320. ## ๐Ÿท๏ธ Topics
  321. `azure` `azure-functions` `azure-container-apps` `agent-skills` `agent-plugin` `vscode` `ai-coding` `github-copilot` `claude-code` `cursor` `openai-codex` `agentic-skills` `llm-tools` `microsoft-learn` `SKILL.md`
  322. ---
  323. # Legal Notices
  324. Microsoft and any contributors grant you a license to the Microsoft documentation and other content
  325. in this repository under the [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode),
  326. see the [LICENSE](LICENSE) file, and grant you a license to any code in the repository under the [MIT License](https://opensource.org/licenses/MIT), see the
  327. [LICENSE-CODE](LICENSE-CODE) file.
  328. Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation
  329. may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.
  330. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.
  331. You can find Microsoft general trademark guidelines at [Microsoft Trademark and Brand Guidelines](https://www.microsoft.com/legal/intellectualproperty/trademarks).
  332. For privacy information, see [privacy at Microsoft](https://privacy.microsoft.com/).
  333. Microsoft and any contributors reserve all other rights, whether under their respective copyrights, patents,
  334. or trademarks, whether by implication, estoppel or otherwise.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If itโ€™s helped, pass it on.