{"id":51197053,"url":"https://github.com/MicrosoftDocs/Agent-Skills","last_synced_at":"2026-06-28T07:00:57.919Z","repository":{"id":344963646,"uuid":"1142983380","full_name":"MicrosoftDocs/Agent-Skills","owner":"MicrosoftDocs","description":"Curated Agent Skills for Microsoft \u0026 Azure – giving AI coding assistants structured, real-time expertise from Microsoft Learn docs.","archived":false,"fork":false,"pushed_at":"2026-06-22T04:59:18.000Z","size":54028,"stargazers_count":617,"open_issues_count":3,"forks_count":74,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-06-25T19:32:33.057Z","etag":null,"topics":["agent","agent-skills","agentic-skills","agentskill","ai","ai-agents","ai-coding","azure","azure-functions","azure-kubernetes-service","azure-openai","azure-sql-database","azure-storage","azure-virtual-machine","claude-code","github-copilot","microsoft-learn","openai-codex","skills"],"latest_commit_sha":null,"homepage":"https://learn.microsoft.com/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MicrosoftDocs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-27T03:52:27.000Z","updated_at":"2026-06-23T15:39:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/MicrosoftDocs/Agent-Skills","commit_stats":null,"previous_names":["microsoftdocs/agent-skills"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MicrosoftDocs/Agent-Skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftDocs%2FAgent-Skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftDocs%2FAgent-Skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftDocs%2FAgent-Skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftDocs%2FAgent-Skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MicrosoftDocs","download_url":"https://codeload.github.com/MicrosoftDocs/Agent-Skills/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MicrosoftDocs%2FAgent-Skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34880189,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","agent-skills","agentic-skills","agentskill","ai","ai-agents","ai-coding","azure","azure-functions","azure-kubernetes-service","azure-openai","azure-sql-database","azure-storage","azure-virtual-machine","claude-code","github-copilot","microsoft-learn","openai-codex","skills"],"created_at":"2026-06-27T21:31:06.295Z","updated_at":"2026-06-28T07:00:57.902Z","avatar_url":"https://github.com/MicrosoftDocs.png","language":null,"funding_links":[],"categories":["Official Skills","🧠 Agent Skills"],"sub_categories":[],"readme":"\n# ☁️ Azure Agent Skills\n\n\u003e 🚀 **Agentic Skills for Azure Development**\n\u003e\n\u003e Supercharge your AI coding assistant with curated, production-ready skills for Microsoft Azure. Works seamlessly with:\n\u003e\n\u003e 🟣 **Claude Code** | 🔵 **Gemini CLI** | 🟢 **Codex CLI** | 🔴 **Antigravity IDE** | 🩵 **GitHub Copilot** | 🟠 **Cursor** | ⚪ **OpenCode** | 🌸 **AdaL CLI**\n\n---\n\n\n[![License: CC BY 4.0](https://img.shields.io/badge/License-CC%20BY%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n[![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Open%20Standard-green)](https://agentskills.io/)\n[![Copilot](https://img.shields.io/badge/GitHub%20Copilot-VSCode-lightblue)](https://github.com/features/copilot)\n\n[![Claude Code](https://img.shields.io/badge/Claude%20Code-Anthropic-purple)](https://claude.ai)\n[![Gemini CLI](https://img.shields.io/badge/Gemini%20CLI-Google-blue)](https://github.com/google-gemini/gemini-cli)\n[![Codex CLI](https://img.shields.io/badge/Codex%20CLI-OpenAI-green)](https://github.com/openai/codex)\n[![Cursor](https://img.shields.io/badge/Cursor-AI%20IDE-orange)](https://cursor.sh)\n[![OpenCode](https://img.shields.io/badge/OpenCode-CLI-gray)](https://github.com/opencode-ai/opencode)\n[![Antigravity](https://img.shields.io/badge/Antigravity-DeepMind-red)](https://github.com/sickn33/antigravity-awesome-skills)\n[![AdaL CLI](https://img.shields.io/badge/AdaL%20CLI-SylphAI-pink)](https://sylph.ai/)\n\nAzure 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.\n\n---\n\n## 📍 Table of Contents\n\n- [🚀 New Here? Start Here!](#-new-here-start-here)\n- [⚡ One-Click Plugin Install](#-one-click-plugin-install)\n- [🔌 Compatibility \u0026 Invocation](#-compatibility--invocation)\n- [📦 Features \u0026 Categories](#-features--categories)\n- [🎁 Curated Collections (Bundles)](#-curated-collections-bundles)\n- [📚 Browse All Skills](#-browse-all-skills)\n- [🛠️ Installation](#️-installation)\n- [🧠 How to Use](#-how-to-use)\n- [📖 Agent Skills Documentation](#-agent-skills-documentation)\n- [🤝 How to Contribute](#-how-to-contribute)\n- [⚖️ License](#️-license)\n\n---\n\n## 🚀 New Here? Start Here!\n\n### 1. 🐣 What is this?\n\nAI 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.\n\n\u003e 💡 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.\n\n### 2. 📚 How These Skills Are Created\n\nMicrosoft 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**.\n\n**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:\n\n- API patterns and usage guidance\n- Service configuration procedures  \n- Platform best practices and constraints\n- Troubleshooting decision trees\n- Security and compliance requirements\n\n**Our approach:**\n\n1. **Extract** high-value, task-oriented capabilities from Learn content\n2. **Classify** by purpose (limits, troubleshooting, configuration, architecture, etc.)\n3. **Reveal** only when relevant to the user's intent\n\nThe knowledge is **pre-compiled into actions, choices, and guardrails** the agent can use directly — not raw text that needs interpretation.\n\nEach skill provides:\n- 📚 Curated documentation links organized by topic\n- 🔗 Direct access to Microsoft Learn content\n- 🎯 Best practices and architecture patterns\n- ⚠️ Troubleshooting guides and common pitfalls\n\n### 3. ⚡️ Quick Start\n\nA short path to getting started — full installation details are in the [🛠️ Installation](#️-installation) section below.\n\n**� Plugin install (recommended):** VS Code, Claude Code, and Codex can install everything as a single agent plugin — no cloning or copying.\n\n- **VS Code:** Command Palette → **Chat: Install Plugin From Source** → paste `https://github.com/MicrosoftDocs/agent-skills`\n- **Claude Code:** `/plugin marketplace add MicrosoftDocs/agent-skills`, then `/plugin install azure-agent-skills@microsoft-agent-skills`\n- **Codex:** `codex plugin marketplace add MicrosoftDocs/agent-skills`, then install **azure-agent-skills** from `/plugins`\n\n\u003e 👉 See [⚡ One-Click Plugin Install](#-one-click-plugin-install) for full steps and the marketplace options.\n\n**🛠️ Other assistants (manual):**\n\n1. Clone the repo:\n   ```bash\n   git clone https://github.com/MicrosoftDocs/agent-skills.git\n   ```\n\n2. Copy the contents of the `skills/` folder to your AI assistant's skills path (see [🛠️ Installation](#️-installation) for the destination table and important notes).\n\n3. VS Code users (manual mode): enable `chat.agent.skills` in Settings so the editor will load skills.\n\n4. Start coding — your AI assistant will automatically discover and use the installed skills.\n\n### 4. 🧠 How Skills Work\n\nSkills use **progressive disclosure** to efficiently load content only when needed:\n\n1. **Level 1 - Discovery**: Agent reads skill `name` and `description` from YAML frontmatter\n2. **Level 2 - Instructions**: When triggered, agent loads the full `SKILL.md` content\n3. **Level 3 - Resources**: Agent accesses additional files (scripts, examples) as needed\n\nOnce installed, just ask your AI assistant naturally:\n\n\u003e \"Help me set up Azure Functions with Durable Functions\"\n\u003e \n\u003e \"What are the best practices for Azure Container Apps?\"\n\u003e \n\u003e \"How do I configure Azure API Management?\"\n\nThe skills will automatically provide context from official Microsoft documentation.\n\n---\n\n## ⚡ One-Click Plugin Install\n\n\u003e 🚀 **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.\n\n### 🟦 VS Code\n\n**Option 1 — Install directly from source**\n\n1. Open the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`).\n2. Run **Chat: Install Plugin From Source**.\n3. Paste the repository URL:\n   ```\n   https://github.com/MicrosoftDocs/agent-skills\n   ```\n4. VS Code clones and installs the plugin. All skills now appear in **Chat: Configure Skills**.\n\n**Option 2 — Add it as a plugin marketplace**\n\nRegister this repo as a marketplace to browse and install (and get updates) from the Extensions view.\n\n1. Add the repository to your `chat.plugins.marketplaces` setting:\n   ```jsonc\n   // settings.json\n   \"chat.plugins.marketplaces\": [\n     \"MicrosoftDocs/agent-skills\"\n   ]\n   ```\n2. Open the **Extensions** view (`Ctrl+Shift+X`) and search `@agentPlugins`.\n3. Find **azure-agent-skills** and select **Install**.\n\n\u003e ⚠️ **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.\n\n### 🟣 Claude Code\n\nClaude Code installs this repo as a plugin through its marketplace. From within Claude Code:\n\n1. Add this repository as a marketplace:\n   ```\n   /plugin marketplace add MicrosoftDocs/agent-skills\n   ```\n2. Install the plugin:\n   ```\n   /plugin install azure-agent-skills@microsoft-agent-skills\n   ```\n3. Run `/reload-plugins` (or restart Claude Code) to activate. All skills are now available.\n\n### 🟢 OpenAI Codex\n\nCodex installs this repo as a plugin through its plugin browser. From the Codex CLI:\n\n1. Add this repository as a marketplace:\n   ```\n   codex plugin marketplace add MicrosoftDocs/agent-skills\n   ```\n2. Open the plugin browser and install **azure-agent-skills** from the **microsoft-agent-skills** marketplace:\n   ```\n   /plugins\n   ```\n3. Restart Codex if the skills don't appear immediately.\n\n\u003e 💡 **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.\n\n---\n\n## 🔌 Compatibility \u0026 Invocation\n\n\nThese skills follow the [Agent Skills open standard](https://agentskills.io/) (`SKILL.md` format) and work with any AI coding assistant that supports agentic skills.\n\n| AI Coding Assistant      | Type           | Skills Path / Location         | How to Invoke                      |\n|-------------------------|----------------|-------------------------------|-------------------------------------|\n| **Claude Code**         | Anthropic CLI  | `.claude/skills/`              | Natural language, `/skill-name`     |\n| **Gemini CLI**          | Google DeepMind| `.gemini/skills/`              | Natural language                    |\n| **Codex CLI**           | OpenAI         | `.codex/skills/`               | Natural language                    |\n| **Antigravity IDE**     | DeepMind IDE   | `.agent/skills/`               | Agent mode, natural language        |\n| **GitHub Copilot**      | VSCode Ext     | `.github/skills/`              | Natural language, `@workspace`      |\n| **Cursor**              | AI-native IDE  | `.cursor/skills/`              | `@skill-name` in Chat               |\n| **OpenCode**            | Open-source CLI| `.agent/skills/`               | `opencode run @skill-name`          |\n| **AdaL CLI**            | SylphAI Agent  | `.adal/skills/`                | Auto-load, natural language         |\n\n\u003e 💡 **Path Note:** `~` refers to your home directory:\n\u003e - **macOS/Linux:** `~` = `/Users/yourname` or `/home/yourname`\n\u003e - **Windows:** `~` = `%USERPROFILE%` = `C:\\Users\\yourname` (use `$HOME` in PowerShell)\n\n\u003e 💡 **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).\n\n---\n\n## 📦 Features \u0026 Categories\n\nThe repository is organized by Azure service domains:\n\n| Category | Skills | Examples |\n|----------|--------|----------|\n| ☁️ **Compute** | 13 | Azure App Service, Azure Batch, Azure Cloud Services, Azure Cyclecloud, Azure Functions |\n| 🔗 **Integration** | 16 | Azure API Center, Azure API Management, Azure Business Process Tracking, Azure Communication Services, Azure Data API Builder |\n| 📊 **Data \u0026 Analytics** | 19 | Azure Analysis Services, Azure Cache Redis, Azure Cosmos Db, Azure Data Explorer, Azure Data Factory |\n| 🤖 **AI \u0026 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 |\n| 🔒 **Security \u0026 Identity** | 19 | Azure Active Directory B2C, Azure Attestation, Azure Cloud Hsm, Azure Confidential Computing, Azure Confidential Ledger |\n| 🌐 **Networking** | 23 | Azure Application Gateway, Azure Bastion, Azure DDoS Protection, Azure Dns, Azure Expressroute |\n| 🏗️ **Infrastructure** | 52 | Azure Advisor, Azure AKS Edge Essentials, Azure API Management, Azure Arc, Azure Architecture, Azure Container Storage, Azure Elastic SAN |\n| 💰 **Management** | 39 | Azure Advisor, Azure API Management, Azure Architecture, Azure Artifacts, Azure Automation |\n| 🎮 **Specialized** | 26 | Azure AKS Edge Essentials, Azure API Management, Azure App Configuration, Azure App Service, Azure Communication Services |\n\n**Total: 193 skills across 19 categories** ✓\n\n---\n\n## 🎁 Curated Collections (Bundles)\n\nNot sure where to start? We've created role-based skill bundles to help you get productive quickly.\n\n👉 **[View Curated Bundles (docs/BUNDLES.md)](docs/BUNDLES.md)**\n\n| Bundle | Description |\n|--------|-------------|\n| **🚀 Quick Start** | Absolute essentials for any Azure developer — master these 7 core services first |\n| **⭐ Popular** | Popular Azure services. The services that power most workloads |\n| **🎯 Core** | Core Azure essentials. The foundation every developer needs before specializing |\n| **🤖 AI/ML Developer** | For AI engineers and ML practitioners. Covers AI services, machine learning, and intelligent applications |\n| **📊 Data Engineer** | For data engineers and analytics professionals. Covers data integration, warehousing, and streaming analytics |\n| **🏗️ Infrastructure Pro** | For infrastructure engineers and cloud architects. Covers networking, backup, recovery, and resource management |\n| **🔒 Security \u0026 Compliance** | Secure Azure workloads with RBAC, policy, key management, and compliance |\n| **🌐 DevOps \u0026 Automation** | Automate deployments, monitoring, and infrastructure management |\n| **🔗 Integration** | Connect Azure services with API Management, Event Grid, Logic Apps, and Service Bus |\n| **☁️ Full-Stack Azure** | Complete coverage with architecture foundations |\n\n\u003e 💡 **Recommended Path:**\n\u003e 1. Start with **Quick Start Bundle**\n\u003e 2. Add **Popular Bundle** for broader coverage\n\u003e 3. Choose specialized bundles based on your role\n\n---\n\n## 📚 Browse All Skills\n\nWe've moved the complete skill registry to a dedicated catalog to keep this README clean.\n\n👉 **[View the Complete Skill Catalog (docs/CATALOG.md)](docs/CATALOG.md)**\n\n| Skill | Description |\n|-------|-------------|\n| **All Azure Skills** | Full list of all available Azure skills |\n| **Skill Descriptions** | Skill descriptions and capabilities |\n| **Skill Files** | Links to individual skill files |\n\n### 📂 Repository Structure\n\n| Path | Purpose |\n|-----------|---------|\n| `skills/` | Production-ready skills for AI agents to consume |\n| `plugin.json` | Agent plugin manifest — one-click install in VS Code \u0026 GitHub Copilot CLI |\n| `.github/plugin/marketplace.json` | Plugin marketplace catalog for VS Code (`chat.plugins.marketplaces`) |\n| `.claude-plugin/` | Claude Code plugin + marketplace manifests (`/plugin marketplace add`) |\n| `.codex-plugin/plugin.json` | OpenAI Codex plugin manifest |\n| `.agents/plugins/marketplace.json` | OpenAI Codex marketplace catalog (`codex plugin marketplace add`) |\n| `products/` | Scan results, raw data, and reporting artifacts |\n\n#### About the `products/` Directory\n\nThe `products/` folder stores **scan pipeline outputs** and is used for:\n\n- **Raw Data**: Results from the latest documentation scan, including extracted nodes and metadata\n- **Classification Reports**: Detailed records of why each node was classified as a skill (or excluded)\n- **Incremental Tracking**: Historical scan data to support delta processing and change detection\n\n\u003e ⚠️ **Note:** The `products/` directory is for internal pipeline use and contributor reference. End users only need the `skills/` directory.\n\n---\n\n## 🛠️ Installation\n\nChoose the installation path based on your preferred AI coding assistant.\n\n### ⚡ Option A: Install as an Agent Plugin (Recommended)\n\nThe 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.\n\n- **VS Code (from source):** Command Palette → **Chat: Install Plugin From Source** → paste `https://github.com/MicrosoftDocs/agent-skills`.\n- **VS Code (marketplace):** add `\"MicrosoftDocs/agent-skills\"` to `chat.plugins.marketplaces`, then install **azure-agent-skills** from the Extensions view (`@agentPlugins`).\n- **Claude Code:** `/plugin marketplace add MicrosoftDocs/agent-skills`, then `/plugin install azure-agent-skills@microsoft-agent-skills`.\n- **OpenAI Codex:** `codex plugin marketplace add MicrosoftDocs/agent-skills`, then install **azure-agent-skills** from `/plugins`.\n\n\u003e ⚠️ In VS Code, this requires the agent plugins preview (`chat.plugins.enabled` set to `true`). If unavailable, use Option B below.\n\n---\n\n### 📋 Option B: Manual Install (All Assistants)\n\n\u003e ⚠️ **Note:** This repository contains skills in the `skills/` subdirectory. Clone the repo first, then copy the skills to your target location.\n\n#### Step 1: Clone the Repository\n\nFirst, clone this repository to a location on your machine (e.g., your home folder or a temp directory):\n\n```bash\ngit clone https://github.com/MicrosoftDocs/agent-skills.git\n```\n\n#### Step 2: Copy Skills to Your Destination\n\nCopy the **contents** inside the `skills/` folder to your target location based on your AI assistant:\n\n| AI Assistant | Project-level (in your repo) | Personal/Global (all projects) |\n|--------------|------------------------------|--------------------------------|\n| **GitHub Copilot** | `{your-project}/.github/skills/` | `~/.copilot/skills/` |\n| **Claude Code** | `{your-project}/.claude/skills/` | `~/.claude/skills/` |\n| **OpenAI Codex** | `{your-project}/.codex/skills/` | `~/.codex/skills/` |\n| **Cursor** | `{your-project}/.cursor/skills/` | — |\n| **Gemini CLI** | `{your-project}/.gemini/skills/` | — |\n| **Antigravity IDE** | `{your-project}/.agent/skills/` | `~/.gemini/antigravity/skills/` |\n| **OpenCode** | `{your-project}/.agent/skills/` | `~/.agent/skills/` |\n| **AdaL CLI** | `{your-project}/.adal/skills/` | `~/.adal/skills/` |\n\n\u003e ⚠️ **Important:** Copy the folders **inside** `skills/` (e.g., `azure-functions/`, `azure-container-apps/`), NOT the `skills` folder itself.\n\u003e\n\u003e ✅ Correct: `.copilot/skills/azure-functions/SKILL.md`  \n\u003e ❌ Wrong: `.copilot/skills/skills/azure-functions/SKILL.md`\n\n\u003e 💡 **Path Note:** `~` = Home directory\n\u003e - **Windows:** `C:\\Users\\yourname` (use `$HOME` in PowerShell)\n\u003e - **macOS/Linux:** `/Users/yourname` or `/home/yourname`\n\n**Enable Agent Skills in VS Code** (Required for the manual install above):\n\n\u003e 💡 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.\n\nAgent Skills is currently an **experimental feature**. For the manual copy method, you must enable it manually:\n\n1. Open VS Code Settings (`Ctrl`+`,` on Windows/Linux, `Cmd`+`,` on macOS)\n2. Search for `chat.agent.skills`\n3. Check the box for **\"Chat: Use Agent Skills\"**\n   ![vs-code-use-agent-skills](docs/vs-code-use-agent-skills.png)\n\n\u003e ⚠️ **Important:** Without this setting enabled, VS Code will not load or use any skills!\n\n---\n\n#### Step 3: Cleanup (Optional)\n\nAfter copying, you can delete the cloned `agent-skills` repository if you no longer need it.\n\n---\n\n## 🧠 How to Use\n\n### Prerequisites\n\nMost skills require **network access** to fetch the latest documentation from Microsoft Learn.\n\n**Option 1: Microsoft Learn MCP Server (Recommended)**\n- Uses `mcp_microsoftdocs:microsoft_docs_fetch` to fetch complete documentation\n\n**Option 2: Web Fetch Tool**\n- Uses `fetch_webpage` to retrieve content from documentation URLs\n\n### Example Workflow\n\n1. **Ask about an Azure service:**\n   ```\n   How do I implement blue-green deployments in Azure Container Apps?\n   ```\n\n2. **The skill provides:**\n   - Direct links to official Microsoft documentation\n   - Best practices from Microsoft Learn\n   - Architecture patterns and code examples\n\n3. **AI fetches documentation:**\n   - The AI assistant uses MCP tools to fetch the latest content\n   - You get accurate, up-to-date guidance\n\n---\n\n## 📖 Agent Skills Documentation\n\nAgent Skills is an **open standard** for giving AI agents new capabilities. Learn more about how each platform implements skills:\n\n### Official Documentation\n\n| Platform | Documentation | Description |\n|----------|---------------|-------------|\n| **Agent Skills Standard** | [agentskills.io](https://agentskills.io/) | The open specification for `SKILL.md` format |\n| **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 |\n| **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 |\n| **Claude Code** | [Agent Skills Overview](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) | Skills in Claude Code and Claude API |\n| **OpenAI Codex** | [Agent Skills](https://developers.openai.com/codex/skills/) | Skills for Codex CLI and IDE extensions |\n\n### Example Skill Repositories\n\n| Repository | Description |\n|------------|-------------|\n| [anthropics/skills](https://github.com/anthropics/skills) | Official Anthropic skills (DOCX, PDF, PPTX, XLSX) |\n| [openai/skills](https://github.com/openai/skills) | OpenAI Codex skills catalog |\n| [github/awesome-copilot](https://github.com/github/awesome-copilot) | Community collection for GitHub Copilot |\n\n### Skill Structure\n\nEvery skill requires a `SKILL.md` file with YAML frontmatter:\n\n```yaml\n---\nname: your-skill-name        # Lowercase, hyphens only, max 64 chars\ndescription: What it does    # When to use it, max 1024 chars\n---\n\n# Your Skill Name\n\n## Instructions\n[Clear, step-by-step guidance for the AI agent]\n\n## Examples\n[Concrete examples of using this skill]\n```\n\n---\n\n## 🤝 How to Contribute\n\nThanks 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.\n\n---\n\n## ⚖️ License\n\nThis project uses a dual license:\n\n- **Documentation content**: [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode) - See [LICENSE](LICENSE)\n- **Code**: [MIT License](https://opensource.org/licenses/MIT) - See [LICENSE-CODE](LICENSE-CODE)\n\n---\n\n## 📚 Additional Resources\n\n- [Agent Skills Specification](https://agentskills.io/specification) - The complete format specification\n- [Microsoft Learn Documentation](https://learn.microsoft.com/)\n- [Azure Architecture Center](https://learn.microsoft.com/azure/architecture/)\n- [Azure Well-Architected Framework](https://learn.microsoft.com/azure/well-architected/)\n\n---\n\n## 🏷️ Topics\n\n`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`\n\n---\n \n\n# Legal Notices\n\nMicrosoft and any contributors grant you a license to the Microsoft documentation and other content\nin this repository under the [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode),\nsee 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\n[LICENSE-CODE](LICENSE-CODE) file.\n\nMicrosoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation\nmay be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.\nThe licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.\nYou can find Microsoft general trademark guidelines at [Microsoft Trademark and Brand Guidelines](https://www.microsoft.com/legal/intellectualproperty/trademarks).\n\nFor privacy information, see [privacy at Microsoft](https://privacy.microsoft.com/).\n\nMicrosoft and any contributors reserve all other rights, whether under their respective copyrights, patents,\nor trademarks, whether by implication, estoppel or otherwise.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMicrosoftDocs%2FAgent-Skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMicrosoftDocs%2FAgent-Skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMicrosoftDocs%2FAgent-Skills/lists"}